{"uid":"cap_dcROP3SsInH6KB3UCvsOf","slug":"erc20-token-usd-price-lookup-533cebf2","name":"ERC20 Token USD Price Lookup","description":"Current USD price of an ERC20 token — Genesis402 / UnyKorn Operator Network","url":"https://twin.unykorn.org/token-price?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"params":{"type":"object","properties":{"chain":{"enum":["ethereum","base","polygon","arbitrum","optimism","bsc","avalanche","gnosis","linea","scroll"],"type":"string"},"contract":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}}}}},"responseSchema":{"type":"json","example":{"ok":true,"type":"token-price","receipt":{"tx_hash":"0x<64hex>","amount_usd":0.004,"receipt_id":"g402-<16hex>"},"generated_at":"<iso8601>"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.004","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.004/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_1-7a_Xb4jIdfOXd6ydJw-","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.004","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 an ERC20 token given its contract address and chain","exampleAgentPrompt":"What's the current USD price of the USDC token at contract address 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 on Ethereum?","exampleUseCases":[{"title":"Portfolio value calculation","prompt":"What's the current USD price of the token at 0x1f9840a85d5aF5bf1D1762F925BDADdC4201F984 on Ethereum? I need it to calculate how much my holdings are worth."},{"title":"DeFi arbitrage price check","prompt":"Can you get me the current USD price of the token at contract 0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174 on Polygon? I'm comparing prices across chains."},{"title":"Token price monitoring on Base","prompt":"What's the USD price right now for the token with contract address 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 on Base?"}],"resultDescription":"Returns a JSON object with ok status, the token type identifier, a receipt containing transaction hash, amount paid in USD, and a receipt ID, plus a generated_at ISO8601 timestamp. The actual USD price of the token is included in the response payload.","failureModes":["Invalid contract address format (not matching 0x[40 hex chars] pattern) returns a validation error","Unsupported chain not in the allowed enum returns an error","Token contract not found or not an ERC20 on the specified chain may return an error or null price","Payment of 0.004 USDC not received results in 402 Payment Required","Network timeouts or RPC failures on the target chain may cause transient errors"],"whenToPreferThis":"Use this endpoint when you need a quick, on-demand USD price for any ERC20 token across ten major EVM chains (Ethereum, Base, Polygon, Arbitrum, Optimism, BSC, Avalanche, Gnosis, Linea, Scroll) and have the token's contract address. It is ideal for per-call, real-time price fetches rather than bulk historical data or streaming price feeds. Prefer this over general-purpose DEX aggregators when working in a pay-per-use agentic context with the x402 payment protocol.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-01T18:55:35.696Z","isFirstParty":false,"canonicalSlug":"erc20-token-usd-price-lookup-533cebf2"}