> ## Documentation Index
> Fetch the complete documentation index at: https://docs.trusset.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Get User Orders

> Retrieve all orders placed by a specific user

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

<ParamField path="userAddress" type="string" required>
  EVM address of the user. Must match `0x[a-fA-F0-9]{40}`.
</ParamField>

## Query Parameters

<ParamField query="status" type="string">
  Filter by order status (e.g. `OPEN`, `FILLED`, `CANCELLED`, `PARTIALLY_FILLED`).
</ParamField>

<ParamField query="limit" type="integer">
  Number of results to return. Default `50`, maximum `100`.
</ParamField>

<ParamField query="offset" type="integer">
  Offset for pagination. Default `0`.
</ParamField>

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

<ResponseExample>
  ```json theme={null}
  {
    "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"
    }
  }
  ```
</ResponseExample>