{"uid":"cap_Lmp8YzL_Epu0LoeiJgEgN","slug":"agenticfi-token-info-7a209404","name":"AgenticFi Token Info","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/%7Baddress%7D?utm_source=zero.xyz","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":{"request":{"input":{"type":"http","method":"GET","pathParams":{"address":"0x833589fCD6EDB6E08f4c7C32D4f71b54bdA02913"},"queryParams":{"address":"0x833589fCD6EDB6E08f4c7C32D4f71b54bdA02913","chain_ids":"8453"}}},"response":{"source":"sim","tokens":[{"logo":"https://api.sim.dune.com/beta/token/logo/8453/0x833589fcd6edb6e08f4c7c32d4f71b54bda02913","name":"USD Coin","chain":"base","symbol":"USDC","chain_id":8453,"decimals":6,"price_usd":1.0001573383783602,"total_supply":"4248525732905324","fully_diluted_value":4249194189.0545607}],"warnings":[],"next_offset":null,"request_time":null,"response_time":null,"contract_address":"0x833589fCD6EDB6E08f4c7C32D4f71b54bdA02913"}},"exampleRequest":{"address":"0x833589fCD6EDB6E08f4c7C32D4f71b54bdA02913","chain_ids":"8453"},"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_fa6y2PkORQ_7OmjtVWSOT","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":"Retrieves detailed metadata and pricing information for an ERC-20 token or native asset by contract address on a specified chain","exampleAgentPrompt":"Look up the token info for 0x833589fCD6EDB6E08f4c7C32D4f71b54bdA02913 on Base (chain ID 8453) and include historical prices for the last 24, 168, and 720 hours.","exampleUseCases":null,"resultDescription":"Returns structured token metadata including name, symbol, decimals, current price, and optionally historical prices at specified hour offsets for the given ERC-20 contract address on the requested chain","failureModes":["Invalid or non-existent contract address returns 404 or empty result","Missing required address or chain_ids parameters returns 400 validation error","Unsupported chain ID returns an error or empty data","Payment failure via x402 returns 402 Payment Required","Rate limiting or service unavailability returns 5xx error","Malformed address format (not valid checksummed hex) may return error or no result"],"whenToPreferThis":"Use this endpoint when you need detailed metadata (name, symbol, decimals) and current or historical pricing for a specific ERC-20 token or native asset by contract address on an EVM-compatible chain. Prefer this over general search endpoints when you already have the contract address. Ideal for DeFi agents needing token context before executing swaps or portfolio analysis.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-21T18:30:04.223Z","isFirstParty":false,"canonicalSlug":"agenticfi-token-info-7a209404"}