{"uid":"cap_qZZlaMuDRj8vbq8uox6bS","slug":"coingecko-market-depth-by-coin-0cae45b1","name":"CoinGecko Market Depth by Coin","description":"CoinGecko per-exchange market depth for one coin: USD cost to move price up 2% and down 2% (liquidity), 24h volume in USD, last price and bid-ask spread, for the 15 highest-volume trading pairs. Each row is one exchange pair, not a merged order book. Data is CoinGecko's, updated on its own schedule.","url":"https://api.chainmarket-api.workers.dev/api/crypto/coingecko-market-depth?utm_source=zero.xyz","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","required":["coin"],"properties":{"coin":{"type":"string","description":"CoinGecko coin id, e.g. bitcoin, ethereum, solana"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"coin":"bitcoin","name":"Bitcoin","rows":[{"last":81663.71,"pair":"BTC/USDT","isStale":false,"lastUsd":81573,"exchange":"CoinUp.io","isAnomaly":false,"exchangeId":"coinup","trustScore":null,"lastTradedAt":"2026-10-23T09:33:56+00:00","volumeUsd24h":4120838850,"bidAskSpreadPct":0.010037,"costToMoveUpUsd":32160158.37931772,"costToMoveDownUsd":9693135.711770184},{"last":81590.15,"pair":"BTC/USDT","isStale":false,"lastUsd":81499,"exchange":"BTCC","isAnomaly":false,"exchangeId":"btcc","trustScore":null,"lastTradedAt":"2026-10-23T09:31:46+00:00","volumeUsd24h":2229198782,"bidAskSpreadPct":0.010012,"costToMoveUpUsd":11905314.86741312,"costToMoveDownUsd":16685188.18960241}],"source":"https://api.coingecko.com/api/v3/coins/bitcoin/tickers?depth=true","checkedAt":"2026-10-23T09:35:55.313Z"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_JTeSq65AlfKjPJoOfhXB1","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns order book depth data (bid/ask spread, cost-to-move, volume, trust score) for a cryptocurrency across all exchanges tracked by CoinGecko","exampleAgentPrompt":"Pull the full market depth data for Bitcoin from CoinGecko — I need the bid-ask spreads, cost-to-move figures, and 24h volumes across all exchanges.","exampleUseCases":[{"title":"Finding tightest spread for arbitrage","prompt":"Which exchange currently has the tightest bid-ask spread for Ethereum, and what's the 24-hour volume there? Pull the full market depth from CoinGecko."},{"title":"Estimating market impact before large trade","prompt":"I'm planning a large Bitcoin trade — can you look up the cost-to-move-up and cost-to-move-down figures across exchanges so I can estimate market impact?"},{"title":"Monitoring stale or anomalous prices","prompt":"Check the CoinGecko market depth data for Solana and flag any exchanges showing stale prices or price anomalies right now."}],"resultDescription":"A JSON object containing the coin ID and name, and an array of rows — one per exchange — each with the trading pair, last price, last price in USD, 24h volume in USD, bid-ask spread percentage, cost to move up/down in USD, trust score, exchange ID and name, stale flag, anomaly flag, and last traded timestamp. Also includes the CoinGecko source URL and a checkedAt timestamp.","failureModes":["Invalid or unknown CoinGecko coin ID returns an error or empty result","Coin with no depth data on CoinGecko returns empty rows array","Network or upstream CoinGecko API outage causes request failure","Missing required 'coin' query parameter causes validation error","Payment failure (insufficient USDC balance) results in 402 response with no charge"],"whenToPreferThis":"Choose this endpoint when you need per-exchange order book depth metrics — bid-ask spreads, cost-to-move-up/down, and volume — for a specific cryptocurrency, sourced from CoinGecko's aggregated ticker data. It is ideal for market microstructure analysis, liquidity comparison, arbitrage research, or pre-trade impact estimation. Prefer it over generic price endpoints when spread or market depth context is required, and over building your own CoinGecko integration when you want pay-per-call access with no API key.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-24T12:46:37.019Z","isFirstParty":false,"canonicalSlug":"coingecko-market-depth-by-coin-0cae45b1"}