{"uid":"cap_n7gIC5XvO8kqN78ph2wSN","slug":"coingecko-top-gainers-losers-via-locus-x402-5faa846d","name":"CoinGecko Top Gainers & Losers via Locus x402","description":"Cryptocurrency market data — prices, charts, market cap, exchanges, trending coins, global stats, NFTs, derivatives, and on-chain data.","url":"https://coingecko.x402.paywithlocus.com/coingecko/top-gainers-losers","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"duration":{"type":"string"},"top_coins":{"type":"string"},"vs_currency":{"type":"string"}}},"responseSchema":{"type":"json","example":{"data":{},"payment":{"scheme":"exact","settledUsdc":"0.001000","authorizedMaxUsdc":"0.001000"},"request":{"id":"00000000-0000-4000-8000-000000000000","statusUrl":"/requests/00000000-0000-4000-8000-000000000000"},"success":true}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.06","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.06/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.06","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.06","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_UYs1k5uWviWop8k-kYFnm","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.06","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the top gaining and losing cryptocurrencies over a specified time period, filtered by market cap tier and target currency.","exampleAgentPrompt":"What are the top crypto gainers and losers over the last 24 hours among the top 500 coins, priced in USD?","exampleUseCases":[{"title":"Daily crypto market movers briefing","prompt":"Give me a rundown of the biggest crypto gainers and losers in the last 24 hours among the top 1000 coins by market cap, in USD."},{"title":"Weekly altcoin performance screening","prompt":"Which coins in the top 500 had the biggest gains or losses over the past 7 days? Show me in USD so I can decide where to rebalance."},{"title":"Hourly momentum trading signal","prompt":"What are the top gaining and losing cryptocurrencies in the last hour among the top 300 coins? I want to catch short-term momentum moves priced in USD."}],"resultDescription":"A JSON object containing lists of top gaining and top losing coins for the specified time period, including coin identifiers, price change percentages, and market data, along with payment settlement details and request tracking information.","failureModes":["Invalid duration value returns an error — must be one of: 1h, 24h, 7d, 14d, 30d, 60d, 1y","Invalid top_coins value returns an error — must be a supported tier like 300, 500, or 1000","Unsupported vs_currency causes a failed response","Payment failure via x402 protocol results in a 402 response and no data returned","CoinGecko upstream downtime or rate limiting may cause delayed or empty responses"],"whenToPreferThis":"Use this endpoint when you need a ranked list of top gaining or losing coins across a defined time window and market cap tier. It is ideal for momentum screening, daily briefings, or identifying market leaders and laggards. Prefer this over general price endpoints when the goal is comparative performance ranking rather than looking up a specific coin's price.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:34:16.238Z","isFirstParty":false}