Polynopsis

Fireblocks: balances, prefunding and reporting

By · Last updated

Fireblocks is a digital asset custody and treasury platform where cross-border payment companies hold stablecoins in their own MPC-secured vault accounts, connect exchange and fiat provider accounts, and move funds to counterparties over the Fireblocks Network. Balances are read per vault and asset through the REST API (GET /v1/vault/accounts/{vaultAccountId}/{assetId}), pushed by vault_account.asset.balance_updated webhooks and shown in the Console, and a view-only Viewer API user can monitor them without signing rights.

What Fireblocks does

Coverage

How funds are held and prefunded

How to see your Fireblocks balance

ChannelWhat it gives youSource
APIGET /v1/vault/accounts/{vaultAccountId}/{assetId} returns one vault wallet's balance for a specific asset. Admin, Non-Signing Admin, Signer, Approver, Editor and Viewer roles can call it.source
APIGET /v1/vault/accounts_paged lists vault accounts, GET /v1/vault/assets returns an asset balance summary across all or filtered vault accounts, and GET /v1/vault/assets/{assetId} returns one asset's total across all vault accounts. All three are open to the Viewer role.source
webhookvault_account.asset.balance_updated carries the full balance (total, pending, frozen, lockedAmount, staked), not a delta, plus blockHeight and blockHash when available. Fireblocks recommends matching it against transaction.status.updated before crediting deposits.source
read-only keyThe Viewer API key type is view-only and can only view transaction history, in production and sandbox. The Security Auditor type is also view-only and can view workspace elements too.source
APIGET /v1/exchange_accounts/paged lists the exchange accounts connected to the workspace, and GET /v1/fiat_accounts lists fiat accounts. Both require the Admin or Non-Signing Admin role rather than Viewer.source

Regulation

Connecting Fireblocks to Polynopsis

Polynopsis connects with a read-only Fireblocks API user (Viewer role), so it can see vault balances but cannot move funds. Polynopsis shows it next to every bank, payout partner, exchange and wallet in one live position.

Frequently asked questions

Which Fireblocks endpoint returns a vault balance?

GET /v1/vault/accounts/{vaultAccountId}/{assetId} returns total, available, pending, frozen, locked and staked amounts for one asset in one vault account.

Can I connect a monitoring tool to Fireblocks without signing rights?

Yes. Create an API user with the Viewer role. It is view-only and can call the vault account and balance endpoints.

Do Fireblocks balance webhooks send the change or the full balance?

The full balance. Each vault_account.asset.balance_updated event replaces the stored balance and includes blockHeight and blockHash when available.

Other payout partners and providers

Sources

  1. What Is Fireblocks? · Fireblocks
  2. Create Omnibus Structure · Fireblocks
  3. Supported assets overview · Fireblocks
  4. Get the asset balance for a vault account · Fireblocks
  5. Validate Balances · Fireblocks
  6. Manage users and API key types · Fireblocks
  7. Fireblocks OpenAPI specification · Fireblocks
  8. Fireblocks TrustCo · Fireblocks
  9. Fireblocks Regulated Entities · Fireblocks
  10. Fireblocks State Licenses · Fireblocks
  11. Fireblocks Launches Network for Global Stablecoin Payments (press release) · Mondo Visione

Know where all your money is.

Polynopsis gives cross-border payment teams one live position across every bank, payout partner, exchange and wallet, including money in flight, and warns before a corridor runs dry.