{"uid":"cap_pXRo9MiiAdYqphpQQQPi3","slug":"coingecko-markets-paginated-crypto-market-data-b544f041","name":"CoinGecko Markets – Paginated Crypto Market Data","description":"Top crypto coins ranked by market cap — paginated market data (price, market-cap rank, symbol) in any currency, CoinGecko-sourced.","url":"https://coingecko.use.x402atlas.com/markets","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","properties":{"page":{"type":"integer","default":1,"maximum":1000,"minimum":1,"description":"Page number, 1-1000 (default: 1)"},"per_page":{"type":"integer","default":50,"maximum":250,"minimum":1,"description":"Rows per page, 1-250 (default: 50)"},"vs_currency":{"type":"string","default":"usd","description":"Target currency code (default: usd)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["queried_at","vs_currency","page","per_page","markets"],"properties":{"page":{"type":"integer","description":"Page number returned"},"markets":{"type":"array","items":{"type":"object","required":["id","symbol","name"],"properties":{"id":{"type":"string","description":"CoinGecko coin id slug"},"ath":{"type":"number","description":"All-time high price"},"name":{"type":"string","description":"Coin name"},"image":{"type":"string","description":"URL of the coin's logo image"},"symbol":{"type":"string","description":"Ticker symbol"},"low_24h":{"type":"number","description":"24h low price"},"high_24h":{"type":"number","description":"24h high price"},"market_cap":{"type":"number","description":"Market cap"},"max_supply":{"type":"number","description":"Max supply"},"total_supply":{"type":"number","description":"Total supply"},"total_volume":{"type":"number","description":"24h trading volume"},"current_price":{"type":"number","description":"Current price"},"ath_change_pct":{"type":"number","description":"Percent change from all-time high"},"market_cap_rank":{"type":"integer","description":"Rank by market cap"},"circulating_supply":{"type":"number","description":"Circulating supply"},"price_change_pct_24h":{"type":"number","description":"Price change percent over 24h"}}},"description":"Coins ranked by market cap, descending"},"per_page":{"type":"integer","description":"Rows per page returned"},"queried_at":{"type":"string","format":"date-time","description":"UTC timestamp the upstream was queried"},"vs_currency":{"type":"string","description":"Currency the figures are quoted in"}}}}}}},"responseSchema":{"type":"json","example":{"page":1,"markets":[{"id":"bitcoin","name":"Bitcoin","symbol":"btc","current_price":67000,"market_cap_rank":1}],"per_page":10,"queried_at":"2026-06-08T12:00:00Z","vs_currency":"usd"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_xN5tnNYUVjIxFPbw9KF2G","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a paginated list of top cryptocurrencies ranked by market cap, including price, market-cap rank, and symbol in any target currency, sourced from CoinGecko.","exampleAgentPrompt":"Show me the top 50 cryptocurrencies ranked by market cap in EUR — pull the first page from CoinGecko's markets endpoint.","exampleUseCases":null,"resultDescription":"A paginated list of cryptocurrencies sorted by market-cap rank, each entry including the coin's name, symbol, current price in the requested currency, market cap, and market-cap rank. Results are sourced from CoinGecko and support up to 250 rows per page.","failureModes":["Invalid vs_currency code returns an error or empty results","page or per_page out of allowed range (per_page must be 1–250, page >= 1) returns a validation error","Payment failure (402) if USDC payment is not properly attached","Rate limiting if called too frequently","Empty result set if page number exceeds available data"],"whenToPreferThis":"Use this endpoint when you need a ranked, paginated list of top cryptocurrencies by market cap — ideal for leaderboards, portfolio screeners, or market overviews. Prefer this over the spot-price endpoint when you need rank, symbol, and price together for many coins at once, and over the trending endpoint when you want market-cap ranking rather than search popularity.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:33:19.791Z","isFirstParty":false}