{"slug":"1gateway-dev-v1-onchain-base-token-info-793ffc","title":"Use when an agent needs an ERC-20's basics on Base before quoting, transferring ","host":"1gateway.dev","method":"GET","resource":"https://1gateway.dev/v1/onchain/base/token-info","category":"market","description":"Use when an agent needs an ERC-20's basics on Base before quoting, transferring or approving it. Input: address (token contract); optional holder (adds balance and share of supply) and spender (adds allowance, flags unlimited approvals). Output: JSON block+time, name, symbol, decimals, totalSupply r","price_listed":0.002,"price_asked":0.002,"state":"answering","state_label":"Answering","checks_7d":1,"answered_7d":1,"latency_ms_median":32,"reported_calls_30d":3,"reported_payers_30d":2,"networks":["eip155:8453"],"badge":"unverified","paid_checks_7d":0,"paid_ok_7d":0,"example_input":{"method":"GET","queryParams":{"address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","holder":"0x6246eee0355Dd7A93C888fE59e1151388A0cC5a1","spender":"0x000000000022D473030F116dDEE9F6B43aC78BA3"},"type":"http"},"output_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"additionalProperties":false,"properties":{"method":{"enum":["GET"],"type":"string"},"queryParams":{"additionalProperties":false,"properties":{"address":{"description":"ERC-20 token contract on Base mainnet (0x + 40 hex; mixed case must be a valid EIP-55 checksum). EOA → 400, non-ERC-20 contract → 422 (not charged)","examples":["0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"],"pattern":"^0x[0-9a-fA-F]{40}$","type":"string"},"holder":{"description":"Optional address whose token balance and share of total supply to include","examples":["0x6246eee0355Dd7A93C888fE59e1151388A0cC5a1"],"pattern":"^0x[0-9a-fA-F]{40}$","type":"string"},"spender":{"description":"Optional spender; with holder, adds allowance(holder, spender). Needs holder.","examples":["0x000000000022D473030F116dDEE9F6B43aC78BA3"],"pattern":"^0x[0-9a-fA-F]{40}$","type":"string"}},"required":["address"],"type":"object"},"type":{"const":"http","type":"string"}},"required":["type","method"],"type":"object"},"output":{"properties":{"example":{"properties":{"address":{"type":"string"},"allowance":{"properties":{"amount":{"type":"integer"},"owner":{"type":"string"},"raw":{"type":"string"},"spender":{"type":"string"},"unlimited":{"type":"boolean"}},"type":["object","null"]},"block":{"properties":{"number":{"type":"integer"},"timestamp":{"type":"string"}},"type":"object"},"chain":{"type":"string"},"chainId":{"type":"integer"},"codeSize":{"type":"integer"},"decimals":{"type":"integer"},"holder":{"properties":{"address":{"type":"string"},"balance":{"type":"number"},"pctOfSupply":{"type":["number","null"]},"raw":{"type":"string"}},"type":["object","null"]},"knownIssuer":{"properties":{"issuer":{"type":"string"},"note":{"type":"string"}},"type":["object","null"]},"name":{"type":["string","null"]},"note":{"type":"string"},"rpc":{"properties":{"kind":{"type":"string"},"source":{"type":"string"}},"type":"object"},"symbol":{"type":["string","null"]},"totalSupply":{"properties":{"amount":{"type":"number"},"raw":{"type":"string"}},"type":"object"}},"required":["chain","chainId","address","block","name","symbol","decimals","totalSupply","codeSize","knownIssuer","holder","allowance","rpc","note"],"type":"object"},"type":{"type":"string"}},"required":["type"],"type":"object"}},"required":["input"],"type":"object"},"history":[{"day":"2026-10-18","reachable":true,"status":402,"valid_402":true,"asked_usdc":0.002,"price_match":true,"latency_ms":32,"error":null}],"description_full":"Use when an agent needs an ERC-20's basics on Base before quoting, transferring or approving it. Input: address (token contract); optional holder (adds balance and share of supply) and spender (adds allowance, flags unlimited approvals). Output: JSON block+time, name, symbol, decimals, totalSupply raw and decimal, known issuer if curated. Name/symbol are self-reported. EOA or non-ERC-20: 4xx, not charged. Example: ?address=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","last_updated":"2026-10-15T09:01:05.346Z","schemes":["exact"]}