Get Orders

Get Orders

curl --request GET \
  --url https://api.example.com/data/orders

{
  "data": [
    {
      "data[].id": "<string>",
      "data[].status": "<string>",
      "data[].market": "<string>",
      "data[].original_size": "<string>",
      "data[].outcome": "<string>",
      "data[].maker_address": "<string>",
      "data[].owner": "<string>",
      "data[].price": "<string>",
      "data[].side": "<string>",
      "data[].size_matched": "<string>",
      "data[].asset_id": "<string>",
      "data[].expiration": "<string>",
      "data[].type": "<string>",
      "data[].created_at": "<string>",
      "data[].updated_at": "<string>"
    }
  ],
  "next_cursor": "<string>",
  "id": "<string>",
  "side": "<string>",
  "type": "<string>",
  "status": "<string>",
  "price": 123,
  "maker_amount": 123,
  "taker_amount": 123,
  "size_matched": 123,
  "created_at": "<string>",
  "expiration": {},
  "outcome": {
    "outcome.index": 123,
    "outcome.text": "<string>"
  },
  "market": {
    "market.condition_id": "<string>",
    "market.title": "<string>",
    "market.slug": "<string>",
    "market.is_active": true,
    "market.is_resolved": true,
    "market.icon_url": "<string>",
    "market.event_slug": "<string>",
    "market.event_title": "<string>"
  }
}

GET

data

orders

Get Orders

curl --request GET \
  --url https://api.example.com/data/orders

{
  "data": [
    {
      "data[].id": "<string>",
      "data[].status": "<string>",
      "data[].market": "<string>",
      "data[].original_size": "<string>",
      "data[].outcome": "<string>",
      "data[].maker_address": "<string>",
      "data[].owner": "<string>",
      "data[].price": "<string>",
      "data[].side": "<string>",
      "data[].size_matched": "<string>",
      "data[].asset_id": "<string>",
      "data[].expiration": "<string>",
      "data[].type": "<string>",
      "data[].created_at": "<string>",
      "data[].updated_at": "<string>"
    }
  ],
  "next_cursor": "<string>",
  "id": "<string>",
  "side": "<string>",
  "type": "<string>",
  "status": "<string>",
  "price": 123,
  "maker_amount": 123,
  "taker_amount": 123,
  "size_matched": 123,
  "created_at": "<string>",
  "expiration": {},
  "outcome": {
    "outcome.index": 123,
    "outcome.text": "<string>"
  },
  "market": {
    "market.condition_id": "<string>",
    "market.title": "<string>",
    "market.slug": "<string>",
    "market.is_active": true,
    "market.is_resolved": true,
    "market.icon_url": "<string>",
    "market.event_slug": "<string>",
    "market.event_title": "<string>"
  }
}

Overview

The Get Orders endpoint returns a paginated list of the user’s open orders across all markets or filtered by specific criteria. This includes active limit orders and partially filled orders.

Authentication

This endpoint requires CLOB authentication with HMAC signature verification. Required Headers:

KUEST_ADDRESS - User’s wallet address
KUEST_API_KEY - API key from trading auth credentials
KUEST_PASSPHRASE - Passphrase from trading auth credentials
KUEST_TIMESTAMP - Current Unix timestamp (seconds)
KUEST_SIGNATURE - HMAC signature of the request
Accept: application/json

Query Parameters

maker

string

Filter orders by maker address (typically the proxy wallet address)

string

Filter to a specific order ID

market

string

Filter orders by market condition ID

asset_id

string

Filter orders by outcome token ID

next_cursor

string

Pagination cursor from previous response (base64 encoded)

Response

data

array

Array of open order objects

data[].id

string

Unique order identifier

data[].status

string

Order status: live, partially_filled, pending

data[].market

string

Market condition ID

data[].original_size

string

Original order size in decimal format

data[].outcome

string

Outcome identifier (optional)

data[].maker_address

string

Maker’s address (proxy wallet)

data[].owner

string

Owner API key

data[].price

string

Order price (decimal between 0 and 1)

data[].side

string

Order side: BUY or SELL

data[].size_matched

string

Amount already filled (decimal format)

data[].asset_id

string

Outcome token ID

data[].expiration

string

Expiration timestamp in seconds (“0” for no expiration)

data[].type

string

Order type: GTC, GTD, FOK, FAK

data[].created_at

string

ISO 8601 timestamp when order was created

data[].updated_at

string

ISO 8601 timestamp when order was last updated

next_cursor

string

Pagination cursor for next page. Returns LTE= when no more results.

Normalized Order Response

The API wrapper normalizes CLOB orders into a user-friendly format:

string

Order ID

side

string

buy or sell (lowercase)

type

string

Order type: GTC, GTD, FOK, FAK

status

string

Order status (e.g., live)

price

number

Order price between 0 and 1

maker_amount

number

