Accounts

The Accounts domain covers the ledger side of your integration — the balances your participants and platform hold at zerohash, and the record of every movement in and out of them. An account is a single balance of a single asset for a single owner, with a type (such as available, payable, or receivable) that describes the role it plays in settlement. These endpoints are how you read those balances, trace their history, and monitor settlement obligations programmatically.

For engineers, this domain is where you reconcile. Every trade, deposit, withdrawal and settlement ultimately lands as a balance change on an account, and these endpoints let you observe that state from your own systems — listing accounts, drilling into a specific one, walking its ledger movement by movement, and surfacing any outstanding settlement obligations across your platform.

Listing and reading accounts

Use the list endpoint to enumerate the accounts under your platform. Each record includes the account's balance in the respective asset, and each account_label maintains an individual balance;

📘

The list accounts endpoint only returns accounts with a non-zero balance. An account that has been created but currently holds nothing won't appear in the list response.
If you're expecting an account that isn't showing up, an empty balance is the most likely reason — query it directly by account_id to confirm it exists and read its current state.

Outstanding NDOs

A Net Debit Obligation (NDO) is created on your primary account when settlement can't be fully covered — for example, when trading activity has occurred on the float account and the primary account is underfunded at settlement.

This domain includes an endpoint to retrieve all accounts with outstanding NDOs under your platform, so you can monitor settlement exposure across your book in one call and top up funding where it's needed.