List all coins tracked by CoinGecko, with optional platform/contract address data, via pay-per-call MPP.
What it does
This endpoint returns the full list of coins available on CoinGecko, including coin IDs, names, and symbols. Optionally, you can request platform contract addresses and filter by active/inactive status. It is one of 15 endpoints in the CoinGecko via Locus MPP service, which wraps CoinGecko's cryptocurrency market data API behind the MPP (Micropayment Protocol) pay-per-call model.
Each call costs 60,000 base units of pathUSD (currency 0x20c000000000000000000000b9537d11c60e8b50) on Tempo L2, which equals $0.06 per request assuming 6 decimals. The endpoint accepts POST requests with an optional JSON body containing `include_platform` (boolean) and `status` (string: "active" or "inactive"). The coins list is commonly used as a reference lookup to resolve human-readable coin names to CoinGecko IDs before calling other endpoints like simple-price or market-chart.
The broader service also exposes endpoints for simple prices, token prices by contract, market charts, coin history, trending coins, exchange rates, global stats, DeFi stats, categories, top gainers/losers, exchanges, search, and more — all at the same $0.06/call price point. Note: the probe returned 404 on HEAD and GET methods; the endpoint is POST-only per the OpenAPI spec, so this does not indicate the endpoint is down.
Capabilities
Use cases
- —Resolve coin names/symbols to CoinGecko IDs for downstream API calls
- —Build a searchable directory of all tracked cryptocurrencies
- —Retrieve contract addresses for tokens across multiple blockchain platforms
- —Filter active vs inactive coins for portfolio tracking applications
- —Seed a local database with the full CoinGecko coin catalog
Fit
Best for
- —Agents that need to enumerate or look up CoinGecko coin IDs programmatically
- —Applications requiring contract address mappings across chains
- —Developers who want pay-per-call CoinGecko access without managing API keys
Not for
- —Real-time price streaming or websocket-based market data
- —Users who need free unlimited access — each call costs $0.06
- —Non-crypto data needs
Quick start
curl -X POST https://coingecko.mpp.paywithlocus.com/coingecko/coins-list \
-H "Content-Type: application/json" \
-d '{"include_platform": true, "status": "active"}'Example
Request
{
"status": "active",
"include_platform": true
}Response
[
{
"id": "bitcoin",
"name": "Bitcoin",
"symbol": "btc",
"platforms": {}
},
{
"id": "ethereum",
"name": "Ethereum",
"symbol": "eth",
"platforms": {}
},
{
"id": "tether",
"name": "Tether",
"symbol": "usdt",
"platforms": {
"ethereum": "0xdac17f958d2ee523a2206206994597c13d831ec7"
}
}
]Endpoint
Quality
Full OpenAPI schema is available with clear request body definitions and payment info for all 15 endpoints. However, the probe did not capture a live 402 challenge (POST was not attempted; HEAD/GET returned 404 as expected for a POST-only endpoint), response schemas are not documented, and no crawled docs beyond the OpenAPI spec were available. The example response is inferred from CoinGecko's public API documentation, not directly observed.
Warnings
- —Probe returned 404 on HEAD/GET — endpoint is POST-only; liveness via 402 challenge was not confirmed by the probe
- —Response schema is not documented in the OpenAPI spec; response format is inferred from upstream CoinGecko API
- —Price assumes pathUSD uses 6 decimals; the currency address is not independently verified
- —No crawled documentation was available from the provider beyond the OpenAPI spec
Citations
- —The endpoint is POST-only and part of a 15-endpoint CoinGecko service with OpenAPI 3.1.0 spechttps://coingecko.mpp.paywithlocus.com
- —Each call costs 60,000 base units of pathUSD on Tempo L2 (intent: charge, method: tempo)https://coingecko.mpp.paywithlocus.com
- —CoinGecko API reference documentation is available at docs.coingecko.comhttps://docs.coingecko.com
- —LLM-specific docs referenced at beta.paywithlocus.com/mpp/coingecko.mdhttps://beta.paywithlocus.com/mpp/coingecko.md