Orders

Order management including creation, cancellation, and updates

List trader's orders

get

Returns the authenticated trader's orders using Ed25519 signature authentication.

Authorizations

x-thegrid-signaturestringRequired

Ed25519 signature authentication. All three headers are required for every request:

Header	Description
`x-thegrid-signature`	Base64-encoded Ed25519 signature of `{timestamp}{METHOD}{path}{body}`
`x-thegrid-timestamp`	Unix timestamp in seconds (must be within 30 seconds of server time)
`x-thegrid-fingerprint`	SHA256 hash of your public key (Base64-encoded, padding stripped)

See full authentication docs

Query parameters

market_idstringOptional

Filter by market ID

trader_idstringOptional

Filter by trader ID

instrument_idstringOptional

Filter by instrument ID

sidestring · enumOptional

Filter by order side

Possible values:

statusstring · enumOptional

Filter by order status

Possible values:

start_datetimestring · date-timeOptional

Filter orders submitted at or after this time (ISO8601 or Unix timestamp)

end_datetimestring · date-timeOptional

Filter orders submitted at or before this time (ISO8601 or Unix timestamp)

order_bystring · enumOptional

Field to sort by

Possible values:

order_directionstring · enumOptional

Sort direction

Default: ascPossible values:

nextstringOptional

Cursor for forward pagination. Pass the next_cursor value from a previous response to fetch the next page. Mutually exclusive with prev.

prevstringOptional

Cursor for backward pagination. Pass the prev_cursor value from a previous response to fetch the previous page. Mutually exclusive with next.

limitinteger · max: 100Optional

Number of items to return per page (max: 100)

Default: 50

Responses

200

List of orders

application/json

429

Rate limit exceeded - Too many requests in the current time window

application/json

get

/trading/orders

curl -X GET 'https://trading-api.cortex.thegrid.ai/api/v1/trading/orders' \
  -H 'x-thegrid-signature: YOUR_SIGNATURE' \
  -H 'x-thegrid-timestamp: YOUR_TIMESTAMP' \
  -H 'x-thegrid-fingerprint: YOUR_FINGERPRINT'

{
  "data": [
    {
      "id": "order_ZVFOAGG4JWRNXMCK",
      "market_id": "market_b310e860-97cd-45eb-bdc3-5be0b79295d0",
      "market_name": "Market Alpha",
      "instrument_id": "instrument_e0b04b8a-ce1f-4ccc-a4ca-2a47825d69b0",
      "instrument_name": "Test Instrument",
      "instrument_symbol": "GPT-ALPHA",
      "trader_id": "user_1b8dafe4-cea0-415a-8e4c-089c5af0168f",
      "type": "limit",
      "side": "buy",
      "price": "45.50000000",
      "size": 100,
      "filled_quantity": 0,
      "average_price": "45.50000000",
      "fee": "1137.50000000000",
      "status": "active",
      "closure_reason": null,
      "time_in_force": "gtc",
      "stop_price": null,
      "client_order_id": "my-order-123",
      "triggered_by_auto_top_up": false,
      "submitted_at": "2025-12-23T15:15:16Z"
    }
  ],
  "paging": {
    "has_more": false,
    "next_cursor": null,
    "prev_cursor": null
  }
}

Place order

post

Create a new order using Ed25519 signature authentication.

Authorizations

x-thegrid-signaturestringRequired

Ed25519 signature authentication. All three headers are required for every request:

Header	Description
`x-thegrid-signature`	Base64-encoded Ed25519 signature of `{timestamp}{METHOD}{path}{body}`
`x-thegrid-timestamp`	Unix timestamp in seconds (must be within 30 seconds of server time)
`x-thegrid-fingerprint`	SHA256 hash of your public key (Base64-encoded, padding stripped)

See full authentication docs

Body

market_idstringRequired

Market identifier where the order will be placed

Example: market_CHAT-PRIME_USD

client_order_idstring · nullableOptional

Optional client-provided order ID for idempotency. Must be unique per account. Duplicate IDs will return a 422 error with message "client_order_id already exists".

Example: my-order-123

sidestring · enumRequired

Order side: "buy" to purchase the instrument, "sell" to sell. Value is normalized to lowercase.

Example: buyPossible values:

typestring · enumRequired

Order type: "limit" executes at specified price or better, "market" executes immediately at best available price. Value is normalized to lowercase.

Example: limitPossible values:

pricestringOptional

Price per unit in quote currency (USD). Required for limit orders, must be omitted for market orders. Must be a positive number >= 0.0001 with at most 4 decimal places (tick size).

Example: 45.50

quantityinteger · min: 1 · max: 100Required

Number of units to buy or sell. Must be a positive integer, maximum 100 per order.

Example: 100

time_in_forcestring · enumOptional

Order duration policy. Value is normalized to lowercase.

