Markets

Market information, statistics, and orderbook data

List markets

get

Returns markets with instrument details.

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

Responses

200

List of markets

application/json

get

/trading/markets

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

200

List of markets

{
  "data": [
    {
      "market_id": "market_b310e860-97cd-45eb-bdc3-5be0b79295d0",
      "name": "Alpha Market",
      "description": "Primary market for AI inference trading",
      "market_type": "spot",
      "status": "active",
      "allowed_instruments": [
        "instrument_e0b04b8a-ce1f-4ccc-a4ca-2a47825d69b0",
        "instrument_b237c3b4-e623-48ba-bddd-a8ee5230973e"
      ],
      "instruments": [
        {
          "id": "6b3946b6-4697-4171-a922-7d445bca61f4",
          "instrument_id": "instrument_e0b04b8a-ce1f-4ccc-a4ca-2a47825d69b0",
          "symbol": "GPT-TRADER",
          "name": "GPT Trader Token",
          "description": "Claude-3 Inference Token Trading",
          "instrument_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"
          },
          "sla_requirements": {
            "availability_target": 99.95,
            "max_latency_ms": 300,
            "quality_score_min": 90
          },
          "last_trade_price": null,
          "last_trade_at": null,
          "last_quote_at": null,
          "price_range_24h_high": null,
          "price_range_24h_low": null,
          "total_volume": 0,
          "volume_24h": 0,
          "total_trades": 0,
          "total_quotes": 0,
          "created_at": "2025-12-15T11:29:53",
          "updated_at": "2025-12-15T11:29:53"
        }
      ],
      "created_at": "2025-12-15T11:29:53Z",
      "updated_at": "2025-12-15T11:29:53Z"
    }
  ],
  "paging": {
    "has_more": false,
    "next_cursor": null,
    "prev_cursor": null
  }
}

Get market ticker

get

Get current ticker data including best bid/ask, last price, and 24h volume.

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

market_idstringRequired

Unique identifier for the market (e.g., "market_CHAT-PRIME_USD")

Responses

200

Ticker data including last trade, bid/ask, and 24h volume

application/json

401

Unauthorized - Invalid or missing authentication headers

application/json

404

Not found - The requested resource does not exist

application/json

get

/trading/markets/{market_id}/ticker

curl -X GET 'https://trading-api.cortex.thegrid.ai/api/v1/trading/markets/market_b310e860-97cd-45eb-bdc3-5be0b79295d0/ticker' \
  -H 'x-thegrid-signature: YOUR_SIGNATURE' \
  -H 'x-thegrid-timestamp: YOUR_TIMESTAMP' \
  -H 'x-thegrid-fingerprint: YOUR_FINGERPRINT'

{
  "data": {
    "last_price": "45.50",
    "last_trade_size": 100,
    "last_trade_timestamp": "2026-02-12T07:42:45Z",
    "lowest_ask": "45.75",
    "highest_bid": "45.25",
    "volume_24h": 15000
  }
}

Get order book

get

Get the order book (depth of market) for a specific market.

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

market_idstringRequired

Unique identifier for the market (e.g., "market_CHAT-PRIME_USD")

Query parameters

depthinteger · min: 1 · max: 100Optional

Maximum number of price levels to return per side (bids and asks). Default: 10. Use lower values for quick price checks, higher values for detailed market depth analysis.

Default: 10

Responses

200

Order book data

application/json

get

/trading/markets/{market_id}/orderbook

curl -X GET 'https://trading-api.cortex.thegrid.ai/api/v1/trading/markets/market_b310e860-97cd-45eb-bdc3-5be0b79295d0/orderbook' \
  -H 'x-thegrid-signature: YOUR_SIGNATURE' \
  -H 'x-thegrid-timestamp: YOUR_TIMESTAMP' \
  -H 'x-thegrid-fingerprint: YOUR_FINGERPRINT'

200

Order book data

