{"uid":"cap_mUyIRs89DdTsV7gYKbas7","slug":"pro-api-coingecko-com-614b3883","name":"CoinGecko On-Chain ETH Token Price (USDT / 0xdac17f)","description":"Returns the current on-chain price for a specified ERC-20 token on Ethereum by contract address (e.g., USDT 0xdac17f...).","url":"https://pro-api.coingecko.com/api/v3/x402/onchain/simple/networks/eth/token_price/0xdac17f958d2ee523a2206206994597c13d831ec7","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":{"type":"object","required":["data"],"properties":{"data":{"type":"object","required":["id","type","attributes"],"properties":{"id":{"type":"string"},"type":{"type":"string"},"attributes":{"type":"object","required":["token_prices","h24_volume_usd","market_cap_usd","h24_price_change_percentage"],"properties":{"token_prices":{"type":"object","required":["0xdac17f958d2ee523a2206206994597c13d831ec7"],"properties":{"0xdac17f958d2ee523a2206206994597c13d831ec7":{"type":"string"}}},"h24_volume_usd":{"type":"object","required":["0xdac17f958d2ee523a2206206994597c13d831ec7"],"properties":{"0xdac17f958d2ee523a2206206994597c13d831ec7":{"type":"string"}}},"market_cap_usd":{"type":"object","required":["0xdac17f958d2ee523a2206206994597c13d831ec7"],"properties":{"0xdac17f958d2ee523a2206206994597c13d831ec7":{"type":"string"}}},"h24_price_change_percentage":{"type":"object","required":["0xdac17f958d2ee523a2206206994597c13d831ec7"],"properties":{"0xdac17f958d2ee523a2206206994597c13d831ec7":{"type":"string"}}}}}}}}},"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"include_24hr_vol":true,"include_market_cap":true,"include_24hr_price_change":true}},"output":{"type":"object","example":{"0xdac17f958d2ee523a2206206994597c13d831ec7":{"eth":1,"eth_24h_vol":500000000,"eth_24h_change":0.5,"eth_market_cap":85000000000}}}},"response":{"data":{"id":"060f8fb4-5e4a-431b-9a89-8247a7856371","type":"simple_token_price","attributes":{"token_prices":{"0xdac17f958d2ee523a2206206994597c13d831ec7":"0.974301194360151"},"h24_volume_usd":{"0xdac17f958d2ee523a2206206994597c13d831ec7":"644436709.656794"},"market_cap_usd":{"0xdac17f958d2ee523a2206206994597c13d831ec7":"182102294565.25058"},"h24_price_change_percentage":{"0xdac17f958d2ee523a2206206994597c13d831ec7":"-1.4391495957438463"}}}}},"exampleRequest":{"include_24hr_vol":true,"include_market_cap":true,"include_24hr_price_change":true},"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_SrynsCBSAP0ZfSlw3sx97","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the current on-chain price for the USDT ERC-20 token on Ethereum by its contract address (0xdac17f958d2ee523a2206206994597c13d831ec7).","exampleAgentPrompt":"What's the current on-chain price of USDT on Ethereum right now, and can you also include the 24-hour price change and market cap?","exampleUseCases":null,"resultDescription":"Returns a JSON object containing the current on-chain price of the token (USDT at 0xdac17f958d2ee523a2206206994597c13d831ec7) on Ethereum, optionally including 24hr volume, market cap, 24hr price change, total reserve in USD, and data from inactive sources depending on query parameters supplied.","failureModes":["Invalid or unsupported contract address returns 404 or empty result","Missing or invalid API key returns 401 unauthorized","Rate limit exceeded returns 429 too many requests","Network congestion or upstream data lag may cause stale price data","Payment not processed (x402 protocol failure) returns 402 payment required"],"whenToPreferThis":"Use this endpoint when you specifically need the on-chain price of USDT (or the ERC-20 token at 0xdac17f958d2ee523a2206206994597c13d831ec7) on the Ethereum network, sourced directly from on-chain DEX data via CoinGecko Pro. Prefer this over CoinGecko's off-chain simple price endpoint when you need DEX-sourced pricing, or when you need on-chain market metrics like total reserve in USD. This is especially useful for DeFi applications, arbitrage monitoring, or any workflow requiring verifiable on-chain price feeds for Ethereum tokens.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:48:27.486Z","isFirstParty":false}