# TON Address Balance Lookup

> TON Address Balance Lookup is a paid API for AI agents from api.vextorium.com, paid per call via x402, $0.004/call, status unknown (last checked 2026-10-11).

Returns the full balance snapshot of a TON blockchain address: native TON amount, account status, linked .ton domain, and all held jetton tokens (with name, symbol, amount, and scam flag).

## Facts

- Endpoint: POST https://api.vextorium.com/v1/ton-balance?utm_source=zero.xyz
- Price: $0.004/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/ton-address-balance-lookup-1234fa3d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_x0eJ9Axtdwx-jJCm41vEe

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 ton-address-balance-lookup-1234fa3d -d '<json body>'
```

Example prompt: What's the current TON balance and all jetton holdings for the wallet EQDtFpEwcFAEcRe5mLVh2N6C0x-_hJEM7W61_JLnSF74p4q2? I also want to know its .ton domain, account status, and whether any of the tokens are flagged as scams.

## When to prefer this

Use this endpoint when you need a complete, live snapshot of a TON blockchain wallet — native balance plus all jetton holdings in one call. Prefer it over manual on-chain queries or block explorer scraping when you need structured data including scam flags and .ton domain resolution. Ideal for agents managing TON payments, auditing wallets before transactions, or displaying portfolio views for TON ecosystem users.

## Known failure modes

- Invalid or malformed TON address format returns an error — address must be EQ.../UQ... or 0:hex
- Address exists on-chain but has no jettons — jettons array will be empty or null
- Public TON node (toncenter) downtime may cause timeouts or stale data
- Newly created or never-funded addresses may return null balances or 'uninitialized' status
- Scam flag data may not cover all tokens — unflagged does not guarantee legitimacy

## How this service works

Balance of a TON address: native TON, account status, .ton domain and its jettons (USDT, NOT, DOGS...) with name, symbol, amount and scam flag. Live from a public TON node.

## Output

A JSON object containing: normalized TON address, native TON balance as a number, account status string (e.g. 'active'), associated .ton domain if any, data source (toncenter public node), a TonViewer explorer URL, and an array of jettons each with contract address, name, symbol, numeric amount, and a boolean scam flag.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "required": [
      "address"
     ],
     "properties": {
      "address": {
       "type": "string",
       "description": "TON address (EQ.../UQ... or 0:hex)"
      }
     }
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": [
      "object",
      "null"
     ],
     "properties": {
      "ton": {
       "type": [
        "number",
        "null"
       ]
      },
      "domain": {
       "type": [
        "string",
        "null"
       ]
      },
      "source": {
       "type": [
        "string",
        "null"
       ]
      },
      "status": {
       "type": [
        "string",
        "null"
       ]
      },
      "address": {
       "type": [
        "string",
        "null"
       ]
      },
      "jettons": {
       "type": [
        "array",
        "null"
       ],
       "items": {
        "type": [
         "null",
         "object"
        ],
        "properties": {
         "name": {
          "type": [
           "null",
           "string"
          ]
         },
         "amount": {
          "type": [
           "null",
           "number"
          ]
         },
         "jetton": {
          "type": [
           "null",
           "string"
          ]
         },
         "symbol": {
          "type": [
           "null",
           "string"
          ]
         },
         "flagged_as_scam": {
          "type": [
           "boolean",
           "null"
          ]
         }
        }
       }
      },
      "explorer": {
       "type": [
        "string",
        "null"
       ]
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ton": 1249207215.716609,
  "domain": "crypto-flipper.ton",
  "source": "toncenter (public TON node)",
  "status": "active",
  "address": "EQDtFpEwcFAEcRe5mLVh2N6C0x-_hJEM7W61_JLnSF74p4q2",
  "jettons": [
   {
    "name": "MELLSTROY",
    "amount": 1000,
    "jetton": "0:08D67D08037FB1DCE0B3F29101B03AC08A48A23164AD764331F22B40DD64930A",
    "symbol": "MEL",
    "flagged_as_scam": false
   },
   {
    "name": "OG TON BOSS",
    "amount": 100000,
    "jetton": "0:72479CABD7EE2BE116D529518332F6ABC42F82CAD9CE1B4737A52BEB646C772D",
    "symbol": "GRACHEV",
    "flagged_as_scam": false
   }
  ],
  "explorer": "https://tonviewer.com/EQDtFpEwcFAEcRe5mLVh2N6C0x-_hJEM7W61_JLnSF74p4q2"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/ton-address-balance-lookup-1234fa3d/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.vextorium.com](https://www.zero.xyz/host/api.vextorium.com/llms.txt)