Documentation v1 · UPDATED 21 AUG 2026
Get an API key
On this page

Buyer account

GET https://aispotmarket.com/buy/api/v1/account

Returns the ledger position for the authenticated buyer.

Auth: Authorization: Bearer <buyer_key>.

Response

fieldtypemeaning
buyer_idUUIDStable buyer account id
balance_unitsintegerTotal settlement units on the account
pending_unitsintegerUnits reserved by prepared or active inference allocations
available_unitsintegerUnits 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.