System accounts
Total balance across a system account's shards
The total across every shard of a system account, summed under a lock so the figure is a real instant rather than a drifting scan.
GET
/v1/ledgers/{ledgerId}/system-accounts/balanceThe total across every shard of a system account, summed under a lock so the figure is a real instant rather than a drifting scan. Read this, not an individual shard, whenever the question is how much the system holds.
Authorization
bearerAuth AuthorizationBearer <token>
In: header
Path Parameters
ledgerId*string
Format
uuidQuery Parameters
owner_type*string
purpose*string
commodity*string
Response Body
application/json
application/problem+json
curl -X GET "https://example.com/v1/ledgers/497f6eca-6276-4993-bfeb-53cbbbba6f08/system-accounts/balance?owner_type=string&purpose=string&commodity=string"{ "balance": 0}One shard of a system account; random, or stable per seed
Returns one shard of a system account. Without seed the shard is chosen at random, which is what a fresh posting wants.
Post one balanced transaction
Posts one balanced transaction: legs in integer minor units that sum to zero per commodity, or nothing is written at all.