{"uid":"cap_UwcXpNw4NDtpgAsfHUKQr","slug":"coingecko-top-gainers-losers-19c5d959","name":"CoinGecko Top Gainers & Losers","description":"Get top 30 coins with largest price gains and losses over a time period.","url":"https://coingecko.mpp.paywithlocus.com/coingecko/top-gainers-losers?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","required":["vs_currency"],"properties":{"duration":{"type":"string","description":"Time period: \"1h\", \"24h\", \"7d\", \"14d\", \"30d\", \"60d\", \"1y\""},"top_coins":{"type":"string","description":"Filter by top N coins (e.g. \"300\", \"500\", \"1000\")"},"vs_currency":{"type":"string","description":"Target currency (e.g. \"usd\")"}},"additionalProperties":true},"responseSchema":null,"example":{"request":{"duration":"24h","top_coins":"500","vs_currency":"usd"},"response":{"_truncated":true,"_originalSize":16109}},"exampleRequest":{"duration":"24h","top_coins":"500","vs_currency":"usd"},"tags":["crypto","prices","market-cap","exchanges","trending","data"],"displayCostAmount":"0.06","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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":"mpp","network":"tempo","amountUsd":"0.06","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.06","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_oE-xbvghsgciwZvPpc3eh","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.06","costPer":"request","priority":0,"asset":"0x20c000000000000000000000b9537d11c60e8b50","unit":"request","depositMicros":null,"planRef":null}],"brandName":"CoinGecko","brandSlug":"coingecko","brandBaseUrl":"https://www.coingecko.com","brandDocsUrl":"https://docs.coingecko.com","whatItDoes":"Returns the top gaining and losing cryptocurrencies over a specified time period, filtered by market cap tier and quoted in a target currency.","exampleAgentPrompt":"Show me the top gaining and losing coins in USD over the last 24 hours, looking only at the top 500 coins by market cap.","exampleUseCases":null,"resultDescription":"A ranked list of top-gaining and top-losing cryptocurrency coins for the specified period, including each coin's price change percentage, current price in the target currency, and market cap rank — truncated to the most notable movers within the requested top_coins universe.","failureModes":["Missing required vs_currency field returns a validation error","Invalid duration value (e.g. '48h') may return empty results or an error","top_coins value outside allowed options (300, 500, 1000) may be rejected or ignored","Rate limiting or upstream CoinGecko API unavailability returns a 5xx error","Currency code not supported by CoinGecko returns an empty or error response"],"whenToPreferThis":"Use this endpoint when you need a quick ranked view of the best and worst performing cryptocurrencies over a defined time window. Ideal for market scanning, alerting on big movers, or building a daily crypto briefing. Prefer this over Coins Markets when you specifically want performance-ranked gainers/losers rather than a full market list sorted by cap.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-10T18:40:32.407Z","isFirstParty":false,"canonicalSlug":"coingecko-top-gainers-losers-19c5d959"}