Buyer account
GET https://aispotmarket.com/buy/api/v1/account
Returns the ledger position for the authenticated buyer.
Auth: Authorization: Bearer <buyer_key>.
Response
| field | type | meaning |
|---|---|---|
buyer_id | UUID | Stable buyer account id |
balance_units | integer | Total settlement units on the account |
pending_units | integer | Units reserved by prepared or active inference allocations |
available_units | integer | Units available for a new order or inference request |
These fields are scale-8 integer accounting units, not decimal-string market
prices: 100000000 represents 1.0 account unit. The response never returns a
funding credential or an account secret.
curl -s https://aispotmarket.com/buy/api/v1/account \
-H "Authorization: Bearer $SPOT_API_KEY"
The Gateway has no public funding endpoint. Account credits are an operator action, while the standalone Ledger funding routes remain on a private network.
Errors
401 unauthorized means the bearer key is absent or unknown. A temporary
Market or persistence failure returns 503; retry that response with backoff.