{"uid":"cap_V88mY5vMch7Um_SV8VlB5","slug":"agenticfi-evm-token-info-by-contract-address-2ceb6d99","name":"AgenticFi EVM Token Info by Contract Address","description":"EVM token info by contract address or native asset - metadata, realtime price, supply fields, logo, and optional historical prices","url":"https://defi-api.agenticfi.wtf/api/token/info/:address","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","pathParams","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"pathParams":{"type":"object","required":["address"],"properties":{"address":{"type":"string","title":"address (required)","description":"Required. ERC-20 contract address or 'native' for the chain-native asset.\nExamples: native, 0x833589fCD6EDB6E08f4c7C32D4f71b54bdA02913 (Base USDC), 0x4200000000000000000000000000000000000006 (Base WETH), 0xd9aaec86b65d86f6a7b5b1b0c42ffa531710b6ca (Base USDbC)"}}},"queryParams":{"type":"object","required":["address","chain_ids"],"properties":{"chain":{"type":"string","title":"chain (optional)","description":"Optional. Legacy gateway alias for a single chain name, mapped to chain_ids Examples: base, ethereum, arbitrum"},"limit":{"type":"string","title":"limit (optional)","description":"Optional. Maximum number of token rows to return, 1-100 Examples: 100, 500"},"offset":{"type":"string","title":"offset (optional)","description":"Optional. Pagination cursor returned in next_offset Examples: eyJvZmZzZXQiOjEwMH0= (use next_offset from the previous response)"},"address":{"type":"string","title":"address (required)","description":"Required. ERC-20 contract address or 'native' for the chain-native asset.\nExamples: native, 0x833589fCD6EDB6E08f4c7C32D4f71b54bdA02913 (Base USDC), 0x4200000000000000000000000000000000000006 (Base WETH), 0xd9aaec86b65d86f6a7b5b1b0c42ffa531710b6ca (Base USDbC)"},"chain_ids":{"type":"string","title":"chain_ids (required)","description":"Required single chain ID, e.g. '8453' Examples: 8453, 1,8453, default"},"historical_prices":{"type":"string","title":"historical_prices (optional)","description":"Optional. Comma-separated hour offsets, up to 3 values, e.g. '720,168,24' Examples: 720,168,24"}}}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"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_hReefk6k3wI7he48C-c1S","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 metadata, real-time price, supply fields, logo, and optional historical prices for an EVM ERC-20 token or native asset given its contract address and chain ID","exampleAgentPrompt":"Pull the full token info for Base USDC — contract address 0x833589fCD6EDB6E08f4c7C32D4f71b54bdA02913 on chain 8453 — including current price and historical prices at 24, 168, and 720 hours ago.","exampleUseCases":[{"title":"Portfolio value tracking across chains","prompt":"I need you to check the current prices and total supplies for the tokens I'm holding across my wallets — USDC on Base, WETH on Ethereum, and native ETH. Pull all the metadata and current market prices so I can calculate my total portfolio value."},{"title":"DeFi yield farm position monitoring","prompt":"Monitor my liquidity position in this new DeFi protocol. Look up the real-time price, market cap, and circulating supply for their governance token at contract 0x1234... on Arbitrum, then compare it to the prices from 7 and 30 days ago to see if it's trending up or down."},{"title":"Swapping tokens with price confidence","prompt":"Before I execute a trade, pull the current market price and 24-hour historical prices for both USDC on Polygon and this new ERC-20 token I'm about to swap into — I want to make sure I understand the price movement before committing."}],"resultDescription":"Returns a JSON object with token metadata (name, symbol, decimals, logo), real-time price, market cap, circulating and total supply, and optionally price snapshots at requested historical hour offsets.","failureModes":["Invalid or unrecognized contract address returns 404 or empty result","Missing required chain_ids parameter causes a 400 validation error","Token not indexed on the specified chain returns empty or null data","Historical price offsets exceeding allowed count (>3) may be rejected","Rate limiting or payment failure returns 402 Payment Required"],"whenToPreferThis":"Use this endpoint when you need comprehensive token metadata — name, symbol, decimals, logo, real-time price, supply figures, and optional historical prices — for a specific ERC-20 contract address or native asset on an EVM chain. Prefer this over the CoinGecko-ID price endpoint when you have a contract address rather than a CoinGecko ID or symbol, or when you need richer metadata beyond just price.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T13:07:01.367Z","isFirstParty":false}