{"uid":"cap_6crBtxNBPIz9nHb--I82l","slug":"coingecko-simple-token-price-712703d6","name":"CoinGecko Simple Token Price","description":"Get token prices by contract address on a specific platform (e.g. Ethereum).","url":"https://coingecko.mpp.paywithlocus.com/coingecko/simple-token-price?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","required":["platform_id","contract_addresses","vs_currencies"],"properties":{"platform_id":{"type":"string","description":"Platform ID (e.g. \"ethereum\", \"polygon-pos\")"},"vs_currencies":{"type":"string","description":"Comma-separated target currencies"},"include_24hr_vol":{"type":"boolean","description":"Include 24hr volume"},"contract_addresses":{"type":"string","description":"Comma-separated contract addresses"},"include_market_cap":{"type":"boolean","description":"Include market cap"},"include_24hr_change":{"type":"boolean","description":"Include 24hr change"}},"additionalProperties":true},"responseSchema":null,"example":{"request":{"platform_id":"ethereum","vs_currencies":"usd","include_24hr_vol":true,"contract_addresses":"0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48","include_market_cap":true,"include_24hr_change":true},"response":{"data":{"0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48":{"usd":0.999478,"usd_24h_vol":16053912365.621054,"usd_24h_change":-0.018186274144123306,"usd_market_cap":76365104168.16609}},"success":true}},"exampleRequest":{"platform_id":"ethereum","vs_currencies":"usd","include_24hr_vol":true,"contract_addresses":"0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48","include_market_cap":true,"include_24hr_change":true},"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_i4bnHXX6lGgOKk8mEyu-a","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":"Retrieves the current price and optional market data (market cap, 24h volume, 24h change) for a token by its smart contract address on a specified blockchain platform.","exampleAgentPrompt":"What's the current USD price, market cap, and 24-hour change for the token at Ethereum contract address 0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48?","exampleUseCases":null,"resultDescription":"Returns a JSON object keyed by contract address containing the token's price in the requested currency, and optionally its 24-hour trading volume, 24-hour percentage price change, and market capitalization. Includes a 'success' boolean flag.","failureModes":["Invalid or unrecognized contract address returns empty data object","Unsupported platform_id returns an error or empty result","Invalid vs_currencies string causes a failed or incomplete response","Comma-separated contract addresses with whitespace may cause lookup failures","Rate limiting or service unavailability returns a non-success response"],"whenToPreferThis":"Use this endpoint when you have a specific token's smart contract address on a known blockchain platform (e.g. Ethereum, Polygon) and need current price data. Prefer this over the Simple Price endpoint when you identify tokens by contract address rather than by CoinGecko coin ID or ticker symbol. Ideal for DeFi applications, portfolio trackers, or any workflow that deals with on-chain token contracts.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-10T18:38:47.771Z","isFirstParty":false,"canonicalSlug":"coingecko-simple-token-price-712703d6"}