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

# List orders

> Get a paginated list of your orders

## Authentication

Read authentication required — `X-Public-Key` header.

## Query parameters

<ParamField query="side" type="string">
  Filter by side: `BUY` or `SELL`.
</ParamField>

<ParamField query="status" type="string">
  Filter by status: `open`, `filled`, `partial_filled`, `cancelled`, `expired`, `rejected`.
</ParamField>

<ParamField query="eventId" type="string">
  Filter by event UUID.
</ParamField>

<ParamField query="marketId" type="string">
  Filter by market UUID.
</ParamField>

<ParamField query="outcomeId" type="string">
  Filter by outcome UUID.
</ParamField>

<ParamField query="currency" type="string">
  Filter by currency: `USD` or `NGN`.
</ParamField>

<ParamField query="page" type="integer" default="1">
  Page number.
</ParamField>

<ParamField query="size" type="integer" default="20">
  Results per page.
</ParamField>

## Example request

<CodeGroup>
  ```bash cURL theme={null}
  curl "https://relay.bayse.markets/v1/pm/orders?status=open&page=1&size=20" \
    -H "X-Public-Key: pk_live_abcdef123456"
  ```

  ```javascript Node.js theme={null}
  const response = await fetch(
    'https://relay.bayse.markets/v1/pm/orders?status=open',
    { headers: { 'X-Public-Key': 'pk_live_abcdef123456' } }
  );
  const data = await response.json();
  ```

  ```python Python theme={null}
  import requests

  resp = requests.get(
      'https://relay.bayse.markets/v1/pm/orders',
      params={'status': 'open', 'page': 1, 'size': 20},
      headers={'X-Public-Key': 'pk_live_abcdef123456'},
  )
  data = resp.json()
  ```

  ```go Go theme={null}
  req, _ := http.NewRequest("GET", "https://relay.bayse.markets/v1/pm/orders", nil)
  q := req.URL.Query()
  q.Add("status", "open")
  req.URL.RawQuery = q.Encode()
  req.Header.Set("X-Public-Key", "pk_live_abcdef123456")
  resp, _ := http.DefaultClient.Do(req)
  ```
</CodeGroup>

## Response

Returns a paginated list of orders. Each order has the same shape as the response from [Place order](/api-reference/pm/place-order) — either an AMM order or a CLOB order depending on the market.

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "orders": [
      {
        "id": "f6a7b8c9-d0e1-2345-fabc-678901234567",
        "marketId": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
        "outcome": "YES",
        "side": "BUY",
        "orderType": "LIMIT",
        "stpMode": "SKIP",
        "status": "open",
        "amount": 100,
        "price": 0.70,
        "size": 100,
        "filledSize": 0,
        "remainingSize": 100,
        "currency": "USD",
        "createdAt": "2026-02-17T12:00:00Z",
        "updatedAt": "2026-02-17T12:00:00Z"
      }
    ],
    "pagination": {
      "page": 1,
      "size": 20,
      "lastPage": 1,
      "totalCount": 1
    }
  }
  ```
</ResponseExample>