Connect to TRON via Vezgo API

Accounts

Positions

Transactions

Support for Accounts, Positions and Transactions enabled.

This provider retrieves:

  • Balances
  • Positions
  • Transactions (Native & TRC-20 transactions supported)

Full List of Integrations

Data mapping

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

DataWhere to read itSource on TRON
Account & walletaccount.wallets[].addressThe connected TRON account address (base58, starting with "T"). One address is one account; wallet.address is the stable identity reused across syncs and reconnects.
Balances / positionsaccount.balances[]Native TRX plus every TRC-10 and TRC-20 token the account holds, from the live on-chain snapshot. Each balance has ticker, amount and fiat_value (USD). Staked TRX is reported separately with asset_type "staked".
TransactionsGET /accounts/:id/transactionsTRX transfers and TRC-20 token transfers, one Vezgo transaction per on-chain transaction. See "How to read a transaction" below.
Assets / securitiesbalance.ticker · misc.tokenIdNative TRX uses ticker TRX. Token tickers come from the token's own on-chain registration and are not unique — TRC-10 tokens in particular can publish any symbol — so identify a token by its contract address, which transactions carry in misc.tokenId.

How to read a transaction

Each on-chain transaction maps to a single Vezgo transaction with one part. 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). Native transfers use ticker "TRX"; token transfers use the token's ticker.
  • TRC-20 transfers — misc.trc20 is true and misc.tokenId holds the token contract address. from_address and to_address are the actual counterparties, not the contract.
  • Staked TRX — freezing TRX for bandwidth or energy moves it out of the spendable balance and into the staked position; the staked balance covers Stake 2.0 freezes, legacy freezes and expired unstakes not yet withdrawn.
  • Network fee — fees[] (always TRX), charged to the sender. A transaction covered entirely by free bandwidth reports a zero fee.
  • misc.origin_type is the direction from the account's perspective (IN / OUT), and misc.possible_spam is set on transactions TRON's explorer flags as risky — unsolicited dust and lookalike-token airdrops are common on TRON.
// One Vezgo transaction = one on-chain transaction (tx.misc.origin_id = hash)
const hash = tx.misc.origin_id;        // == tx.transaction_hash
const kind = tx.misc.origin_type;      // "IN" | "OUT"

const move = tx.parts?.[0];            // value movement (TRX or a token)
const fee  = tx.fees?.[0];             // network fee, always in TRX (sender only)

if (tx.misc.trc20) {
  const contract = tx.misc.tokenId;    // TRC-20 contract — the token's real identity
}
if (tx.misc.possible_spam) { /* explorer-flagged; consider hiding by default */ }
// TRON has no tokenTransfers / nftTransfers / internalTransfers arrays.
Where to read itAttributesWhat it is
tx.parts[0]direction, ticker, amount, fiat_value, from_address, to_addressThe value movement. On a TRC-20 transfer the addresses are the counterparties; the token itself is in misc.tokenId.
tx.fees[0]ticker ("TRX"), amount, fiat_valueNetwork fee — always TRX, and only the sender is charged.
tx.miscorigin_id, origin_type, trc20, tokenId, possible_spamtrc20 and tokenId are present on token transfers; possible_spam on explorer-flagged transactions.

misc.origin_type is the movement direction from the account's perspective:

  • IN
  • OUT

Supported

  • Native TRX balances and transfers
  • TRC-10 and TRC-20 token balances and transfers
  • Staked TRX, reported as a separate staked position
  • Network fees (reported in TRX)
  • Spam detection on explorer-flagged transactions
  • USD fiat valuation for balances and transactions

Notes & limitations

  • Identify tokens by the contract address in misc.tokenId, not by ticker — TRON token symbols are self-declared and duplicates are common.
  • Native TRX and staked TRX share ticker "TRX" — tell them apart via asset_type ("staked"), not ticker.
  • Only the sender is charged the network fee (TRX); incoming transactions carry no fee even though the counterparty paid one.
See the full Vezgo object reference

Try to connect to TRON in our Demo Sandbox

Open Demo

Let's get you started

To get your API Keys, sign up on the portal or reach out to the team at sales@vezgo.com

You have questions? Contact us