Wallet balances

Read wallets, token holdings, and transaction history through the authenticated user's portfolio in the Platform API. Use platform user authentication.

List wallets

query WalletBalances($limit: Int = 100) {
  user {
    id
    portfolioDashboard {
      id
      wallets(limit: $limit) {
        id
        digitalWalletId
        label
        usdValue
        nativeDepositAddress
        assets {
          id
          symbol
          value
          usdValue
        }
      }
    }
  }
}

usdValue is the dollar valuation. Keep asset quantities separate from dollar valuations.

Wallet details

Read holdings and transaction history for one wallet:

query WalletDetail($walletId: String!, $limit: Int = 50, $offset: Int = 0) {
  user {
    id
    portfolioDashboard {
      id
      wallet(id: $walletId) {
        id
        digitalWalletId
        label
        usdValue
        assets {
          id
          symbol
          value
          usdValue
        }
        transactions(limit: $limit, offset: $offset) {
          id
          transactionId
          createdAt
          confirmedAt
          status
          type
          coin
          size
          from
          to
        }
      }
    }
  }
}

{
  "walletId": "42",
  "limit": 50,
  "offset": 0
}

Use the wallet ID returned by the wallet list or wallet creation. The value and size fields are strings; their amount units depend on the asset and wallet provider.

Transaction history

Paginate transaction history with limit and offset. History availability depends on the wallet provider. Refetch wallet details after a transfer or swap changes status.

For sending tokens, see Transfers and swaps.