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

Trade history

Every matching path writes the same durable execution tape. Rows include trade_id, ask_id, bid_id, buyer/seller ids, model_id, region, taker_side, exact price, token quantity, and executed_at.

Buyer history

GET /v1/trades

Auth: buyer Bearer key.

Cursor-paginated and searchable with q, model_id, region, from, to, cursor, and limit (maximum 100).

curl -s 'http://127.0.0.1:8080/v1/trades?model_id=gpt-4&region=us-east' \
  -H "Authorization: Bearer sk-buyer"

Seller history

GET https://aispotmarket.com/sell/api/v1/trades

Auth: X-Seller-API-Key. The focused Seller API returns the latest 100 seller fills for the credential owner. Advanced Market clients can use the compatibility read GET /v1/sellers/{id}/trades beneath the /market/api base. The authenticated Trade application uses the same complete tape with cursor pagination.

curl -s https://aispotmarket.com/sell/api/v1/trades \
  -H "X-Seller-API-Key: $SPOT_SELLER_KEY"