{
  "data": {
    "buy": [
      {
        "price": "144.50",
        "size": 100,
        "total": 100,
        "order_count": 1
      },
      {
        "price": "144.00",
        "size": 200,
        "total": 300,
        "order_count": 1
      }
    ],
    "sell": [
      {
        "price": "145.50",
        "size": 150,
        "total": 150,
        "order_count": 1
      },
      {
        "price": "146.00",
        "size": 250,
        "total": 400,
        "order_count": 1
      }
    ],
    "highest_bid": "144.50000000",
    "lowest_ask": "145.50000000",
    "updated_at": "2025-12-15T11:29:53.531908Z"
  }
}

Get market trades

get

Returns public trades for a specific market (not scoped to authenticated user).

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

market_idstringRequired

Unique identifier for the market (e.g., "market_CHAT-PRIME_USD")

Query parameters

statusstringOptional

Filter by trade status

sidestring · enumOptional

Filter by taker side

Possible values:

min_quantityintegerOptional

Filter trades with quantity >= this value

max_quantityintegerOptional

Filter trades with quantity <= this value

min_pricestringOptional

Filter trades with price >= this value

max_pricestringOptional

Filter trades with price <= this value

start_datestring · date-timeOptional

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

end_datestring · 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 trades to return (max: 100)

Default: 50

Responses

200

Recent trades

application/json

get

/trading/markets/{market_id}/trades

curl -X GET 'https://trading-api.cortex.thegrid.ai/api/v1/trading/markets/market_b310e860-97cd-45eb-bdc3-5be0b79295d0/trades' \
  -H 'x-thegrid-signature: YOUR_SIGNATURE' \
  -H 'x-thegrid-timestamp: YOUR_TIMESTAMP' \
  -H 'x-thegrid-fingerprint: YOUR_FINGERPRINT'

200

Recent trades

{
  "data": [
    {
      "id": "be130f02-a0d1-43f7-9781-dab66ea3f627",
      "trade_id": "trade-1",
      "market_id": "test-market-trades",
      "market_name": null,
      "instrument_id": "instrument_e0b04b8a-ce1f-4ccc-a4ca-2a47825d69b0",
      "instrument_symbol": "GPT-TEST",
      "instrument_name": "Test Instrument",
      "price": "45.50000000",
      "quantity": 3,
      "side": "buy",
      "total_value": "45500.00000000",
      "status": "executed",
      "execution_timestamp": "2025-12-05T17:29:29.944711Z",
      "settlement_timestamp": "2025-12-05T17:29:29.944712Z"
    },
    {
      "id": "48540c98-bbee-441c-a984-b2aa56cd613a",
      "trade_id": "trade-2",
      "market_id": "test-market-trades",
      "market_name": null,
      "instrument_id": "instrument_b237c3b4-e623-48ba-bddd-a8ee5230973e",
      "instrument_symbol": "GPT-TEST",
      "instrument_name": "Test Instrument",
      "price": "45.50000000",
      "quantity": 11,
      "side": "buy",
      "total_value": "45500.00000000",
      "status": "executed",
      "execution_timestamp": "2025-12-05T17:29:29.944180Z",
      "settlement_timestamp": "2025-12-05T17:29:29.944181Z"
    },
    {
      "id": "6a9eab19-f78c-4ddd-9422-7d4a24c2a3d3",
      "trade_id": "trade-3",
      "market_id": "test-market-trades",
      "market_name": null,
      "instrument_id": "instrument_c18a986c-522b-475a-b319-f2d0ba04a64d",
      "instrument_symbol": "GPT-TEST",
      "instrument_name": "Test Instrument",
      "price": "45.50000000",
      "quantity": 1,
      "side": "buy",
      "total_value": "45500.00000000",
      "status": "executed",
      "execution_timestamp": "2025-12-05T17:29:29.942332Z",
      "settlement_timestamp": "2025-12-05T17:29:29.942334Z"
    }
  ],
  "paging": {
    "has_more": false,
    "next_cursor": null,
    "prev_cursor": null
  }
}

Get market details

get

Returns market details with instruments.

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

market_idstringRequired

