{"uid":"cap_PHvxqy865ygWyw0x7bxtI","slug":"batch-token-prices-by-coingecko-id-or-chain-address-398805f7","name":"Batch Token Prices by CoinGecko ID or Chain:Address","description":"Batch token prices: up to 25 tokens in one call by CoinGecko id or chain:address — Genesis402 / UnyKorn Operator Network","url":"https://twin.unykorn.org/defi/token-prices?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"params":{"type":"object","properties":{"coins":{"type":"array","items":{"type":"string"},"maxItems":25,"description":"required: up to 25 ids like coingecko:bitcoin or base:0x..."}}}}},"responseSchema":{"type":"json","example":{"ok":true,"type":"token-prices","receipt":{"tx_hash":"0x<64hex>","amount_usd":0.002,"receipt_id":"g402-<16hex>"},"sources":[{"ok":true,"name":"<source>"}],"limitations":"<text>","generated_at":"<iso time>","evidence_hash":"sha256:<64hex>"}},"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_aMP0SHwrleIgJ-C26iGEM","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":"Fetches current prices for up to 25 tokens in a single call, identified by CoinGecko ID or chain:contract-address format","exampleAgentPrompt":"What are the current prices for Bitcoin, Ethereum, and USDC — can you look them up using their CoinGecko IDs coingecko:bitcoin, coingecko:ethereum, and coingecko:usd-coin all at once?","exampleUseCases":[{"title":"DeFi portfolio value snapshot","prompt":"Get me the current prices for all five tokens in my portfolio — coingecko:bitcoin, coingecko:ethereum, coingecko:solana, coingecko:chainlink, and base:0x833589fcd6edb6e08f4c7c32d4f71b54bda02913 — I need them all at once."},{"title":"Arbitrage opportunity detection","prompt":"Pull the live prices for these tokens right now: coingecko:uniswap, coingecko:aave, coingecko:curve-dao-token, and coingecko:balancer — I want to compare them quickly."},{"title":"On-chain token price enrichment","prompt":"I have a list of Base network token contract addresses — base:0x4200000000000000000000000000000000000006 and base:0x833589fcd6edb6e08f4c7c32d4f71b54bda02913 — can you get their current USD prices?"}],"resultDescription":"Returns current USD prices for each requested token, keyed by the input identifier (CoinGecko ID or chain:address). Up to 25 tokens returned per call.","failureModes":["Exceeding 25 tokens in one request returns a validation error","Unknown or misspelled CoinGecko IDs return null or error for that token","Invalid chain:address format causes parse errors","Unsupported chain prefix for chain:address lookups returns no data","Payment failure (x402) blocks the request entirely","Tokens with very low liquidity may return stale or missing prices"],"whenToPreferThis":"Choose this endpoint when you need prices for multiple tokens simultaneously and want to minimize round-trips — it batches up to 25 tokens in one paid call. Prefer it over single-token lookups when building portfolio trackers, DeFi dashboards, or arbitrage bots that need current prices across several assets. Supports both CoinGecko IDs (coingecko:bitcoin) and on-chain contract addresses (chain:0x...) making it flexible for both well-known coins and long-tail EVM tokens.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T03:39:53.961Z","isFirstParty":false,"canonicalSlug":"batch-token-prices-by-coingecko-id-or-chain-address-398805f7"}