API endpoints
Balances API
Balance і journal endpoints повертають ledger-backed projections для рахунку або гаманця. Використовуйте їх для продуктових балансів і звірки, а не обчислюйте стан лише з WebSocket-подій.
Операції
| Method | Path | Scope | Опис |
|---|---|---|---|
GET | /api/v1/ledger/accounts/{accountId}/balances | wallets:read | Баланси рахунку за мережею та активом |
GET | /api/v1/wallets/{walletId}/balances | wallets:read | Баланси гаманця |
GET | /api/v1/wallets/{walletId}/ledger-entries | wallets:read | Записи операційного журналу гаманця |
Поля балансу рахунку
| Поле | Значення |
|---|---|
postedBalance | Проведений обліковий баланс в atomic units |
reservedBalance | Сума, зарезервована незавершеними операціями |
availableBalance | Сума, доступна після резервувань |
*Display | Людиночитне значення з урахуванням decimals активу |
decimals | Кількість десяткових знаків, якщо відома |
displaySource | asset_config або atomic |
Зберігайте atomic values як strings. Не обробляйте їх через floating-point types.
Фільтри
Account balances приймають cursor, limit, chain та asset. Wallet balances приймають cursor, limit і asset.
Записи журналу гаманця можна фільтрувати за transactionId, status, direction, entryType, asset, createdFrom і createdTo, додатково до cursor pagination.
Правило звірки
Використовуйте події як сигнал оновити стан, а потім читайте баланси, транзакції й записи журналу через REST. Зберігайте отримані identifiers і timestamps, щоб простежити кожне переміщення від початку до кінця.