{"uid":"cap_dZ4GhIvS290e9LPFF-PWW","slug":"logicnodes-aptos-balance-lookup-8bd9cbd7","name":"LogicNodes Aptos Balance Lookup","description":"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.","url":"https://logicnodes.io/paid/v1/tools/aptos_balance_get?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"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)"}}},"responseSchema":{"type":"json","example":{"ok":true,"tool":"aptos_balance_get"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_QGYsL_DlcJPQNIzR123n2","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches token balances for one or more assets on an Aptos wallet address at a specific ledger version","exampleAgentPrompt":"What are the current APT and USDC balances for Aptos mainnet address 0xabcdef1234567890 — give me the exact figures pinned to the latest ledger version?","exampleUseCases":[{"title":"Pre-transaction balance verification","prompt":"Before I send 50 APT from my Aptos wallet 0xabcdef1234567890, can you check my exact APT balance on Aptos mainnet right now so I know the transfer will go through?"},{"title":"Multi-asset portfolio snapshot","prompt":"Pull the balances for APT, USDC, and USDT on Aptos mainnet for address 0x9876543210fedcba — I want to see all three holdings at once."},{"title":"Historical balance audit at ledger version","prompt":"What was the APT balance on Aptos mainnet for address 0xdeadbeef12345678 at ledger version 450000000? I need the exact figure as of that specific point in time."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-28T06:43:01.089Z","isFirstParty":false,"canonicalSlug":"logicnodes-aptos-balance-lookup-8bd9cbd7"}