Unique identifier for the market (e.g., "market_CHAT-PRIME_USD")

Responses

200

Market details

application/json

404

Not found - The requested resource does not exist

application/json

get

/trading/markets/{market_id}

curl -X GET 'https://trading-api.cortex.thegrid.ai/api/v1/trading/markets/market_b310e860-97cd-45eb-bdc3-5be0b79295d0' \
  -H 'x-thegrid-signature: YOUR_SIGNATURE' \
  -H 'x-thegrid-timestamp: YOUR_TIMESTAMP' \
  -H 'x-thegrid-fingerprint: YOUR_FINGERPRINT'

{
  "data": {
    "market_id": "market_b310e860-97cd-45eb-bdc3-5be0b79295d0",
    "name": "Detail Market",
    "description": "Primary market for AI inference trading",
    "market_type": "spot",
    "status": "active",
    "allowed_instruments": [
      "instrument_e0b04b8a-ce1f-4ccc-a4ca-2a47825d69b0",
      "instrument_b237c3b4-e623-48ba-bddd-a8ee5230973e"
    ],
    "instruments": [
      {
        "id": "b89a5f06-5fa4-41d8-98e3-dc07ff12bc4f",
        "instrument_id": "instrument_e0b04b8a-ce1f-4ccc-a4ca-2a47825d69b0",
        "symbol": "GPT-DETAIL",
        "name": "GPT Detail Token",
        "description": "Claude-3 Inference Token Trading",
        "instrument_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"
        },
        "sla_requirements": {
          "availability_target": 99.95,
          "max_latency_ms": 300,
          "quality_score_min": 90
        },
        "last_trade_price": null,
        "last_trade_at": null,
        "last_quote_at": null,
        "price_range_24h_high": null,
        "price_range_24h_low": null,
        "total_volume": 0,
        "volume_24h": 0,
        "total_trades": 0,
        "total_quotes": 0,
        "created_at": "2025-12-15T11:29:53",
        "updated_at": "2025-12-15T11:29:53"
      }
    ],
    "created_at": "2025-12-15T11:29:53Z",
    "updated_at": "2025-12-15T11:29:53Z"
  }
}

Get price history (OHLCV)

get

Returns OHLCV (Open, High, Low, Close, Volume) candle data for charting. Use this endpoint to build price charts and analyze historical market data.

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

resolutionstring · enumOptional

Candle resolution/timeframe. Determines the time period each candle represents.

Possible values:

fromintegerOptional

Start of time range (Unix timestamp in seconds)

tointegerOptional

End of time range (Unix timestamp in seconds)

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

OHLCV candle data

application/json

401

Unauthorized - Invalid or missing authentication headers

application/json

422

Validation error - Request parameters failed validation

application/json

get

/trading/price-histories

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

{
  "data": [
    {
      "time": "2026-02-12T07:00:00Z",
      "market_id": "market_b310e860-97cd-45eb-bdc3-5be0b79295d0",
      "resolution": "1h",
      "open": "45.00",
      "high": "45.75",
      "low": "44.80",
      "close": "45.50",
      "volume": 1200,
      "trade_count": 48
    },
    {
      "time": "2026-02-12T08:00:00Z",
      "market_id": "market_b310e860-97cd-45eb-bdc3-5be0b79295d0",
      "resolution": "1h",
      "open": "45.50",
      "high": "46.25",
      "low": "45.25",
      "close": "46.00",
      "volume": 1500,
      "trade_count": 62
    }
  ],
  "paging": {
    "has_more": true,
    "next_cursor": "eyJpZCI6InByaWNlXzEyMyJ9",
    "prev_cursor": null
  }
}

PreviousInstruments NextOrders

Last updated 5 hours ago

Was this helpful?

Good evening

hashtagList markets

hashtagGet market ticker

hashtagGet order book

hashtagGet market trades

hashtagGet market details

hashtagGet price history (OHLCV)

List markets

Get market ticker

Get order book

Get market trades

Get market details

Get price history (OHLCV)