Connect to Gram (Toncoin) via Vezgo API

Data mapping

A field-level guide to the Vezgo API data for Gram (Toncoin) — what each attribute means and where to read it — so you can map it into your own system.

How to read a transaction

TON transactions are built from messages: an incoming message credits the account, outgoing messages debit it. Vezgo emits one transaction per on-chain transaction — read the movement from parts[0] and the fee from fees[]:

• Value movement — parts[0] (direction sent/received, ticker, amount, fiat_value, from_address, to_address). The ticker is always "TON": the amount is the TON carried by the message, taken from the first outgoing message when the account sent, or from the incoming message when it received.
• Jetton transfers — a jetton moves via a message that also carries TON for gas, so the transaction appears here as its TON leg, with misc.op_name naming the operation (for example jetton_transfer). The jetton amount itself is not in the transaction feed; read jetton holdings from account.balances[].
• Transactions with several outgoing messages (batch sends) are represented by their first outgoing message.
• Network fee — fees[] (always TON), taken from the transaction's total fees.
• misc.aborted marks a transaction that failed on-chain — it still consumed a fee, and the description carries an "(aborted)" suffix. misc.origin_type is TON's own transaction type.

// One Vezgo transaction = one on-chain TON transaction
const hash = tx.misc.origin_id;        // == tx.transaction_hash
const kind = tx.misc.origin_type;      // TON transaction type, commonly "TransOrd"

const move = tx.parts?.[0];            // always ticker "TON"
const fee  = tx.fees?.[0];             // total fees, in TON

if (tx.misc.op_name === "jetton_transfer") {
  // A jetton moved. The TON here is the gas that carried it — the jetton
  // amount is not in this feed; reconcile jettons from account.balances[].
}
if (tx.misc.aborted) { /* failed on-chain; the fee was still paid */ }
// TON has no tokenTransfers / nftTransfers / internalTransfers arrays.