1gateway
Use when an agent needs what a Base address holds in one call instead of one RPC call per token. Input: address; optional tokens (up to 20 ERC-20 addresses, comma-separated; default USDC, EURC, USDbC, WETH, cbBTC, cbETH, wstETH). Output: JSON block+time, ETH balance, per-token symbol, decimals, raw and decimal balance, nonce, isContract. Chain state only, no prices. Bad input: 400, not charged. Example: ?address=0x6246eee0355Dd7A93C888fE59e1151388A0cC5a1
Offering
- Provider
- 1gateway.dev
- Method
- GET
- Offering type
- Api Endpoint
- Transport type
- http
- Category
- Blockchain And Crypto
- Delivery
- Not provided
- Pricing model
- Not provided
- x402 version
- 2
Endpoint context
- URL
https://1gateway.dev/v1/onchain/base/balances- MIME type
- application/json
- First seen
- 2026-10-16T01:50:32.458Z
- Last seen
- Tags
- Base, wallet-balance, ERC20, Onchain, Portfolio
Payment pricing
x402 payment terms are the authoritative price for calling this endpoint.
- Payment option 1
- 0.002 USDC
Atomic price: 2000 · Network: eip155:8453 · Asset: USDC · Scheme: exact - Payment option 2
- 0.002 USDC
Atomic price: 2000 · Network: solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp · Asset: USDC · Scheme: exact
Raw x402 terms
[
{
"scheme": "exact",
"network": "eip155:8453",
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"amount": "2000",
"payTo": "0x6246eee0355Dd7A93C888fE59e1151388A0cC5a1"
},
{
"scheme": "exact",
"network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
"asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
"amount": "2000",
"payTo": "AwV6UZobYPyTdsuNa2NknZZrnmmUoH5ckEv3wNgL26WT"
}
]Observed health
- Status
- Healthy
- Latest latency
- 1217 ms
- Average latency
- 1229 ms
- HTTP status
- 402
- Last checked
- Reachability
- 100% over 14 checks
Latency is measured to the first response headers. A reachable result does not verify response accuracy or merchant identity.
Input schema
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "http"
},
"method": {
"type": "string",
"enum": [
"GET"
]
},
"queryParams": {
"type": "object",
"properties": {
"address": {
"type": "string",
"description": "Wallet or contract on Base mainnet (0x + 40 hex; mixed case must be a valid EIP-55 checksum). Bad input → 400 (not charged)",
"pattern": "^0x[0-9a-fA-F]{40}$",
"examples": [
"0x6246eee0355Dd7A93C888fE59e1151388A0cC5a1"
]
},
"tokens": {
"type": "string",
"description": "Up to 20 comma-separated ERC-20 contract addresses on Base. Omit for the default set. A contract that is not an ERC-20 is listed with status not_an_erc20.",
"maxLength": 900,
"examples": [
"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913,0x4200000000000000000000000000000000000006"
]
}
},
"required": [
"address"
],
"additionalProperties": false
}
},
"required": [
"type",
"method"
],
"additionalProperties": false
}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": "Wallet or contract on Base mainnet (0x + 40 hex; mixed case must be a valid EIP-55 checksum). Bad input → 400 (not charged)",
"examples": [
"0x6246eee0355Dd7A93C888fE59e1151388A0cC5a1"
],
"pattern": "^0x[0-9a-fA-F]{40}$",
"type": "string"
},
"tokens": {
"description": "Up to 20 comma-separated ERC-20 contract addresses on Base. Omit for the default set. A contract that is not an ERC-20 is listed with status not_an_erc20.",
"examples": [
"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913,0x4200000000000000000000000000000000000006"
],
"maxLength": 900,
"type": "string"
}
},
"required": [
"address"
],
"type": "object"
},
"type": {
"const": "http",
"type": "string"
}
},
"required": [
"type",
"method"
],
"type": "object"
},
"output": {
"properties": {
"example": {
"properties": {
"address": {
"type": "string"
},
"block": {
"properties": {
"number": {
"type": "integer"
},
"timestamp": {
"type": "string"
}
},
"type": "object"
},
"chain": {
"type": "string"
},
"chainId": {
"type": "integer"
},
"codeSize": {
"type": "integer"
},
"eth": {
"properties": {
"balance": {
"type": "number"
},
"wei": {
"type": "string"
}
},
"type": "object"
},
"isContract": {
"type": "boolean"
},
"nonZeroTokens": {
"type": "integer"
},
"note": {
"type": "string"
},
"rpc": {
"properties": {
"kind": {
"type": "string"
},
"source": {
"type": "string"
}
},
"type": "object"
},
"tokenSet": {
"type": "string"
},
"tokens": {
"items": {
"properties": {
"address": {
"type": "string"
},
"balance": {
"type": [
"number",
"null"
]
},
"decimals": {
"type": [
"integer",
"null"
]
},
"issuer": {
"type": [
"string",
"null"
]
},
"raw": {
"type": [
"string",
"null"
]
},
"status": {
"type": "string"
},
"symbol": {
"type": [
"string",
"null"
]
}
},
"type": "object"
},
"type": "array"
},
"transactionCount": {
"type": "integer"
}
},
"required": [
"chain",
"chainId",
"address",
"block",
"isContract",
"codeSize",
"transactionCount",
"eth",
"tokenSet",
"tokens",
"nonZeroTokens",
"rpc",
"note"
],
"type": "object"
},
"type": {
"type": "string"
}
},
"required": [
"type"
],
"type": "object"
}
},
"required": [
"input"
],
"type": "object"
}