Skip to main content
GET
/
orders
/
{id}
Get order by id
curl --request GET \
  --url https://api.context.markets/v2/orders/{id} \
  --header 'Authorization: Bearer <token>'
{
  "marketId": "0x1111111111111111111111111111111111111111111111111111111111111111",
  "trader": "0x1111111111111111111111111111111111111111",
  "nonce": "0xabc123",
  "side": 0,
  "price": "1000000",
  "size": "1000000",
  "filledSize": "1000000",
  "remainingSize": "1000000",
  "percentFilled": 123,
  "insertedAt": "2023-11-07T05:31:56Z",
  "type": "limit",
  "status": "open",
  "voidedAt": "2023-11-07T05:31:56Z",
  "voidReason": "UNFILLED_MARKET_ORDER",
  "outcomeIndex": 123,
  "expiry": "1000000",
  "settlementVersion": 1,
  "sv2OrderKind": 0,
  "sv2TimeInForce": 0,
  "sv2MinSharesOut": "1000000",
  "sv2MaxCollateralIn": "1000000",
  "sv2MinCollateralOut": "1000000"
}

Authorizations

​
Authorization
string
header
required

API key passed as Bearer token

Path Parameters

​
id
string
required

Order id (numeric DB id, e.g. "12345") or order hash (e.g. "0x111...")

Pattern: ^(0x[a-fA-F0-9]{64}|\d+)$
Example:

"12345"

Response

Order

​
marketId
string
required

32-byte hex hash

Pattern: ^0x[a-fA-F0-9]{64}$
Example:

"0x1111111111111111111111111111111111111111111111111111111111111111"

​
trader
string
required

EVM address

Pattern: ^0x[a-fA-F0-9]{40}$
Example:

"0x1111111111111111111111111111111111111111"

​
nonce
string
required

Hex string

Pattern: ^0x[a-fA-F0-9]*$
Example:

"0xabc123"

​
side
required
Available options:
0
​
price
string
required

Integer encoded as decimal string

Pattern: ^\d+$
Example:

"1000000"

​
size
string
required

Settlement v1 and v2 sells: share units. Settlement v2 buys: all-in budget/debit units (collateral + fee cap).

Pattern: ^\d+$
Example:

"1000000"

​
filledSize
string
required

Same units as size.

Pattern: ^\d+$
Example:

"1000000"

​
remainingSize
string
required

Same units as size.

Pattern: ^\d+$
Example:

"1000000"

​
percentFilled
number
required
​
insertedAt
string<date-time>
required
​
type
enum<string>
required
Available options:
limit,
market
​
status
enum<string>
required
Available options:
open,
filled,
cancelled,
expired,
voided
​
voidedAt
string<date-time> | null
required
​
voidReason
enum<string> | null
required
Available options:
UNFILLED_MARKET_ORDER,
IOC_CLOSED,
UNDER_COLLATERALIZED,
MISSING_OPERATOR_APPROVAL,
BELOW_MIN_FILL_SIZE,
INVALID_SIGNATURE,
MARKET_RESOLVED,
ADMIN_VOID,
MIGRATION_RETIRED,
null
​
outcomeIndex
integer
required
​
expiry
string
required

Integer encoded as decimal string

Pattern: ^\d+$
Example:

"1000000"

​
settlementVersion
required

Settlement family. 1 = legacy settlement. 2 = the post-migration settlement used for new orders.

Available options:
1
​
sv2OrderKind
required

Normalized SettlementV2 order kind for this stored order. Null for legacy orders.

Available options:
0
​
sv2TimeInForce
required

Normalized SettlementV2 time in force for this stored order. Null for legacy orders.

Available options:
0
​
sv2MinSharesOut
string | null
required

SettlementV2 normalized minimum shares-out constraint. Set for buy orders, otherwise null.

Pattern: ^\d+$
Example:

"1000000"

​
sv2MaxCollateralIn
string | null
required

SettlementV2 normalized maximum collateral-in cap. For buys and sell-no-inventory orders this is an all-in cap including maxFee.

Pattern: ^\d+$
Example:

"1000000"

​
sv2MinCollateralOut
string | null
required

SettlementV2 normalized minimum collateral-out floor. For sell-from-inventory orders this is net of maxFee.

Pattern: ^\d+$
Example:

"1000000"