# TON Address Transaction History

> TON Address Transaction History 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-19).

Fetches the latest transactions for a TON blockchain address, including timestamps, fees, amounts sent/received, counterparties, and message comments, enabling payment confirmation from Telegram wallets.

## Facts

- Endpoint: POST https://api.vextorium.com/v1/ton-transactions?utm_source=zero.xyz
- Price: $0.004/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-19
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/ton-address-transaction-history-8780e9cd
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_b_eyY3Xuw8yDIn00lZYS4

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-transaction-history-8780e9cd -d '<json body>'
```

Example prompt: Can you check the last 10 transactions for TON address EQDtFpEwcFAEcRe5mLVh2N6C0x-_hJEM7W61_JLnSF74p4q2 and tell me if any of them have the comment 'order-789' and how much TON was received?

## When to prefer this

Use this endpoint when you need to verify or audit TON blockchain payments, especially those originating from Telegram wallets. It is the right choice when you need message comments/memos to match payments to orders, need fee breakdowns, or need to identify counterparty addresses on the TON network specifically — as opposed to Ethereum or other EVM-compatible chains.

## Known failure modes

- Invalid or malformed TON address returns an error or empty transaction list
- Address with no transaction history returns an empty transactions array
- Limit value outside 1-50 range may be rejected or clamped
- toncenter public node downtime causes service unavailability
- Very new addresses may not yet have indexed transactions

## How this service works

558 pay-per-call data APIs for AI agents: Solana and EVM on-chain data, tokenized stocks, DeFi, Hyperliquid, economy and official statistics, FX, validation, web and developer tools. Pay in USDC via x402.

## Output

Returns a JSON object containing the queried TON address, the data source (toncenter public node), and an array of transactions each with: ISO 8601 timestamp, transaction hash, sender address, array of recipient addresses, TON amount received, TON amount sent, fee in TON, optional message comment/memo, and a boolean 'correct' field indicating transaction validity.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "integer",
   "description": "1-50 (default 10)"
  },
  "address": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "source": "toncenter (public TON node)",
  "address": "EQDtFpEwcFAEcRe5mLVh2N6C0x-_hJEM7W61_JLnSF74p4q2",
  "transactions": [
   {
    "a": [
     "0:AFDF163C8AE1A5176944D82DAD952477A084BD8F1B6A2263B5396BC587A4FDE4"
    ],
    "date": "2026-10-02T07:18:16+00:00",
    "from": "0:AFDF163C8AE1A5176944D82DAD952477A084BD8F1B6A2263B5396BC587A4FDE4",
    "hash": "n8hlmIpHy4Ccb6EGtfzAlgKfwIqiTt9hUCjLWmsVhak=",
    "comment": "reward from Arnold investment",
    "correct": false,
    "fee_ton": 0.000151291,
    "sent_ton": 0.006448198,
    "received_ton": 0.006643333
   },
   {
    "a": [],
    "date": "2026-10-02T04:03:38+00:00",
    "from": "0:A93019107DF084DA7E0FA50D3D716654DD2E5E2F9D609391F2C0902A18D112EC",
    "hash": "Y90FQRdnKAx3ybhEl6rIezwSD6P9kBRUQx+X8yFY2q0=",
    "comment": null,
    "correct": false,
    "fee_ton": 0.000101276,
    "sent_ton": 0,
    "received_ton": 0.0001
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/ton-address-transaction-history-8780e9cd/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)
