Instruments

Trading instruments including AI commodities with specifications

List instruments

get

Lists all available instruments with optional filtering and sorting.

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

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

order_bystring · enumOptional

Field to sort by

Possible values:

order_directionstring · enumOptional

Sort direction

Possible values:

symbolstringOptional

Filter by exact symbol match (e.g., "CHAT-PRIME")

instrument_typestring · enumOptional

Filter by instrument type

Possible values:

statusstring · enumOptional

Filter by status

Possible values:

Responses

200

List of instruments

application/json

get

/trading/instruments

cURLPythonJavaScriptGo

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

200

List of instruments

{
  "data": [
    {
      "instrument_id": "instrument_e0b04b8a-ce1f-4ccc-a4ca-2a47825d69b0",
      "symbol": "CHAT-PRIME",
      "name": "Chat Prime Instrument",
      "description": "High-quality AI inference capacity",
      "type": "ai_commodity",
      "status": "active",
      "basic_info": {
        "service_type": "text_generation",
        "model_category": "language_model"
      },
      "trading_params": {
        "min_quantity": 1,
        "max_quantity": 1000,
        "quantity_increment": 1,
        "fee": "0.025"
      },
      "ai_specs": {
        "context_window": "200000",
        "token_throughput": "50",
        "tokens_per_unit": 1000000,
        "unit_definition": "per_1000_input_tokens",
        "qualifying_models": [
          "gpt-5",
          "gpt-5-mini"
        ],
        "max_output_length": 4096,
        "model_id": "gpt-5",
        "model_version": "1.0"
      }
    }
  ],
  "paging": {
    "has_more": false,
    "next_cursor": null,
    "prev_cursor": null
  }
}

Get instrument details

get

Gets a specific instrument by its ID. Returns full instrument details including trading parameters and AI specifications.

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

instrument_idstringRequired

Unique identifier for the instrument (e.g., "instrument_c18a986c-522b-475a-b319-f2d0ba04a64d")

Responses

200

Instrument details

application/json

404

Not found - The requested resource does not exist

application/json

get

/trading/instruments/{instrument_id}

cURLPythonJavaScriptGo

curl -X GET 'https://trading-api.cortex.thegrid.ai/api/v1/trading/instruments/instrument_c18a986c-522b-475a-b319-f2d0ba04a64d' \
  -H 'x-thegrid-signature: YOUR_SIGNATURE' \
  -H 'x-thegrid-timestamp: YOUR_TIMESTAMP' \
  -H 'x-thegrid-fingerprint: YOUR_FINGERPRINT'

{
  "data": {
    "instrument_id": "instrument_c18a986c-522b-475a-b319-f2d0ba04a64d",
    "symbol": "CHAT-PRIME",
    "name": "Chat Prime Instrument",
    "description": "High-quality AI inference capacity",
    "type": "ai_commodity",
    "status": "active",
    "basic_info": {
      "service_type": "text_generation",
      "model_category": "language_model"
    },
    "trading_params": {
      "min_quantity": 1,
      "max_quantity": 1000,
      "quantity_increment": 1,
      "fee": "0.025"
    },
    "ai_specs": {
      "context_window": "200000",
      "token_throughput": "50",
      "tokens_per_unit": 1000000,
      "unit_definition": "per_1000_input_tokens",
      "qualifying_models": [
        "gpt-5",
        "gpt-5-mini"
      ],
      "max_output_length": 4096,
      "model_id": "gpt-5",
      "model_version": "1.0"
    },
    "last_trade_price": null,
    "last_trade_at": null,
    "last_quote_at": null,
    "total_volume": "0",
    "volume_24h": "0",
    "total_trades": 0,
    "total_quotes": 0,
    "price_range_24h_high": null,
    "price_range_24h_low": null
  }
}