Connect to Algorand via Vezgo API

Data mapping

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

How to read a transaction

Each value movement touching the connected account maps to a single Vezgo transaction. Read the movement from parts[0] and the network fee from fees[]:

• Value movement — parts[0] (direction sent/received, ticker, amount, fiat_value, from_address, to_address). ALGO uses ticker "ALGO"; ASAs use their unit name.
• Multi-movement transactions — an application (smart-contract) call that moves several assets for the account, or a payment combined with an account close-out, produces one Vezgo transaction per movement. They share the same on-chain transaction id prefix in misc.origin_id (suffixed per inner movement) and the network fee is attached to the first one only.
• Account close-outs — the remainder sent when an account is closed arrives as a normal received payment at the destination.
• Fee-only transactions — an application call with no value movement for the account still costs a fee; it appears as a transaction with a zero-amount ALGO part and the fee in fees[].
• Network fee — fees[] (always ALGO). Only the sender pays a fee on Algorand; incoming transactions carry no fee even though the counterparty paid one.
• The on-chain transaction id is in misc.origin_id; misc.origin_type is the movement direction (deposit / withdrawal / fee).

// One Vezgo transaction = one value movement for the account
const id   = tx.misc.origin_id;        // on-chain txn id (suffixed per inner movement for multi-leg calls)
const kind = tx.misc.origin_type;      // deposit | withdrawal | fee

const move = tx.parts?.[0];            // value movement (ticker "ALGO" or the ASA unit name)
const gas  = tx.fees?.[0];             // network fee, always in ALGO (sender only)

if (move.amount === "0" && gas) { /* fee-only app call — nothing moved, fee still spent */ }
// Algorand has no tokenTransfers / nftTransfers / internalTransfers arrays.