Transfers

Asset transfers from trading to consumption accounts. Transfers are one-way.

Transfer to consumption

post

Transfers a specified quantity of an instrument from trading account to consumption account.

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

Body

application/json

instrument_idstringRequired

The instrument to transfer from your trading account to your consumption account

Example: instrument_c18a986c-522b-475a-b319-f2d0ba04a64d

quantityinteger · min: 1Required

Number of units to transfer. Must have sufficient available balance in your trading account.

Example: 100

Responses

202

Transfer initiated (processed asynchronously)

application/json

post

/trading/transfers/trading-to-consumption

cURLPythonJavaScriptGo

curl -X POST 'https://trading-api.cortex.thegrid.ai/api/v1/trading/transfers/trading-to-consumption' \
  -H 'Content-Type: application/json' \
  -H 'x-thegrid-signature: YOUR_SIGNATURE' \
  -H 'x-thegrid-timestamp: YOUR_TIMESTAMP' \
  -H 'x-thegrid-fingerprint: YOUR_FINGERPRINT' \
  -d '{
    "instrument_id": "instrument_e0b04b8a-ce1f-4ccc-a4ca-2a47825d69b0",
    "quantity": 100
  }'

202

Transfer initiated (processed asynchronously)

{
  "status": "success",
  "transfer_id": "text"
}

List transfer history

get

Returns transfer histories for authenticated user.

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

start_datetimestring · date-timeOptional

Filter transfers at or after this time (ISO8601 or Unix timestamp)

end_datetimestring · date-timeOptional

Filter transfers 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

Transfer history

application/json

get

/trading/transfer-histories

cURLPythonJavaScriptGo

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

200

Transfer history

{
  "data": [
    {
      "id": "362f5970-84d7-4752-9256-72068a628a03",
      "transfer_id": "transfer_3f0f4bda-def0-4db9-bd64-a6a37d39535e",
      "account_id": "consumption_account_cbf73393ef9e2ed0",
      "sender_account_id": "trading_account_6e6ad9d28eaae559",
      "instrument_id": "instrument_e0b04b8a-ce1f-4ccc-a4ca-2a47825d69b0",
      "instrument_name": "Test Instrument",
      "market_id": "market_b310e860-97cd-45eb-bdc3-5be0b79295d0",
      "quantity": 200,
      "transferred_at": "2026-01-09T17:32:59Z",
      "inserted_at": "2026-01-09T17:32:59Z",
      "updated_at": "2026-01-09T17:32:59Z"
    },
    {
      "id": "ea4050dd-3b67-4d9b-bae6-e26dd708ac0c",
      "transfer_id": "transfer_3f0f4bda-def0-4db9-bd64-a6a37d39535e",
      "account_id": "consumption_account_2e3ed8507574eec9",
      "sender_account_id": "trading_account_6e6ad9d28eaae559",
      "instrument_id": "instrument_e0b04b8a-ce1f-4ccc-a4ca-2a47825d69b0",
      "instrument_name": "Test Instrument",
      "market_id": "market_b310e860-97cd-45eb-bdc3-5be0b79295d0",
      "quantity": 100,
      "transferred_at": "2026-01-09T17:31:59Z",
      "inserted_at": "2026-01-09T17:32:59Z",
      "updated_at": "2026-01-09T17:32:59Z"
    }
  ],
  "paging": {
    "has_more": false,
    "next_cursor": null,
    "prev_cursor": null
  }
}