{"uid":"cap_Et-N6Em1jKt89PZKuU3Q4","slug":"defi-api-real-time-token-price-by-coingecko-id-or-symbol-8ef07812","name":"DeFi API - Real-Time Token Price by CoinGecko ID or Symbol","description":"Real-time token price by CoinGecko ID or symbol - includes 24h change, volume, market cap","url":"https://defi-api.agenticfi.wtf/api/token/price/BTC?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","pathParams","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"pathParams":{"type":"object","required":["idOrSymbol"],"properties":{"idOrSymbol":{"type":"string","title":"idOrSymbol (required)","description":"Required. CoinGecko ID or common symbol.\nTry one of these 10 examples: bitcoin, ethereum, solana, chainlink, uniswap, aave, maker, dogecoin, pepe, arbitrum\nSymbol examples: BTC, ETH, SOL, LINK, UNI, AAVE, MKR, DOGE, PEPE, ARB"}}},"queryParams":{"type":"object","required":["idOrSymbol"],"properties":{"idOrSymbol":{"type":"string","title":"idOrSymbol (required)","description":"Required. CoinGecko ID or common symbol.\nTry one of these 10 examples: bitcoin, ethereum, solana, chainlink, uniswap, aave, maker, dogecoin, pepe, arbitrum\nSymbol examples: BTC, ETH, SOL, LINK, UNI, AAVE, MKR, DOGE, PEPE, ARB"}}}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_po8PMC24lFtwpe9vwa4ok","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the current USD price of a cryptocurrency token along with its 24-hour change, trading volume, and market cap, identified by CoinGecko ID or symbol.","exampleAgentPrompt":"What's the current price of Ethereum right now, including its 24-hour change and market cap?","exampleUseCases":[{"title":"Real-time crypto price check","prompt":"What's the current price of Bitcoin, and how much has it moved in the last 24 hours?"},{"title":"DeFi token research before trade","prompt":"I'm thinking about buying some Aave — can you pull the latest price, 24h change, and trading volume for it?"},{"title":"Portfolio monitoring alert","prompt":"Check the current prices and 24h performance for SOL, LINK, and ARB so I can see how my holdings are doing today."}],"resultDescription":"Returns the current USD price of the requested token sourced via CoinGecko, along with its 24-hour percentage price change, total trading volume (USD), and market capitalization (USD).","failureModes":["Unknown or unsupported token symbol/ID returns an error or empty result","Ambiguous symbol (e.g. a symbol shared by multiple tokens) may resolve to an unexpected token","CoinGecko data lag during high-volatility periods may result in slightly stale prices","Network or provider downtime results in a 5xx error","Malformed or missing idOrSymbol parameter returns a 400-level error"],"whenToPreferThis":"Choose this endpoint when you need a quick, real-time spot price for a well-known cryptocurrency by its CoinGecko ID or common ticker symbol, along with key market metrics (24h change, volume, market cap). It is ideal for lightweight price checks, portfolio valuation, or pre-trade research. Prefer it over DEX pair or on-chain price feeds when you want aggregated market data rather than raw on-chain swap prices.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T12:44:14.458Z","isFirstParty":false,"canonicalSlug":"defi-api-real-time-token-price-by-coingecko-id-or-symbol-8ef07812"}