# LogicNodes Aptos Balance Lookup

> LogicNodes Aptos Balance Lookup is a paid API for AI agents from logicnodes.io, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-28).

Fetches token balances for one or more assets on an Aptos wallet address at a specific ledger version

## Facts

- Endpoint: POST https://logicnodes.io/paid/v1/tools/aptos_balance_get?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-28
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/logicnodes-aptos-balance-lookup-8bd9cbd7
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_dZ4GhIvS290e9LPFF-PWW

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 logicnodes-aptos-balance-lookup-8bd9cbd7 -d '<json body>'
```

Example prompt: What are the current APT and USDC balances for Aptos mainnet address 0xabcdef1234567890 — give me the exact figures pinned to the latest ledger version?

## When to prefer this

Choose this endpoint when you need exact, deterministic Aptos token balances — especially when historical accuracy at a specific ledger version matters, or when checking multiple assets in a single call. Prefer this over generic blockchain explorers when you need machine-readable output for agent workflows, DeFi logic, or pre-transaction validation on Aptos mainnet or testnet.

## Known failure modes

- Invalid or malformed Aptos wallet address returns an error
- Unsupported asset type or unknown token identifier causes failure
- Ledger version out of range or not yet available returns an error
- Chain ID other than aptos:1 or aptos:2 is rejected
- Exceeding 20 assets in a single request returns a validation error
- Network or node unavailability may cause timeout

## How this service works

Exact answers for AI agents: 40+ tools for EVM chains and Aptos, gas on 14 chains, never a guess. Free tier; pay per call in USDC (x402) on 13 networks.

## Output

Returns a JSON object with ok: true, the tool name, and the requested token balances for each asset specified, pinned to the requested ledger version (or current if not specified). Includes exact on-chain balance figures for each asset at the given Aptos address.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "chain": {
   "type": "string",
   "description": "Aptos CAIP-2 id: aptos:1 (mainnet, default) or aptos:2 (testnet)"
  },
  "assets": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "maxItems": 20,
   "minItems": 1
  },
  "address": {
   "type": "string"
  },
  "ledgerVersion": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "integer",
     "maximum": 9007199254740991,
     "minimum": 0
    }
   ],
   "description": "read the chain exactly as of this ledger version (default: the current one, pinned for consistency)"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "tool": "aptos_balance_get"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/logicnodes-aptos-balance-lookup-8bd9cbd7/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from logicnodes.io](https://www.zero.xyz/host/logicnodes.io/llms.txt)