Use when an agent needs an ERC-20's basics on Base before quoting, transferring
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
Paid test badge: not yet. The checks above are free: we call the tool without paying and read the payment request it sends back. The Verified badge needs paid calls whose answers match the promised output, and nobody can buy a badge.
Endpoint
GET https://1gateway.dev/v1/onchain/base/token-info
| Category | Market data |
|---|---|
| Provider host | 1gateway.dev |
| Networks | eip155:8453 |
| Payment schemes | exact |
| Self-reported calls, 30 days | 3 from 2 payers (the provider's figure, not ours) |
Our checks, last 30 days
| Day | Result | HTTP | Asked | Time |
|---|---|---|---|---|
| 2026-10-18 | valid payment request | 402 | $0.002 | 32 ms |
Example input (from the provider)
{
"method": "GET",
"queryParams": {
"address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"holder": "0x6246eee0355Dd7A93C888fE59e1151388A0cC5a1",
"spender": "0x000000000022D473030F116dDEE9F6B43aC78BA3"
},
"type": "http"
}
Promised output schema (from the provider)
{
"$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 \u2192 400, non-ERC-20 contract \u2192 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"
}