Pay-per-call cryptocurrency market data from CoinGecko via MPP on Tempo L2.
What it does
This endpoint provides access to CoinGecko's Coins Markets data through the Locus MPP (Micropayment Protocol), settling payments in pathUSD on Tempo L2. The `/coingecko/coins-markets` route returns paginated market data for cryptocurrencies including current price, market cap, volume, and price change percentages in a specified target currency. You can filter by coin IDs or category, control sort order, enable 7-day sparkline data, and request price change intervals (1h, 24h, 7d). Results are paginated up to 250 per page.
This endpoint is part of a broader CoinGecko proxy service hosted by Locus that exposes 15 routes covering simple prices, token prices by contract, coin details, historical data, market charts, trending coins, exchange rates, global stats, DeFi stats, categories, top gainers/losers, exchanges, search, and coins list. All routes use POST and share the same per-call price of 60,000 base units of pathUSD (approximately $0.06 per call, assuming 6 decimals). Payment intent is "charge" (one-shot per request).
The probe did not return a 402 challenge on HEAD or GET because the endpoint only accepts POST requests. The OpenAPI spec is well-documented with request schemas and payment metadata. No response schemas are provided, so the exact shape of returned data must be inferred from CoinGecko's own API documentation.
Capabilities
Use cases
- —Fetching current market data for a portfolio of cryptocurrencies
- —Building a dashboard showing top coins by market cap with sparkline charts
- —Comparing price changes across multiple time intervals for trading signals
- —Filtering coins by category (e.g., DeFi, Layer 2) for sector analysis
- —Paginating through the full coin market to build a leaderboard
Fit
Best for
- —AI agents needing on-demand crypto market snapshots without API key management
- —Micropayment-based access to CoinGecko data without monthly subscriptions
- —Automated trading bots that need per-call pricing flexibility
- —Applications requiring sorted, filtered, paginated coin market listings
Not for
- —High-frequency trading requiring sub-second latency and websocket streams
- —Users who need free access — every call costs ~$0.06
- —Historical OHLCV candle data (use the market-chart endpoint instead)
Quick start
curl -X POST https://coingecko.mpp.paywithlocus.com/coingecko/coins-markets \
-H "Content-Type: application/json" \
-d '{"vs_currency": "usd", "per_page": 10, "page": 1, "order": "market_cap_desc"}'Example
Request
{
"ids": "bitcoin,ethereum,solana",
"page": 1,
"order": "market_cap_desc",
"per_page": 10,
"sparkline": true,
"vs_currency": "usd",
"price_change_percentage": "1h,24h,7d"
}Endpoint
Quality
The OpenAPI spec is thorough with request schemas and payment metadata for all 15 routes, but no response schemas are provided. The probe returned 404 on HEAD/GET because the endpoint only accepts POST, so liveness could not be confirmed via the standard MPP challenge. Price and currency information is present but the pathUSD token address and decimal count are inferred (6 decimals assumed).
Warnings
- —Endpoint returned 404 on HEAD and GET probes; it only accepts POST, so liveness was not directly confirmed via MPP 402 challenge
- —No response schema provided in the OpenAPI spec — response shape must be inferred from CoinGecko's own documentation
- —The pathUSD token decimals are assumed to be 6; if different, the $0.06 price estimate would be incorrect
- —No example responses available from the probe or crawl
Citations
- —The endpoint uses POST method with the documented request schema for coins-marketshttps://coingecko.mpp.paywithlocus.com
- —All routes charge 60,000 base units of pathUSD via Tempo L2 settlement with intent 'charge'https://coingecko.mpp.paywithlocus.com
- —CoinGecko API reference is available at docs.coingecko.comhttps://docs.coingecko.com
- —LLM-specific documentation is available at the Locus beta docs URLhttps://beta.paywithlocus.com/mpp/coingecko.md