{"uid":"cap_VRFESAOEHGQh0pD_UsBP6","slug":"token-price-by-contract-address-f8f88fd3","name":"Token Price by Contract Address","description":"Token price by contract address, live from the chain ($0.001): USD price of any ERC-20 on Base, Ethereum, Arbitrum, Optimism or Polygon from a simulated $100 buy and sale on the best DEX route (Uniswap v2/v3/v4, Aerodrome), with buy and sell price, round-trip cost as a liquidity gauge, total supply and fully diluted value. Use for the current price of any token, including ones too new for price APIs.","url":"https://api.marketintelligenceapi.com/api/v1/intelligence/token-price/:address?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"},"pathParams":{"type":"object","required":["address"],"properties":{"address":{"type":"string","examples":["0x940181a94a35a4569e4529a3cdfb74e38fd98631"],"description":"ERC-20 contract address (0x...) on the chain given by ?chain."}},"additionalProperties":false},"queryParams":{"type":"object","properties":{"chain":{"enum":["base","ethereum","arbitrum","optimism","polygon"],"type":"string","default":"base","description":"Chain the token lives on. Not the payment network."}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"description":"Example JSON response returned by this endpoint"}},"additionalProperties":true}},"additionalProperties":false},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","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.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_tBVUD8PPZG62vSrnmXhm-","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the live USD price of any ERC-20 token on Base, Ethereum, Arbitrum, Optimism, or Polygon by simulating a $100 buy/sell on the best DEX route, with buy/sell prices, round-trip spread, total supply, and FDV.","exampleAgentPrompt":"What's the current live price of the token at contract address 0x940181a94a35a4569e4529a3cdfb74e38fd98631 on Base — including buy price, sell price, and fully diluted value?","exampleUseCases":[{"title":"New token launch price check","prompt":"I just found a brand new token on Base with contract 0x940181a94a35a4569e4529a3cdfb74e38fd98631 — it's too new to be on CoinGecko or CoinMarketCap. Can you get me the live on-chain buy and sell price, plus the fully diluted valuation?"},{"title":"DeFi liquidity spread analysis","prompt":"Can you check the buy/sell spread for the Ethereum token at 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 — I want to know the round-trip cost as a measure of how liquid it is before I trade it?"},{"title":"Portfolio token valuation on Arbitrum","prompt":"What's the current USD price and total supply for the token at contract 0xFF970A61A04b1cA14834A43f5dE4533eBDDB5CC8 on Arbitrum, using the best Uniswap DEX route available?"}],"resultDescription":"Returns the live USD buy price, USD sell price, round-trip cost (as a liquidity gauge), the DEX route used (Uniswap v2/v3/v4 or Aerodrome), total token supply, and fully diluted value — all derived from a simulated $100 buy and sell on-chain.","failureModes":["Contract address not found on the specified chain — returns error or empty result","Token has no liquidity pool on any supported DEX — price simulation fails","Invalid or malformed contract address (non-0x or wrong length) — returns validation error","Unsupported chain specified — returns 400-level error","Network or RPC outage causes stale or failed simulation — returns error or timeout"],"whenToPreferThis":"Choose this endpoint when you need the live on-chain price of any ERC-20 token — especially newly launched tokens not yet indexed by aggregators like CoinGecko or CoinMarketCap. Prefer this over traditional price APIs when you need real DEX-sourced prices with liquidity context (buy/sell spread, round-trip cost) rather than aggregated last-trade prices. It is especially valuable for DeFi agents, trading bots, and portfolio tools that must handle tokens across Base, Ethereum, Arbitrum, Optimism, and Polygon by their raw contract addresses.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T18:37:05.281Z","isFirstParty":false,"canonicalSlug":"token-price-by-contract-address-f8f88fd3"}