{"uid":"cap_JXa6Ow6e_xJ80u7xCIagz","slug":"token-price-lookup-by-symbol-or-chain-contract-302f8f1b","name":"Token Price Lookup by Symbol or Chain+Contract","description":"USD price for any major token by symbol or chain+contract — $0.001 USDC","url":"https://1c09pdnrx1.execute-api.us-east-1.amazonaws.com/v1/price/token","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","properties":{"chain":{"type":"string","description":"Chain slug: base, ethereum, solana, polygon, arbitrum, optimism, bsc, avalanche."},"symbol":{"type":"string","description":"Token symbol (BTC, ETH, SOL, USDC, …). Mutually exclusive with chain+contract."},"contract":{"type":"string","description":"Token contract address. Required with chain."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"object","required":["usd","name","chain","source","symbol","contract","fetched_at","age_seconds","market_cap_usd","usd_24h_change_pct"],"properties":{"usd":{"type":"number"},"name":{"type":"string"},"chain":{"type":"null"},"source":{"type":"string"},"symbol":{"type":"string"},"contract":{"type":"null"},"fetched_at":{"type":"number"},"age_seconds":{"type":"number"},"market_cap_usd":{"type":"number"},"usd_24h_change_pct":{"type":"number"}}},"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"symbol":"ETH"}}},"response":{"usd":1825.35,"name":"Ethereum","chain":null,"source":"coingecko","symbol":"ETH","contract":null,"fetched_at":1780527260,"age_seconds":0,"market_cap_usd":220393573748.25534,"usd_24h_change_pct":-2.3351817930643235}},"exampleRequest":{"symbol":"ETH"},"tags":["x402"],"displayCostAmount":"0.001","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_vcMqDBn0ozzr0PgF14Ge2","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the current USD price for any major cryptocurrency token, queried by symbol (e.g. ETH) or by blockchain network and contract address","exampleAgentPrompt":"What's the current USD price of ETH? Also, can you look up the price of the USDC token on Base using contract address 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913?","exampleUseCases":null,"resultDescription":"Returns the current USD price for the requested token, identified either by symbol (BTC, ETH, SOL, USDC, etc.) or by chain slug plus contract address. The response is a structured object containing the token price in USD.","failureModes":["Symbol not recognized or unsupported token — returns error or null price","Contract address not found on specified chain — returns not found error","Chain slug invalid or unsupported — returns validation error","Providing both symbol and chain+contract simultaneously may cause conflict","Network timeout or upstream price feed unavailability — returns 5xx error","Missing required query parameter (neither symbol nor chain+contract provided)"],"whenToPreferThis":"Use this endpoint when you need a quick, low-cost ($0.001 USDC) USD price for a specific cryptocurrency token and you know either its symbol (e.g. ETH, BTC, SOL) or its on-chain contract address and network. Ideal for DeFi agents, portfolio trackers, trading bots, or any workflow that needs real-time token pricing across major chains including Base, Ethereum, Solana, Polygon, Arbitrum, Optimism, BSC, and Avalanche.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:42:10.042Z","isFirstParty":false}