{"uid":"cap_Mr4F_HU8QzkIa9aKAoVs5","slug":"pro-api-coingecko-com-2e506987","name":"CoinGecko Pro On-Chain WETH Price (Ethereum)","description":"Fetches the real-time on-chain price for WETH (0xC02aaa39b223fe8d0a0e5c4f27ead9083c756cc2) on Ethereum via CoinGecko Pro x402.","url":"https://pro-api.coingecko.com/api/v3/x402/onchain/simple/networks/eth/token_price/0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2?utm_source=zero.xyz","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","h24_price_change_percentage"],"properties":{"token_prices":{"type":"object","required":["0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2"],"properties":{"0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2":{"type":"string"}}},"h24_volume_usd":{"type":"object","required":["0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2"],"properties":{"0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2":{"type":"string"}}},"h24_price_change_percentage":{"type":"object","required":["0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2"],"properties":{"0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2":{"type":"string"}}}}}}}}},"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"include_24hr_vol":true,"mcap_fdv_fallback":false,"include_market_cap":false,"include_inactive_source":false,"include_24hr_price_change":true,"include_total_reserve_in_usd":false}},"output":{"type":"object","example":{"0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2":{"eth":{"price":2500.5,"24h_vol":1500000000,"24h_price_change_percentage":2.35}}}}},"response":{"data":{"id":"fa4e71d0-9444-4e49-93df-ed7f59d3e10b","type":"simple_token_price","attributes":{"token_prices":{"0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2":"1794.24297383468"},"h24_volume_usd":{"0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2":"371982028.296356"},"h24_price_change_percentage":{"0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2":"4.4554421436"}}}}},"exampleRequest":{"include_24hr_vol":true,"mcap_fdv_fallback":false,"include_market_cap":false,"include_inactive_source":false,"include_24hr_price_change":true,"include_total_reserve_in_usd":false},"tags":["x402"],"displayCostAmount":"0.010000","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.010000/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_sTKL81i1jrZbTnBYMrUJW","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":"Fetches the real-time on-chain price for WETH (Wrapped Ether) on Ethereum mainnet by contract address via CoinGecko Pro.","exampleAgentPrompt":"What's the current on-chain price of WETH on Ethereum right now, and can you also include its 24-hour price change and trading volume?","exampleUseCases":[{"title":"Monitor WETH price for DeFi trading","prompt":"I need to check the current WETH price on Ethereum before I execute a swap. Can you get me the latest on-chain price and let me know if it's moved significantly in the last 24 hours?"},{"title":"Track wrapped Ether market data","prompt":"Pull the real-time WETH token price from the contract address and give me the market cap and 24-hour trading volume so I can see how liquid the market is right now."},{"title":"Alert on WETH price movements","prompt":"What's the current USD price of WETH on Ethereum mainnet, and has it changed more than 5% in the last day? I want to know if there's unusual price activity happening."}],"resultDescription":"Returns the real-time on-chain price of WETH (0xC02aaa39b223fe8d0a0e5c4f27ead9083c756cc2) on Ethereum, along with optional fields such as 24hr trading volume, market cap, 24hr price change percentage, and total reserve in USD — sourced from CoinGecko's on-chain DEX data.","failureModes":["Payment not received or x402 payment protocol failure — endpoint returns 402 Payment Required","Invalid or unsupported contract address — returns 404 or empty result","Network not supported — returns error if network identifier is incorrect","Rate limit exceeded — returns 429 Too Many Requests","Stale or missing on-chain liquidity data — price may be unavailable for illiquid tokens"],"whenToPreferThis":"Use this endpoint when you specifically need the real-time on-chain DEX price of WETH on Ethereum mainnet from CoinGecko's Pro API, especially when you need DEX-sourced pricing (not centralized exchange pricing) with optional market data like 24hr volume or market cap. Prefer this over generic coin price endpoints when you need on-chain data tied to a specific contract address rather than a coin ID.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T06:32:53.771Z","isFirstParty":false,"canonicalSlug":"pro-api-coingecko-com-2e506987"}