{"uid":"cap_x0eJ9Axtdwx-jJCm41vEe","slug":"ton-address-balance-lookup-1234fa3d","name":"TON Address Balance Lookup","description":"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.","url":"https://api.vextorium.com/v1/ton-balance?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"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"]}}}}}}},"responseSchema":{"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"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.004","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","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.004/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_UrUgEL6VDm4I0lmEAsvSH","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.004","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"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).","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Pre-transfer wallet balance check","prompt":"Before I send 500 TON to EQDtFpEwcFAEcRe5mLVh2N6C0x-_hJEM7W61_JLnSF74p4q2, can you check the current native TON balance and account status so I know it's an active wallet?"},{"title":"Jetton portfolio audit for TON wallet","prompt":"Give me a full breakdown of every jetton token held at UQBh3vNmTCR7aBe8R5QXTG5sKqNK6LoJg5M9_zBjMpXcDvMs, including the name, symbol, amount, and whether any are flagged as scams."},{"title":"Resolve .ton domain to address details","prompt":"I have the wallet address EQD2NmD_lH5f5u1Kj3KfGyTvhZSX0Eg6qp2a19QvfShUZygX — can you tell me if it has a .ton domain linked to it and what its current TON and jetton balances look like?"}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T18:52:06.478Z","isFirstParty":false,"canonicalSlug":"ton-address-balance-lookup-1234fa3d"}