{"uid":"cap_0e3S_oahESGFRxGmWS3hu","slug":"coingecko-fc2ab25d","name":"CoinGecko Onchain Token Price – Polygon PoS","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/polygon_pos/token_price/:address","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":"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.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_N7XR0HVfwc1zdtagRykWm","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":"Returns real-time DEX token price and market data for one or more token contract addresses on the Polygon PoS network.","exampleAgentPrompt":"What's the current on-chain price and 24-hour trading volume for the Polygon PoS token at contract address 0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174? Include market cap and 24hr price change too.","exampleUseCases":null,"resultDescription":"Returns a JSON object containing real-time on-chain price data for the specified Polygon PoS token contract address(es), sourced from DEX liquidity pools. Can include optional fields: 24-hour trading volume, market cap, 24-hour price change percentage, and total reserve in USD, depending on query parameters.","failureModes":["Token contract address not found on Polygon PoS – returns empty or null price data","Invalid contract address format – returns 400 Bad Request","Token has no active DEX liquidity on Polygon – returns no data or inactive source","Payment not provided or insufficient – returns 402 Payment Required","Rate limit exceeded – returns 429 Too Many Requests","Network identifier mismatch – using Ethereum address on Polygon endpoint returns no results"],"whenToPreferThis":"Use this endpoint when you need real-time on-chain DEX prices for tokens specifically on the Polygon PoS network, identified by contract address rather than coin ID or ticker symbol. Prefer this over CoinGecko's standard coin price endpoint when the token is primarily traded on-chain via DEXes and may not have a CoinGecko coin ID. Choose this over Ethereum or Base equivalents when the token contract is on Polygon PoS.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:30:26.171Z","isFirstParty":false}