{"uid":"cap_OzlANaTzbURdEngG0PCZU","slug":"coingecko-onchain-dex-token-price-ethereum-network-36f3c3cd","name":"CoinGecko Onchain DEX Token Price (Ethereum Network)","description":"Query onchain DEX token price & market data based on the provided token contract addresses on a network.","url":"https://pro-api.coingecko.com/api/v3/x402/onchain/simple/networks/eth/token_price/probe","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input","output"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","properties":{"include_24hr_vol":{"type":"boolean"},"mcap_fdv_fallback":{"type":"boolean"},"include_market_cap":{"type":"boolean"},"include_inactive_source":{"type":"boolean"},"include_24hr_price_change":{"type":"boolean"},"include_total_reserve_in_usd":{"type":"boolean"}}}},"additionalProperties":false},"output":{"type":"object","required":["type","example"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_BnaCYszSZMRPuN0Glb-a1","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches real-time DEX token price and market data for Ethereum-network tokens by contract address via CoinGecko's onchain API.","exampleAgentPrompt":"What's the current DEX price, 24-hour volume, and market cap for the Ethereum token at contract address 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48? Pull the data from CoinGecko's onchain API.","exampleUseCases":[{"title":"DeFi portfolio price tracking","prompt":"I'm tracking a DeFi token on Ethereum — contract address 0x6B175474E89094C44Da98b954EedeAC495271d0F. Can you pull its current onchain DEX price, 24-hour price change, and market cap for me?"},{"title":"New token discovery due diligence","prompt":"I just found a new ERC-20 token at contract 0x514910771AF9Ca656af840dff83E8264EcF986CA on Ethereum. Can you look up its onchain DEX price and total reserve in USD so I can evaluate if it has liquidity?"},{"title":"DeFi arbitrage price monitoring","prompt":"Can you fetch the live DEX price and 24-hour trading volume from CoinGecko for the Ethereum token at contract 0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2? I want to compare it against another exchange price."}],"resultDescription":"Returns a JSON object containing the token's current DEX price in USD, and optionally: 24-hour trading volume, market capitalization, 24-hour price change percentage, total reserve in USD, and whether inactive liquidity sources were included — all sourced from onchain DEX pool data on the Ethereum network.","failureModes":["Unknown or unsupported contract address returns empty or null data","Token with no active DEX liquidity may return no price data unless include_inactive_source is enabled","Invalid contract address format causes a 400 bad request error","Rate limit exceeded returns 429 too many requests","Authentication failure (missing or invalid API key) returns 401 unauthorized","Network not supported at this endpoint path returns 404"],"whenToPreferThis":"Use this endpoint when you need onchain DEX pricing for Ethereum tokens identified only by contract address, especially for tokens not listed on centralized exchanges. It is ideal when you want raw DEX market data including reserves and volume rather than aggregated CeFi prices. Prefer this over CoinGecko's standard /simple/price endpoint when you have a contract address but not a CoinGecko coin ID, or when you specifically need onchain liquidity metrics.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:42:46.140Z","isFirstParty":false}