Get User Orders

Retrieve all orders placed by a specific user

GET /orderbooks/stocks/api/users/{userAddress}/orders

curl -X GET "https://api.trusset.org/orderbooks/stocks/api/users/0x1111111111111111111111111111111111111111/orders?status=OPEN&limit=20" \
  -H "x-api-key: trusset_{instanceRef}_{secret}"

{
  "success": true,
  "data": [
    {
      "id": "ord_xyz789",
      "orderBookId": "ob_abc123",
      "side": "BUY",
      "orderType": "LIMIT",
      "price": "100000000000000000000",
      "quantity": "5000000000000000000",
      "filledQuantity": "0",
      "status": "OPEN",
      "createdAt": "2025-01-15T10:30:00.000Z"
    }
  ],
  "metadata": {
    "requestId": "550e8400-e29b-41d4-a716-446655440000",
    "timestamp": "2025-01-15T10:35:00.000Z",
    "instanceId": "inst_abc"
  }
}

Returns a paginated list of orders placed by the specified user across all on-chain order books in the instance.

Authentication

Requires an instance API key with the trading service enabled.

Path Parameters

userAddress · string · required

EVM address of the user. Must match 0x[a-fA-F0-9]{40}.

Query Parameters

status · string

Filter by order status (e.g. OPEN, FILLED, CANCELLED, PARTIALLY_FILLED).

limit · integer

Number of results to return. Default 50, maximum 100.

offset · integer

Offset for pagination. Default 0.

curl -X GET "https://api.trusset.org/orderbooks/stocks/api/users/0x1111111111111111111111111111111111111111/orders?status=OPEN&limit=20" \
  -H "x-api-key: trusset_{instanceRef}_{secret}"

{
  "success": true,
  "data": [
    {
      "id": "ord_xyz789",
      "orderBookId": "ob_abc123",
      "side": "BUY",
      "orderType": "LIMIT",
      "price": "100000000000000000000",
      "quantity": "5000000000000000000",
      "filledQuantity": "0",
      "status": "OPEN",
      "createdAt": "2025-01-15T10:30:00.000Z"
    }
  ],
  "metadata": {
    "requestId": "550e8400-e29b-41d4-a716-446655440000",
    "timestamp": "2025-01-15T10:35:00.000Z",
    "instanceId": "inst_abc"
  }
}