Pay-per-call top gainers and losers in crypto markets via CoinGecko data over MPP.
What it does
This endpoint returns the top gaining and losing cryptocurrencies over configurable time periods, sourced from CoinGecko market data and served through the Locus MPP (Micropayment Protocol). It accepts a POST request with a required `vs_currency` parameter and optional `duration` (1h, 24h, 7d, 14d, 30d, 60d, 1y) and `top_coins` filter (e.g. top 300, 500, or 1000 coins). Payment is settled per-call via the Tempo method on pathUSD at $0.06 per request.
This endpoint is part of a broader CoinGecko proxy suite hosted at coingecko.mpp.paywithlocus.com, which also exposes endpoints for simple prices, token prices by contract, coins markets, coin data, market charts, coin history, trending coins, exchange rates, global stats, global DeFi stats, categories, exchanges, search, and coins list — all at the same $0.06/call price point.
Note: The probe returned 404 on HEAD and GET requests, which is expected because this endpoint only accepts POST. The OpenAPI spec clearly defines the POST method with a full request schema and payment info, indicating the endpoint is live and functional when called correctly.
Capabilities
Use cases
- —Identify the top gaining and losing coins over the last 24 hours for a trading dashboard
- —Build automated alerts when specific coins enter the top gainers or losers list
- —Feed an AI agent with real-time market mover data for portfolio analysis
- —Generate daily or weekly crypto market summary reports highlighting biggest movers
- —Screen for momentum plays by filtering top gainers among the top 300 coins
Fit
Best for
- —AI agents needing pay-per-call crypto market mover data without API key management
- —Developers building trading dashboards that highlight top performers and underperformers
- —Automated systems that need configurable time-window gainers/losers snapshots
Not for
- —High-frequency trading requiring sub-second latency and free unlimited calls
- —Users who need historical tick-level data rather than aggregated gainers/losers
- —Applications that already have a CoinGecko Pro API key and don't need MPP settlement
Quick start
curl -X POST https://coingecko.mpp.paywithlocus.com/coingecko/top-gainers-losers \
-H "Content-Type: application/json" \
-d '{"vs_currency": "usd", "duration": "24h", "top_coins": "1000"}'Example
Request
{
"duration": "24h",
"top_coins": "1000",
"vs_currency": "usd"
}Endpoint
Quality
Full OpenAPI schema with request body definitions and payment info is available. The endpoint only accepts POST so the 404 on HEAD/GET is expected, not a sign of failure. However, no example response schema is provided, no crawl docs beyond the OpenAPI were reachable, and the actual 402 challenge was not captured because the probe only tried HEAD and GET.
Warnings
- —Probe returned 404 because it tested HEAD/GET; endpoint requires POST — likely live but not directly confirmed via 402 challenge
- —No response schema documented — response structure must be inferred from CoinGecko's own API docs
- —Currency address 0x20c000000000000000000000b9537d11c60e8b50 assumed to be pathUSD with 6 decimals; if incorrect, the $0.06 price calculation would be wrong
Citations
- —Endpoint requires POST with vs_currency (required), duration, and top_coins parametershttps://coingecko.mpp.paywithlocus.com
- —Payment amount is 60000 base units via Tempo method with currency 0x20c000000000000000000000b9537d11c60e8b50https://coingecko.mpp.paywithlocus.com
- —Part of a broader CoinGecko proxy suite with 15 endpointshttps://coingecko.mpp.paywithlocus.com
- —CoinGecko API reference available at docs.coingecko.comhttps://docs.coingecko.com
- —LLM-oriented docs available at beta.paywithlocus.com/mpp/coingecko.mdhttps://beta.paywithlocus.com/mpp/coingecko.md