{"uid":"cap_M4Lzt7gIotsLaxQ2BK3Gb","slug":"blocknotify-token-price-lookup-485eb0fd","name":"BlockNotify Token Price Lookup","description":"Get real-time token price, market cap and more. Pass an EVM chain plus ERC-20 contract address; returns current price (USD or any quote currency), 24h/7d/30d percentage changes, market cap, fully diluted valuation, 24h volume, all-time high/low, total / circulating / max supply, and basic community stats. Cached server-side for ~7 minutes for low-cost agent lookups.","url":"https://x402.blocknotify.com/v1/token-price","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"chain":{"enum":["ethereum","polygon","arbitrum","optimism","base"],"type":"string","description":"Target EVM chain. The merchant maps this to the appropriate RPC for simulation."},"address":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"ERC-20 contract address of the token to price."},"currency":{"type":"string","default":"USD","maxLength":10,"minLength":3,"description":"Fiat or crypto quote currency (ISO-style code, e.g. \"USD\", \"EUR\", \"BTC\", \"ETH\"). Defaults to USD."}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.0011","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.0011/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0011","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0011","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_HerlH-0bZP3ibf8htqBxb","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.0011","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns real-time ERC-20 token price, market cap, volume, supply, and historical percentage changes for a given contract address on an EVM chain.","exampleAgentPrompt":"What's the current USD price and market cap of the token at contract address 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 on Ethereum, and how much has it changed in the last 24 hours and 7 days?","exampleUseCases":[{"title":"DeFi portfolio price check","prompt":"Can you pull up the current price, market cap, and 24h/7d price changes for the token at 0x6B175474E89094C44Da98b954EedeAC495271d0F on Ethereum in USD?"},{"title":"New token due diligence","prompt":"I'm looking at a token on Base at address 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 — what's its fully diluted valuation, circulating supply, and all-time high right now?"},{"title":"Cross-chain price comparison","prompt":"Get me the current price in ETH for the token at 0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174 on Polygon so I can compare it against the same token on Arbitrum."}],"resultDescription":"Returns a JSON object containing the token's current price in the requested quote currency, percentage price changes over 24h, 7d, and 30d windows, market cap, fully diluted valuation, 24h trading volume, all-time high and low prices, total/circulating/max supply figures, and basic community statistics. Data is cached server-side for approximately 7 minutes.","failureModes":["Invalid or non-ERC-20 contract address returns an error or empty result","Unsupported chain value outside the allowed enum causes a validation error","Token with no price feed or very low liquidity may return null/missing price fields","Unsupported quote currency may return an error or fall back to USD","Payment failure (insufficient USDC balance) blocks the request under x402 protocol"],"whenToPreferThis":"Choose this endpoint when you need comprehensive token market data — price, market cap, supply, volume, and historical changes — for a known ERC-20 contract address on a supported EVM chain (Ethereum, Polygon, Arbitrum, Optimism, Base). Prefer this over on-chain RPC calls when you want aggregated market data (not just on-chain state) and when the ~7-minute cache latency is acceptable. Use this instead of general crypto price APIs when you already have the contract address and want structured multi-metric output in a single call.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:36:34.495Z","isFirstParty":false}