# gate402 On-Chain Wallet & Token Intelligence

> gate402 On-Chain Wallet & Token Intelligence is a paid API for AI agents from gate402.app, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-12).

Returns native ETH + ERC-20 balances, EOA/contract classification, transaction count, and token metadata for any Base address, sourced from the public RPC.

## Facts

- Endpoint: POST https://gate402.app/v1/onchain?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/gate402-on-chain-wallet-token-intelligence-0105eac7
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_2U8B6YYf2g5JJjX9-KI8z

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability gate402-on-chain-wallet-token-intelligence-0105eac7 -d '<json body>'
```

Example prompt: Check the on-chain wallet profile for 0x4838B106FCe9647Bdf1E7877BF73cE8B0BAD5f97 on Base — I need its native ETH balance, any ERC-20 holdings, whether it's a contract or regular wallet, and the transaction count. Also check balances for these extra tokens: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 and 0x50c5725949A6F0c72E6C4a641F24049A917DB0Cb.

## When to prefer this

Choose this endpoint when you need a comprehensive on-chain profile of a Base address in a single call — combining native balance, multi-token ERC-20 balances, EOA/contract classification, and transaction count without querying the RPC directly. It is ideal for wallet due diligence, agent-driven portfolio monitoring, or pre-trade address validation on Base, and is preferable to DEX price endpoints when you need raw wallet state rather than market data.

## Known failure modes

- Invalid or malformed 0x address returns a validation error
- Non-Base address (e.g. Ethereum mainnet address not deployed on Base) may return zero balances without error
- Unknown or non-standard ERC-20 contract addresses in the tokens array may fail metadata lookup
- RPC congestion or downtime can cause timeouts or partial results
- Very new addresses with no history may return empty balances and zero tx count, which may look like an error but is valid

## How this service works

On-chain wallet & token intelligence on Base: native + ERC-20 balances, EOA/contract detection, tx count, and token metadata. From public RPC.

## Output

Returns a JSON object containing the address's native ETH balance, a list of ERC-20 token balances (including symbol, decimals, and raw/formatted amounts) for standard tokens plus any extras supplied, a boolean or type flag indicating EOA vs contract, the total transaction count, and token-level metadata sourced directly from the Base public RPC.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "tokens": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "description": "Optional extra ERC-20 contract addresses to check balances for."
  },
  "address": {
   "type": "string",
   "description": "Base address (wallet or token contract), 0x-hex."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/gate402-on-chain-wallet-token-intelligence-0105eac7/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from gate402.app](https://www.zero.xyz/host/gate402.app/llms.txt)