{"uid":"cap_-Kwh_POeodS5MDPdsPWKT","slug":"agents-allium-so-4e926391","name":"Allium Token Lookup by Chain and Address","description":"Look up tokens by chain and address","url":"https://agents.allium.so/api/v1/developer/tokens/chain-address","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","bodyType","body","method"],"properties":{"body":{"type":"object","required":["token_address","chain"],"properties":{"chain":{"type":"string","description":"Blockchain network (e.g. ethereum, solana, base)"},"token_address":{"type":"string","description":"Token contract address"}}},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":[{"info":{"name":"Wrapped Ether","symbol":"WETH"},"type":"evm_erc20","chain":"ethereum","price":2500.5,"object":"token","address":"0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2","decimals":18}]},"example":{"request":[{"chain":"ethereum","token_address":"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"}],"response":[{"info":{"name":"USD Coin","symbol":"USDC"},"chain":"ethereum","price":0.9976293442460975,"object":"token","address":"0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48","decimals":6,"attributes":{"all_time_low":0.2906942278341328,"total_supply":54580615599.69135,"all_time_high":1.27317375791263,"holders_count":7454135,"price_diff_1d":-0.0014390562949837538,"price_diff_1h":-0.003589367163403301,"volume_usd_1d":672622058.1227494,"volume_usd_1h":14034028.943696665,"trade_count_1d":97050,"trade_count_1h":3977,"price_diff_pct_1d":-0.1440398169138751,"price_diff_pct_1h":-0.3584998085333666,"token_creation_time":"2018-08-03T19:28:24Z","fully_diluted_valuation_usd":54451223749.2684}}]},"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_1s8tiIxOLwapzHDpiXjNR","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Look up token metadata and details for a specific token by its blockchain network and contract address","exampleAgentPrompt":"What token is deployed at contract address 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 on Ethereum? I need the name, symbol, and decimals.","exampleUseCases":null,"resultDescription":"Returns token metadata for the specified contract address on the given chain, including token name, symbol, decimals, and other identifying information about the token contract.","failureModes":["Token contract address not found on specified chain — returns empty or null result","Invalid chain identifier — returns error indicating unsupported or unrecognized chain","Malformed contract address — returns validation error","Contract exists but is not a recognized token standard — may return partial or no metadata","Rate limit or payment failure — returns 402 or 429 error"],"whenToPreferThis":"Use this endpoint when you have a specific token contract address and need to resolve its metadata (name, symbol, decimals) on a particular blockchain. Prefer this over the name/symbol search endpoint when you already know the exact contract address and want precise, unambiguous token identification rather than a fuzzy name search.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:49:27.811Z","isFirstParty":false}