Assets & Transactions

Read your off-chain balances per token and your ledger history. All endpoints require authentication.

Balance type: Everything on this page is off-chain — your app's ledger balance at Xellar, not a live blockchain read. See Understanding Balances for a simple explanation.

Off-Chain Balance Fields

Each token asset has three balance buckets:

latestBalance in transaction history is also off-chain — it is a snapshot of activeBalance after each ledger entry.

List Assets

GET /api/v1/assets

Returns off-chain balances per token.

Query Parameters

Response 200

{
  "data": {
    "items": [
      {
        "tokenCode": "USDT",
        "network": "ethereum",
        "networkType": "evm",
        "chainId": 1,
        "tokenAddress": "0x...",
        "symbol": "USDT",
        "decimals": 6,
        "pendingBalance": 0,
        "activeBalance": 100.5,
        "withholdBalance": 0
      }
    ],
    "total": 5,
    "page": 1,
    "limit": 20
  }
}

Get Asset by Token Code

GET /api/v1/assets/:tokenCode → { "data": { /* single asset */ } }

Returns off-chain balance for one token. Response fields match List Assets.

List Transaction History

GET /api/v1/transaction-histories

Returns your off-chain ledger — credits and debits that changed your balance over time.

Query Parameters

Response 200

{
  "data": {
    "items": [
      {
        "id": "txn_abc123",
        "tokenCode": "USDT",
        "network": "ethereum",
        "symbol": "USDT",
        "method": "credit",
        "transactionType": "deposit",
        "amount": 100,
        "latestBalance": 100.5,
        "referenceType": "invoice",
        "referenceId": "inv_abc123",
        "createdAt": "2026-01-01T00:00:00Z"
      }
    ],
    "total": 20,
    "page": 1,
    "limit": 20
  }
}