Accounts

Trading and consumption accounts, their balances and more.

List consumption accounts

get

View your consumption accounts by instrument, including balances and tokens used.

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

account_idstringOptional

Filter by account ID

instrument_idstringOptional

Filter by instrument ID

statusstring · enumOptional

Filter by account status

Possible values:

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

Consumption accounts

application/json

get

/trading/consumption-accounts

cURLPythonJavaScriptGo

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

200

Consumption accounts

{
  "data": [
    {
      "account_id": "consumption_account_cbf73393ef9e2ed0",
      "user_id": "user_094a5dc4-a2a6-48de-b6e0-09e214c5ca0d",
      "instrument_id": "instrument_e0b04b8a-ce1f-4ccc-a4ca-2a47825d69b0",
      "total_balance": 1500,
      "available_balance": 1000,
      "committed_balance": 500,
      "uncommitted_balance": 1000,
      "status": "active",
      "total_commitments": 0,
      "total_deposits": 2,
      "total_transfers_in": 2,
      "total_transfers_out": 0,
      "total_withdrawals": 0,
      "last_commitment_at": null,
      "last_deposit_at": "2026-01-09T17:33:02Z",
      "last_transfer_at": "2026-01-09T17:33:02Z",
      "last_withdrawal_at": null,
      "created_at": "2026-01-09T17:33:02Z",
      "updated_at": "2026-01-09T17:33:02Z"
    }
  ],
  "paging": {
    "has_more": false,
    "next_cursor": null,
    "prev_cursor": null
  }
}

Get consumption account details

get

Get detailed information about a specific 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

Path parameters

account_idstringRequired

Unique identifier for the consumption account (e.g., "consumption_account_cbf73393ef9e2ed0")

Responses

200

Consumption account details

application/json

404

Not found - The requested resource does not exist

application/json

get

/trading/consumption-accounts/{account_id}

cURLPythonJavaScriptGo

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

{
  "data": {
    "account_id": "consumption_account_cbf73393ef9e2ed0",
    "available_balance": 2000,
    "committed_balance": 500,
    "uncommitted_balance": 1500,
    "created_at": "2026-01-09T17:33:02Z",
    "instrument_id": "instrument_c18a986c-522b-475a-b319-f2d0ba04a64d",
    "last_commitment_at": null,
    "last_deposit_at": "2026-01-09T17:33:02Z",
    "last_transfer_at": "2026-01-09T17:33:02Z",
    "last_withdrawal_at": null,
    "status": "active",
    "total_balance": 2500,
    "total_commitments": 0,
    "total_deposits": 2,
    "total_transfers_in": 2,
    "total_transfers_out": 0,
    "total_withdrawals": 0,
    "updated_at": "2026-01-09T17:33:02Z",
    "user_id": "user_9294c85b-d84f-4a9b-9bc3-51be1005cead"
  }
}

List currency trading accounts

get

List all currency trading accounts (USD, etc.).

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

user_idstringOptional

Filter by user ID

account_idstringOptional

Filter by account ID

currencystringOptional

Filter by currency (e.g., "USD")

statusstring · enumOptional

Filter by account status

Possible values:

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 currency trading accounts

application/json

get

/trading/currency-trading-accounts

cURLPythonJavaScriptGo

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

200

List of currency trading accounts

{
  "data": [
    {
      "account_id": "currency_trading_account_e927ad93f9c4aaa8",
      "user_id": "user_2e605810-1e39-4d5a-a8e2-e46c89ac4b26",
      "currency": "USD",
      "total_balance": "1200",
      "available_balance": "700",
      "locked_balance": "500",
      "status": "active",
      "last_deposit_at": null,
      "last_trading_activity_at": null,
      "last_withdrawal_at": null,
      "created_at": "2025-12-10T18:19:01Z",
      "updated_at": "2025-12-10T18:19:01Z"
    }
  ],
  "paging": {
    "has_more": false,
    "next_cursor": null,
    "prev_cursor": null
  }
}

Get currency account details

get

Get specific currency trading account details.

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

account_idstringRequired

Unique identifier for the currency trading account (e.g., "currency_trading_account_57252e83c212e7a9")

Responses

200

Currency account details

application/json

404

Not found - The requested resource does not exist

application/json

get

/trading/currency-trading-accounts/{account_id}

cURLPythonJavaScriptGo

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

{
  "data": {
    "account_id": "currency_trading_account_57252e83c212e7a9",
    "user_id": "user_2ce466b1-d257-4337-98e4-54b4fd254702",
    "currency": "USD",
    "total_balance": "1200",
    "available_balance": "700",
    "locked_balance": "500",
    "status": "active",
    "last_deposit_at": null,
    "last_trading_activity_at": null,
    "last_withdrawal_at": null,
    "created_at": "2025-12-10T18:19:01Z",
    "updated_at": "2025-12-10T18:19:01Z"
  }
}

List trading account balances

get

List all trading account balances across instruments.

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

account_idstringOptional

Filter by account ID

market_idstringOptional

Filter by market ID

instrument_idstringOptional

Filter by instrument ID

statusstring · enumOptional

Filter by account status

Possible values:

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 trading accounts

application/json

get

/trading/trading-accounts

cURLPythonJavaScriptGo

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

200

List of trading accounts

{
  "data": [
    {
      "account_id": "trading_account_6e6ad9d28eaae559",
      "user_id": "user_7225b557-5e6d-4faa-a0d7-4ca6fe261165",
      "instrument_id": "instrument_e0b04b8a-ce1f-4ccc-a4ca-2a47825d69b0",
      "instrument_name": "GPT Trader Token",
      "instrument_symbol": "GPT-TRADER",
      "market_id": "market_b310e860-97cd-45eb-bdc3-5be0b79295d0",
      "market_name": "Alpha Market",
      "total_balance": 150,
      "available_balance": "100",
      "locked_balance": "50",
      "last_trade_price": "45.50",
      "status": "active",
      "last_deposit_at": null,
      "last_trading_activity_at": null,
      "last_withdrawal_at": null,
      "created_at": "2025-12-02T11:51:37Z",
      "updated_at": "2025-12-02T11:51:37Z"
    }
  ],
  "paging": {
    "has_more": false,
    "next_cursor": null,
    "prev_cursor": null
  }
}

Get trading account details

get

Get detailed information about a specific trading 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

Path parameters

account_idstringRequired

Unique identifier for the trading account (e.g., "trading_account_6e6ad9d28eaae559")

Responses

200

Trading account details

application/json

404

Not found - The requested resource does not exist

application/json

get

/trading/trading-accounts/{account_id}

cURLPythonJavaScriptGo

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

{
  "data": {
    "account_id": "trading_account_6e6ad9d28eaae559",
    "user_id": "user_2e73aeab-3f3e-401f-9976-c78b9d326961",
    "instrument_id": "instrument_c18a986c-522b-475a-b319-f2d0ba04a64d",
    "instrument_name": "GPT Detail Token",
    "instrument_symbol": "GPT-DETAIL",
    "market_id": "market_b310e860-97cd-45eb-bdc3-5be0b79295d0",
    "market_name": "Detail Market",
    "total_balance": 250,
    "available_balance": "200",
    "locked_balance": "50",
    "last_trade_price": "45.50",
    "status": "active",
    "last_deposit_at": null,
    "last_trading_activity_at": null,
    "last_withdrawal_at": null,
    "created_at": "2025-12-02T11:51:37Z",
    "updated_at": "2025-12-02T11:51:37Z"
  }
}