Skip to main content
GET
/
data
/
orders
List open orders
curl --request GET \
  --url https://clob.forka.st/data/orders \
  --header 'FORKAST_ADDRESS: <forkast_address>' \
  --header 'FORKAST_API_KEY: <forkast_api_key>' \
  --header 'FORKAST_PASSPHRASE: <forkast_passphrase>' \
  --header 'FORKAST_SIGNATURE: <forkast_signature>' \
  --header 'FORKAST_TIMESTAMP: <forkast_timestamp>'
[
  {
    "associateTrades": [
      "01J96PK41JQ8X7A5N4W3V2Y1Z0"
    ],
    "id": "01J9R1Z4Q6YKQ4JE2T6V9N7A8B",
    "status": "live",
    "market": "0x9febb3d92e347a0990353d363df23878",
    "originalSize": "250.000000",
    "outcome": "0x34b62d0ca7bf5d069a0f3c8ec7d8f9a1",
    "makerAddress": "0x3C44CdDdB6a900fa2b585dd299e03d12FA4293BC",
    "owner": "01J8ZK6QP5DHBFR0J2TXGZ82C0",
    "price": "0.450000",
    "side": "BUY",
    "sizeMatched": "75.000000",
    "assetId": "0x34b62d0ca7bf5d069a0f3c8ec7d8f9a1",
    "expiration": "0",
    "type": "GTC",
    "createdAt": "2024-09-16T13:02:44.581Z",
    "updatedAt": "2024-09-16T13:37:11.902Z"
  },
  {
    "associateTrades": [],
    "id": "01J9R22X3KM8P6L4H2F0C9V7B5",
    "status": "live",
    "market": "0x9febb3d92e347a0990353d363df23878",
    "originalSize": "180.000000",
    "outcome": "0x98e77b2c1d4f56a7890ab1234cde5678",
    "makerAddress": "0x5F0a0C7bF5E40C26504f71679a72E68d93F5F1E2",
    "owner": "01J8ZK6QP5DHBFR0J2TXGZ82C0",
    "price": "0.532500",
    "side": "SELL",
    "sizeMatched": "0.000000",
    "assetId": "0x98e77b2c1d4f56a7890ab1234cde5678",
    "expiration": "1729219200",
    "type": "GTD",
    "createdAt": "2024-09-16T14:08:13.047Z",
    "updatedAt": "2024-09-16T14:08:13.047Z"
  }
]
Retrieve the active (live) orders owned by the authenticated L2 credentials.
Send the L2 headers: FORKAST_ADDRESS, FORKAST_SIGNATURE, FORKAST_TIMESTAMP, FORKAST_API_KEY, and FORKAST_PASSPHRASE. The response only includes orders linked to that credential set.

​
Query parameters

ParameterTypeRequiredDescription
idstringNoOrder ULID to fetch (case-insensitive).
marketstringNoConditionID to filter on.
asset_idstringNoToken/asset ID to filter on.
Omit parameters you do not need; empty strings are ignored. If the combination is invalid the endpoint returns 400 invalid_filter.

​
Response

The endpoint returns an array of open orders. Each object matches the structure documented for GET /data/order/{id}, with status fixed to live.

Headers

​
FORKAST_ADDRESS
string
required

Wallet address associated with the L2 credentials.

​
FORKAST_SIGNATURE
string
required

EIP-712 signature authorizing the request.

​
FORKAST_TIMESTAMP
string
required

Unix timestamp (seconds) matching the signed payload.

​
FORKAST_API_KEY
string
required

API key identifier issued via L2 credential flow.

​
FORKAST_PASSPHRASE
string
required

64-character passphrase paired with the API key.

Query Parameters

​
id
string

Order ULID to fetch (case-insensitive).

​
market
string

ConditionID (market) to filter on.

​
asset_id
string

Token/asset ID to filter on.

Response

Open orders matching the supplied filters.

​
associateTrades
string[]
required

Trade identifiers linked to this order.

Example:
[
  "01K8KR41HR1HWZ2KCNRG73Z8HX",
  "01K8KRBH4RY62PHKGXQRJA4CE1"
]
​
id
string
required

ULID assigned to the order.

Example:

"01L0XY0R3M8FGP3A5X4KJ8BPAG"

​
status
enum<string>
required

Lifecycle status of the order (live, matched, delayed, or unmatched). Only live orders appear in the open orders feed.

Available options:
live,
matched,
delayed,
unmatched
Example:

"live"

​
market
string
required

Market identifier associated with the order.

Example:

"0xf15d606b67011df3589a141a2deecc705ce8c4ce06754db4c4d7ef71f6232789"

​
originalSize
string
required

Requested size when the order was submitted.

Example:

"173.000000"

​
outcome
string
required

Outcome identifier for the market.

Example:

"0xf15d606b67011df3589a141a2deecc705ce8c4ce06754db4c4d7ef71f6232789:1"

​
makerAddress
string
required

Address that funded the maker side.

Example:

"0xAaAaAaAaAaAaAaAaAaAaAaAaAaAaAaAaAaAaAaAa"

​
owner
string | null
required

Identifier of the account that owns the order (ULID).

Example:

"5f0c1f74-0c0e-4dc4-9d3f-5b0c8c2f6c62"

​
price
string | null
required

Limit price with fixed precision.

Example:

"0.548800"

​
side
enum<string>
required

Side of the market.

Available options:
BUY,
SELL
Example:

"BUY"

​
sizeMatched
string
required

Total quantity matched so far.

Example:

"87.535014"

​
assetId
string
required

Token identifier for the traded outcome.

Example:

"0xf15d606b67011df3589a141a2deecc705ce8c4ce06754db4c4d7ef71f6232789:1"

​
expiration
string
required

Expiration timestamp in Unix seconds ("0" when not set).

Example:

"1767225599"

​
type
enum<string>
required

Order execution policy.

Available options:
FOK,
FAK,
GTC,
GTD
Example:

"GTC"

​
createdAt
string
required

ISO-8601 timestamp for order creation.

Example:

"2025-10-27T21:14:12.123456Z"

​
updatedAt
string
required

ISO-8601 timestamp for the latest update.

Example:

"2025-10-27T21:15:00.654321Z"