# EVM Native Coin Balance Lookup

> EVM Native Coin Balance Lookup is a paid API for AI agents from twin.unykorn.org, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-29).

Returns the native coin balance (ETH, MATIC, BNB, etc.) for a given wallet address on any of ten supported EVM-compatible blockchains.

## Facts

- Endpoint: POST https://twin.unykorn.org/evm-native-balance?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/evm-native-coin-balance-lookup-43fc7693
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_4IyyFS2IfONJ50bqv8RQg

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 evm-native-coin-balance-lookup-43fc7693 -d '<json body>'
```

Example prompt: What's the current ETH balance for wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 on Ethereum mainnet?

## When to prefer this

Choose this endpoint when you need a fast, pay-per-call native coin balance lookup across any of ten major EVM chains (Ethereum, Base, Polygon, Arbitrum, Optimism, BSC, Avalanche, Gnosis, Linea, Scroll) without setting up your own RPC infrastructure. It is ideal for agents that need on-demand, cross-chain balance checks with built-in micropayment billing via x402 and no API key management.

## Known failure modes

- Invalid or malformed Ethereum address (not matching 0x + 40 hex chars) returns an error
- Unsupported chain name outside the ten allowed enum values causes rejection
- Invalid block identifier results in lookup failure
- Payment failure via x402 protocol prevents the call from completing
- Network timeout or RPC failure on the target chain returns no balance data

## How this service works

Native coin balance for one address, on any of ten EVM chains — Genesis402 / UnyKorn Operator Network

## Output

Returns a JSON object with a boolean ok flag, the balance type identifier ('evm-native-balance'), and a receipt object containing the transaction hash, USD amount paid for the call, and a unique receipt ID, along with an ISO8601 timestamp of when the balance was generated.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "params": {
   "type": "object",
   "properties": {
    "block": {
     "type": "string"
    },
    "chain": {
     "enum": [
      "ethereum",
      "base",
      "polygon",
      "arbitrum",
      "optimism",
      "bsc",
      "avalanche",
      "gnosis",
      "linea",
      "scroll"
     ],
     "type": "string"
    },
    "address": {
     "type": "string",
     "pattern": "^0x[0-9a-fA-F]{40}$"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "type": "evm-native-balance",
  "receipt": {
   "tx_hash": "0x<64hex>",
   "amount_usd": 0.25,
   "receipt_id": "g402-<16hex>"
  },
  "generated_at": "<iso8601>"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/evm-native-coin-balance-lookup-43fc7693/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from twin.unykorn.org](https://www.zero.xyz/host/twin.unykorn.org/llms.txt)