Skip to main content
PUT
/
ncw
/
wallets
/
{walletId}
/
accounts
/
{accountId}
/
assets
/
{assetId}
/
balance
TypeScript
const response: Promise<FireblocksResponse<EmbeddedWalletAssetBalance>> = fireblocks.embeddedWallets.refreshEmbeddedWalletAssetBalance(embeddedWalletsApiRefreshEmbeddedWalletAssetBalanceRequest);
{
  "id": "BTC-mainnet-acc-01",
  "total": "0.87500000",
  "available": "0.84500000",
  "pending": "0.01500000",
  "frozen": "0.00500000",
  "lockedAmount": "0.01000000",
  "blockHeight": "8459341",
  "blockHash": "0000000000000000000769e73a0b8f32a6c5d55e0d64f9ec20c6c3d4e5a9a3f1",
  "rewardInfo": {
    "pendingRewards": "5"
  }
}

Headers

​
Idempotency-Key
string

A unique identifier for the request. If the request is sent multiple times with the same idempotency key, the server will return the same response as the first request. The idempotency key is valid for 24 hours.

Path Parameters

​
walletId
string
required

Wallet Id

​
accountId
string
required

The ID of the account

​
assetId
string
required

The ID of the asset

Response

Successful response

​
id
string
required

Unique identifier of the asset balance entry

Example:

"BTC-mainnet-acc-01"

​
total
string
required

Total balance amount for the asset in the account (including pending, locked, and available)

Example:

"0.87500000"

​
available
string
required

The balance available for use or withdrawal

Example:

"0.84500000"

​
pending
string
required

Amount pending confirmation from blockchain (e.g., unconfirmed deposits)

Example:

"0.01500000"

​
frozen
string
required

Balance that is frozen due to policy or regulatory lock

Example:

"0.00500000"

​
lockedAmount
string
required

Funds locked for operations such as staking or delegation

Example:

"0.01000000"

​
blockHeight
string

Latest known blockchain height when balance was fetched

Example:

"8459341"

​
blockHash
string

Hash of the blockchain block associated with the current balance state

Example:

"0000000000000000000769e73a0b8f32a6c5d55e0d64f9ec20c6c3d4e5a9a3f1"

​
rewardInfo
object