BBaalvion Help

Orders & Trades API

Create, read, and update orders — the core trade record on the platform.

Endpoints

MethodPathDescription
GET/v1/ordersList orders visible to the authenticated account.
POST/v1/ordersCreate an order (buyer accounts).
GET/v1/orders/:idGet a single order by ID.
PATCH/v1/orders/:idUpdate an order’s status (seller and agent accounts).

The Order Object

Order object
{
  "id": "ord_51c9a2",
  "status": "pending",
  "buyerId": "usr_8f2a1c",
  "sellerId": "usr_3d7b90",
  "agentId": null,
  "listingId": "lst_1a4f22",
  "quantity": 500,
  "createdAt": "2026-02-01T11:00:00Z",
  "updatedAt": "2026-02-01T11:00:00Z"
}

status is one of pending, confirmed, fulfilling, completed, or cancelled, mirroring the lifecycle described in How the Platform Works.

Create an Order

Request
curl -X POST https://api.baalvion.com/v1/orders \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "listingId": "lst_1a4f22",
    "quantity": 500
  }'
Buyer accounts only
Order creation requires an API key belonging to a buyer account — the same permission boundary as placing an order from the dashboard.

Update Order Status

Request
curl -X PATCH https://api.baalvion.com/v1/orders/ord_51c9a2 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "status": "fulfilling" }'
PreviousUsers APINextListings API