Maker amount in micro units

taker_amount

number

Taker amount in micro units

size_matched

number

Filled amount in micro units

created_at

string

ISO 8601 creation timestamp

expiration

number | null

Unix timestamp or null if no expiration

outcome

object

Outcome information

outcome.index

number

Outcome index (0 or 1)

outcome.text

string

Outcome label (e.g., “Yes”, “No”)

market

object

Market metadata

market.condition_id

string

Market condition ID

market.title

string

Market title

market.slug

string

Market URL slug

market.is_active

boolean

Whether market is active

market.is_resolved

boolean

Whether market is resolved

market.icon_url

string

Market icon URL (optional)

market.event_slug

string

Parent event slug (optional)

market.event_title

string

Parent event title (optional)

Pagination

The endpoint uses cursor-based pagination:

First request returns orders and next_cursor
Include next_cursor in subsequent requests
When next_cursor is LTE=, no more results exist
Each page returns up to 100 orders

HMAC Signature Generation

For GET requests, sign the following string:

{timestamp}{method}{path}
```bash

Where:
- `timestamp` - Unix timestamp in seconds
- `method` - `GET`
- `path` - Full path including query parameters (e.g., `/data/orders?maker=0x...`)

## Example Request

```bash cURL - All Orders
curl -X GET 'https://api.kuest.io/data/orders?maker=0xproxy...' \
  -H 'Accept: application/json' \
  -H 'KUEST_ADDRESS: 0x1234...' \
  -H 'KUEST_API_KEY: your-api-key' \
  -H 'KUEST_PASSPHRASE: your-passphrase' \
  -H 'KUEST_TIMESTAMP: 1709467200' \
  -H 'KUEST_SIGNATURE: computed-hmac-signature'
```bash

```bash cURL - Filtered by Market
curl -X GET 'https://api.kuest.io/data/orders?market=0xcondition...' \
  -H 'Accept: application/json' \
  -H 'KUEST_ADDRESS: 0x1234...' \
  -H 'KUEST_API_KEY: your-api-key' \
  -H 'KUEST_PASSPHRASE: your-passphrase' \
  -H 'KUEST_TIMESTAMP: 1709467200' \
  -H 'KUEST_SIGNATURE: computed-hmac-signature'
```bash

```bash cURL - Pagination
curl -X GET 'https://api.kuest.io/data/orders?next_cursor=eyJpZCI6MTIzfQ==' \
  -H 'Accept: application/json' \
  -H 'KUEST_ADDRESS: 0x1234...' \
  -H 'KUEST_API_KEY: your-api-key' \
  -H 'KUEST_PASSPHRASE: your-passphrase' \
  -H 'KUEST_TIMESTAMP: 1709467200' \
  -H 'KUEST_SIGNATURE: computed-hmac-signature'
```bash

## Example Response

```json
{
  "data": [
    {
      "id": "ord_abc123",
      "status": "live",
      "market": "0xcondition123...",
      "original_size": "10.5",
      "maker_address": "0xproxy...",
      "price": "0.65",
      "side": "BUY",
      "size_matched": "2.5",
      "asset_id": "123456789",
      "expiration": "0",
      "type": "GTC",
      "created_at": "2026-03-03T12:00:00Z",
      "updated_at": "2026-03-03T12:00:00Z"
    }
  ],
  "next_cursor": "LTE="
}
```bash

## Use Cases

### Monitor All Open Orders
Retrieve all orders without filters to see portfolio-wide order status.

### Track Market-Specific Orders
Filter by `market` parameter to see orders for a specific prediction market.

### Check Order Status
Use `id` parameter to get details for a specific order.

### Build Order Management UI
Combine with WebSocket subscriptions for real-time order updates.

## Performance Tips

1. **Use Filters** - Filter by market or asset_id to reduce response size
2. **Cache Results** - Orders don't change frequently, cache for 10-30 seconds
3. **Pagination** - Process pages incrementally for large order lists
4. **WebSocket** - Use WebSocket feeds for real-time updates instead of polling

## See Also

- [Place Order](/api/trading/place-order) - Submit a new order
- [Cancel Order](/api/trading/cancel-order) - Cancel an order
- [Orderbook](/api/trading/orderbook) - View market orderbook

Cancel Order

Orderbook

⌘I

Build docs developers (and LLMs) love

Get started for free Talk to us

Overview

Markets

Trading

Positions

Users

Data

Overview

Authentication

Query Parameters

Response

Normalized Order Response

HMAC Signature Generation

Build docs developers (and LLMs) love

Overview

Markets

Trading

Positions

Users

Data

​Overview

​Authentication

​Query Parameters

​Response

​Normalized Order Response

​Pagination

​HMAC Signature Generation

Build docs developers (and LLMs) love

Overview

Authentication

Query Parameters

Response

Normalized Order Response

Pagination

HMAC Signature Generation