gtc (Good Till Cancelled): Order remains active until completely filled or manually cancelled
ioc (Immediate Or Cancel): Order executes immediately for available quantity, remainder is cancelled
fok (Fill Or Kill): Order must be completely filled immediately or entirely cancelled
day: Order expires at the end of the trading day if not filled

Default: gtcExample: gtcPossible values:

Responses

201

Order created

application/json

400

Invalid order parameters

401

Unauthorized - Invalid or missing authentication headers

application/json

422

Validation error - Request parameters failed validation

application/json

post

/trading/orders

curl -X POST 'https://trading-api.cortex.thegrid.ai/api/v1/trading/orders' \
  -H 'Content-Type: application/json' \
  -H 'x-thegrid-signature: YOUR_SIGNATURE' \
  -H 'x-thegrid-timestamp: YOUR_TIMESTAMP' \
  -H 'x-thegrid-fingerprint: YOUR_FINGERPRINT' \
  -d '{
    "market_id": "market_b310e860-97cd-45eb-bdc3-5be0b79295d0",
    "side": "buy",
    "type": "limit",
    "quantity": 1,
    "price": "1.19"
  }'

{
  "data": {
    "order_id": "order_TT64AI5BZNLKUFTL",
    "client_order_id": "my-order-123"
  }
}

Get order details

get

Returns details of a specific order.

Authorizations

x-thegrid-signaturestringRequired

Ed25519 signature authentication. All three headers are required for every request:

Header	Description
`x-thegrid-signature`	Base64-encoded Ed25519 signature of `{timestamp}{METHOD}{path}{body}`
`x-thegrid-timestamp`	Unix timestamp in seconds (must be within 30 seconds of server time)
`x-thegrid-fingerprint`	SHA256 hash of your public key (Base64-encoded, padding stripped)

See full authentication docs

Path parameters

order_idstringRequired

Unique identifier for the order (e.g., "order_TT64AI5BZNLKUFTL")

Responses

200

Order details

application/json

404

Not found - The requested resource does not exist

application/json

get

/trading/orders/{order_id}

curl -X GET 'https://trading-api.cortex.thegrid.ai/api/v1/trading/orders/order_ZVFOAGG4JWRNXMCK' \
  -H 'x-thegrid-signature: YOUR_SIGNATURE' \
  -H 'x-thegrid-timestamp: YOUR_TIMESTAMP' \
  -H 'x-thegrid-fingerprint: YOUR_FINGERPRINT'

{
  "data": {
    "id": "order_show_1",
    "market_id": "test-market-27",
    "market_name": "Show Market",
    "instrument_id": "instrument_c18a986c-522b-475a-b319-f2d0ba04a64d",
    "instrument_name": "Test Instrument",
    "instrument_symbol": "GPT-SHOW",
    "trader_id": "user_0e393ba0-84a3-49e2-9795-59174ddb29a4",
    "type": "limit",
    "side": "buy",
    "price": "45.50000000",
    "size": 1000,
    "filled_quantity": 0,
    "average_price": "45.50000000",
    "fee": "1137.50000000000",
    "status": "active",
    "closure_reason": null,
    "time_in_force": "gtc",
    "stop_price": null,
    "client_order_id": null,
    "triggered_by_auto_top_up": false,
    "submitted_at": "2025-12-23T15:15:16Z"
  }
}

Cancel order

delete

Cancel an order using Ed25519 signature authentication.

Authorizations

x-thegrid-signaturestringRequired

Ed25519 signature authentication. All three headers are required for every request:

Header	Description
`x-thegrid-signature`	Base64-encoded Ed25519 signature of `{timestamp}{METHOD}{path}{body}`
`x-thegrid-timestamp`	Unix timestamp in seconds (must be within 30 seconds of server time)
`x-thegrid-fingerprint`	SHA256 hash of your public key (Base64-encoded, padding stripped)

See full authentication docs

Path parameters

order_idstringRequired

Unique identifier for the order (e.g., "order_TT64AI5BZNLKUFTL")

Responses

204

Order cancelled successfully

404

Not found - The requested resource does not exist

application/json

409

Order already cancelled

application/json

delete

/trading/orders/{order_id}

curl -X DELETE 'https://trading-api.cortex.thegrid.ai/api/v1/trading/orders/order_ZVFOAGG4JWRNXMCK' \
  -H 'x-thegrid-signature: YOUR_SIGNATURE' \
  -H 'x-thegrid-timestamp: YOUR_TIMESTAMP' \
  -H 'x-thegrid-fingerprint: YOUR_FINGERPRINT'

No content

PreviousMarkets NextTrades

Last updated 5 hours ago

Was this helpful?

Good evening

hashtagList trader's orders

hashtagPlace order

hashtagGet order details

hashtagCancel order

List trader's orders

Place order

Get order details

Cancel order