Skip to main content
Use the balances command to list monetary accounts, inspect one balance by ID, create balances on a ledger, and link balances to identities. Balances hold currency positions and appear as sources or destinations on transactions.
CommandAliasDescription
listlBrowse balances in a table; add --id for one record
createcOpen a balance on a ledger via interactive prompts
updateuLink an existing balance to an identity

​
list

Browse balances across your ledgers in a paginated table with amounts, credit/debit totals, and inflight columns. Use --{field} filters (for example --currency) to narrow results before you fetch one record with list --id. 
blnk balances list [options]
Options
OptionTypeDefaultDescription
--{field}string—Filter by any indexed field (for example --currency "USD,EUR").
-p, --pageinteger1Page number.
--per-pageinteger10Results per page.
-h, --helpboolean—Show help for this command.
Usage
1

List all balances

Run the command to view a paginated table of balances:
blnk balances list
Filter and paginate:
blnk balances list --page 2 --per-page 3
blnk balances list --currency "USD,EUR" --indicator World
200 Success
┌────────────────   ────────   ─────────   ───────   ───────   ───────   ────────   ────────   ────────   ───────────────────────────┐
│ Balance ID       │ Currency │ Indicator │ Balance │ Credit  │ Debit   │ Inflight │ Infl. Dr │ Infl. Cr │ Created At                  │
| ---------------- | -------- | --------- | ------- | ------- | ------- | -------- | -------- | -------- | --------------------------- |
│ bln_01dab2b7...  │ USDC     │ N/A       │       0 │       0 │       0 │        0 │        0 │        0 │ 2026-06-03T12:37:50.156041Z │
│ bln_964c5fbc...  │ EUR      │ N/A       │       0 │       0 │       0 │        0 │        0 │        0 │ 2026-06-03T12:37:16.100793Z │
│ bln_d98d6524...  │ USDC     │ @Artur    │  124000 │  124000 │       0 │        0 │        0 │        0 │ 2026-06-03T12:34:52.961135Z │
└────────────────   ────────   ─────────   ───────   ───────   ───────   ────────   ────────   ────────   ───────────────────────────┘
54 results found
Page 1/18

​
list --id

Look up one balance by balance_id and print a readable summary of ledger link, identity, and balance breakdowns. Pass --json when you need the full API object for scripts or support tickets. 
blnk balances list --id <balance-id> [options]
Options
OptionTypeRequiredDescription
--idstringYesBalance ID to fetch (for example bln_01dab2b7-3ec7-4253-b302-edd947423883).
--jsonbooleanNoPrint the full API object as JSON instead of a formatted summary.
-h, --helpbooleanNoShow help for this command.
Usage
1

Get one balance

Run the command with a balance ID:
blnk balances list --id bln_01dab2b7-3ec7-4253-b302-edd947423883

Balance details:
  balance_id: bln_01dab2b7-3ec7-4253-b302-edd947423883
  ledger_id: ldg_feb41a88-02e0-46b1-813d-e60aba7fe0aa
  identity_id: idt_fa2e58ba-9826-4614-9ba2-02b62df8c4d0
  currency: USDC
  balance: 0
  debit_balance: 0
  credit_balance: 0
  inflight_balance: 0
  inflight_debit_balance: 0
  inflight_credit_balance: 0
  created_at: 2026-06-03T12:37:50Z

​
create

Open a new balance on a ledger through prompts for currency, ledger ID, and optional identity. Every balance belongs to exactly one ledger; you can link an identity now or later with update. 
blnk balances create [options]
Arguments
ArgumentTypeRequiredDescription
currencystringYesBalance currency. Prompt: currency >
ledger_idstringYesLedger ID for the balance. Prompt: ledger id >
identity_idstringNoOptional identity to link. Prompt: identity id >. Press Enter to skip.
meta_dataobjectNoOptional metadata as JSON. Prompt: metadata (json) >. Press Enter to skip.
Options
OptionTypeDescription
--jsonbooleanAfter a successful create, print the full API response as JSON.
-h, --helpbooleanShow help for this command.
Usage
1

Create new balance

Run the command:
blnk balances create
The CLI prompts for each argument:
currency >
ledger id >
identity id >
metadata (json) >
Press Enter at optional prompts to skip.
2

Balance created

Balance created:
  balance_id: bln_abc123
  ledger_id: ldg_abc123
  identity_id: N/A
  currency: USD
  created_at: 2026-05-23T17:07:49Z

​
update

Attach an identity to a balance that was created without one (or change the linked identity). Pass the balance ID on the command line; the CLI prompts for the identity_id to store on the record. 
blnk balances update <balance-id> [options]
Arguments
ArgumentTypeRequiredDescription
balance-idstringYesBalance ID to update (for example bln_01dab2b7-3ec7-4253-b302-edd947423883). Passed on the command line.
identity_idstringYesIdentity ID to link.
Options
OptionTypeDescription
-h, --helpbooleanShow help for this command.
Usage
1

Link balance to identity

Run the command with a balance ID:
blnk balances update bln_01dab2b7-3ec7-4253-b302-edd947423883
The CLI prompts for the identity to link:
identity id >
2

Balance updated

200 Success
Balance identity updated:
  balance_id: bln_01dab2b7-3ec7-4253-b302-edd947423883
  ledger_id: ldg_feb41a88-02e0-46b1-813d-e60aba7fe0aa
  identity_id: idt_fa2e58ba-9826-4614-9ba2-02b62df8c4d0
  currency: USDC
  created_at: 2026-06-03T12:37:50Z