Connect to Sui via Vezgo API

Data mapping

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

How to read a transaction

Sui groups activity into transaction blocks, each identified by a digest. Vezgo emits one transaction per block: read the per-coin movements from parts[] and the gas from fees[]:

• Coin movements — parts[] holds one entry per balance change owned by the connected address (direction sent/received, ticker, amount, fiat_value). provider_ticker on each part is the full Sui coin type, so a part identifies its coin unambiguously even when two coins share a ticker.
• A block that moves several coins — a swap, or a transfer that also pays gas — produces one transaction with several parts, not several transactions.
• Top-level amount and symbol describe the native SUI position only: symbol is always SUI and quantity is the absolute net SUI change for the block. Per-coin detail lives in parts[].
• Direction — misc.origin_type is always transfer; the transaction's own type is derived from the net SUI change (deposit when it increased, withdrawal when it decreased, unknown when SUI did not move, e.g. a pure token transfer). Read parts[].direction for what actually moved.
• Gas — fees[] in SUI, computed as computation + storage − storage rebate, so a heavily-rebated block can report a zero fee. The digest is in transaction_hash and misc.origin_id.

// One Vezgo transaction = one Sui transaction block (tx.misc.origin_id = digest)
const digest = tx.misc.origin_id;      // == tx.transaction_hash
const kind   = tx.misc.origin_type;    // always "transfer" on Sui

const moves = tx.parts ?? [];          // one entry per coin movement for this address
const gas   = tx.fees?.[0];            // gas in SUI (computation + storage − rebate)

// Identify a coin by its Move type, not its ticker:
const byType = moves.map((p) => [p.provider_ticker, p.amount]);
// e.g. ["0x2::sui::SUI", "1.5"]

// tx.type reflects the net SUI change only — read parts[].direction per coin.
// Sui has no tokenTransfers / nftTransfers / internalTransfers arrays.