Skip to main content
Reconcile balances and transactions through the v2 API with GET /v2/wallets and GET /v2/transactions. Sensitive operations, such as role changes and IP allowlist edits, don’t have a reporting API yet, so report on them from the web dashboard.

​
Reconcile balances

GET /v2/wallets lists every wallet your API key can read, across all vaults, with a balance for each asset the wallet holds. To read a single wallet, use GET /v2/wallets/{walletId}. Both need the Read vault activity permission. Each balance is an object with quantity, currentPrice, and currentUSDValue: Don’t expect the other balances to sum to totalBalance. Whether staked or unbonding funds are folded into totalBalance depends on the network. Narrow the list with assetType, networkId, subaccountIds, and filterByIsArchived. Pass minUsdValue=0 to skip wallets that hold nothing. Set limit to return up to 100 wallets per page (default 25), and follow page.next for the next page. See Pagination. GET /v2/wallets returns balances as of the request and has no date parameter. To keep a balance history, store each response, or download daily balance reports from the web dashboard’s Reporting section. For what each dashboard balance label means, see Reading balances.

​
Reconcile transactions

GET /v2/transactions lists transactions across the vaults your API key can read, and needs the Read vault activity permission. Use these filters to scope a reconciliation run: Pagination works the same way as GET /v2/wallets. To fetch one record, use GET /v2/transactions/{transactionId}. amount.quantity and fee.quantity are signed relative to the wallet the record belongs to. Deposits are positive. Withdrawals, outgoing transfers, and fees are negative. Sum them as returned, without flipping signs by transactionType, to reproduce a wallet’s balance over a period. The price and USD values on a transaction are recent but not real-time. For status lifecycles, webhooks, and telling internal deposits from external ones, see Track movement status.

​
Report on sensitive operations

Report on approvals, access, and security settings from the web dashboard:
  • Operations lists pending and past operations across your organization. Filter by type, date range, or status, then download the results.
  • Roles exports each user’s roles and permissions when you select Download structure.
  • The IP allowlist audit log records every allowlist change, with who made it and when.
  • Reporting holds monthly statements and balance and transaction reports, which you can download or schedule.

​
Audit trail API

Audit trail via API describes GET /v2/audit-events, a feed of audit events such as sign-ins, approvals, and exports, built for SIEM ingestion. It’s in development, so use the web dashboard reports above until it’s generally available.