Trades

Trade history associated with the authenticated user. Trades are individual fills for a given order.

Get user's trade history

get

Get your trade history (fills). Results are always the authenticated user's trades. Use the order_id filter to limit results to trades for a specific order (the user's order associated with each trade, as returned in the response order_id field).

Authorizations

signatureAuth

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

instrument_idstringOptional

Filter by instrument ID

trade_idstringOptional

Filter by trade ID

order_idstringOptional

Filter by the user's order ID associated with the trade (canonical filter for "my" trades). Matches the order_id field returned on each trade.

statusstringOptional

Filter by trade status

buyer_order_idstringOptional

Filter by buyer's order ID (legacy; prefer order_id for user's trades)

seller_order_idstringOptional

Filter by seller's order ID (legacy; prefer order_id for user's trades)

triggering_order_idstringOptional

Filter by the order that triggered the trade (legacy; prefer order_id for user's trades)

start_datetimestring · date-timeOptional

Filter trades executed at or after this time (ISO8601 or Unix timestamp)

end_datetimestring · date-timeOptional

Filter trades executed 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 trades

application/json

get

/trading/trades

cURLPythonJavaScriptGo

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

200

List of trades

{
  "data": [
    {
      "id": "d9dcb544-02a2-4637-880c-13d50d61fb42",
      "trade_id": "trade_d7b40819-0ea6-428b-b00c-deb559206cb7",
      "market_id": "market_b310e860-97cd-45eb-bdc3-5be0b79295d0",
      "market_name": "Show Market",
      "instrument_id": "instrument_c18a986c-522b-475a-b319-f2d0ba04a64d",
      "instrument_name": "Test Instrument",
      "instrument_symbol": "GPT-SHOW",
      "order_id": "order_ZVFOAGG4JWRNXMCK",
      "trading_account_id": "trading_account_6e6ad9d28eaae559",
      "price": "99.99000000",
      "quantity": 500,
      "side": "buy",
      "total_value": "45500.00000000",
      "fee": "0.025",
      "status": "executed",
      "execution_timestamp": "2025-12-05T17:29:29.887434Z",
      "settlement_timestamp": "2025-12-05T17:29:29.887436Z"
    }
  ],
  "paging": {
    "has_more": false,
    "next_cursor": null,
    "prev_cursor": null
  }
}

Get single trade

get

Returns a single trade with metadata.

Authorizations

signatureAuth

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

trade_idstringRequired

Unique identifier for the trade (e.g., "trade_d7b40819-0ea6-428b-b00c-deb559206cb7")

Responses

200

Trade details

application/json

404

Not found - The requested resource does not exist

application/json

get

/trading/trades/{trade_id}

cURLPythonJavaScriptGo

curl -X GET 'https://trading-api.cortex.thegrid.ai/api/v1/trading/trades/trade_d7b40819-0ea6-428b-b00c-deb559206cb7' \
  -H 'x-thegrid-signature: YOUR_SIGNATURE' \
  -H 'x-thegrid-timestamp: YOUR_TIMESTAMP' \
  -H 'x-thegrid-fingerprint: YOUR_FINGERPRINT'

{
  "data": {
    "id": "d9dcb544-02a2-4637-880c-13d50d61fb42",
    "trade_id": "trade_d7b40819-0ea6-428b-b00c-deb559206cb7",
    "market_id": "market_b310e860-97cd-45eb-bdc3-5be0b79295d0",
    "market_name": "Show Market",
    "instrument_id": "instrument_c18a986c-522b-475a-b319-f2d0ba04a64d",
    "instrument_name": "Test Instrument",
    "instrument_symbol": "GPT-SHOW",
    "order_id": "order_ZVFOAGG4JWRNXMCK",
    "trading_account_id": "trading_account_6e6ad9d28eaae559",
    "price": "99.99000000",
    "quantity": 500,
    "side": "buy",
    "total_value": "45500.00000000",
    "fee": "0.025",
    "status": "executed",
    "execution_timestamp": "2025-12-05T17:29:29.887434Z",
    "settlement_timestamp": "2025-12-05T17:29:29.887436Z"
  }
}