---
title: "GET /instrument"
method: GET
path: "/instrument"
tags: ["api-gateway"]
---

# GET /instrument

`GET /instrument`

## Query parameters

- `symbol` string, required

## Response `200`

Instrument details

- GetInstrumentResponse
  - `additional_product_specs` object, required
  - `category` 'compute' | 'crypto' | 'energy' | 'energy_etfs' | 'equities' | 'fx' | 'metals' | 'treasuries', required
  - `contract_mark_price` string, nullable
  - `contract_size` string, nullable
  - `description` string, nullable
  - `estimated_funding_supported` boolean — Whether a live index feed is configured for this instrument, so an intraday funding-rate estimate can be produced. When `false`, the estimated-funding endpoint reports the symbol as unsupported and clients should not surface an estimate for it.
  - `expiration` string, date-time, nullable — Absolute expiration time for dated contracts. `None` for perpetuals. Presence of a value is the discriminator between dated and perpetual contracts.
  - `funding_rate_cap_lower_pct` string, nullable
  - `funding_rate_cap_upper_pct` string, nullable
  - `funding_schedule` FundingRateSchedule — Machine-readable funding rate schedule for perpetual contracts
    - `exceptions` FundingException[], required — Dates with modified schedules (e.g., half-days, special times, or holidays). Note: Exception dates are interpreted in the schedule's timezone (the benchmark timezone), not UTC. For example, if the timezone is "America/New_York" and an exception date is "2025-12-25", it refers to December 25th in New York time.
      - `date` string, date, required — The date this exception applies to
      - `reason` string, nullable — Human-readable reason
      - `times` TimeOfDay[], required — Replacement times for this date
        - `hours` integer, required
        - `minutes` integer, required
        - `seconds` integer
    - `times` FundingTime[], required — Recurring funding times
      - `days_of_week` integer[], required — Days of week using ISO 8601 numbering (1=Monday, 7=Sunday). This type ensures that all day values are in the valid range [1, 7]. It is serialized as a JSON array of numbers for API compatibility.
      - `time_of_day` TimeOfDay, required — Time of day representation
        - `hours` integer, required
        - `minutes` integer, required
        - `seconds` integer
    - `timezone` string, required — Timezone for all times (chrono_tz::Tz, serializes as IANA string)
  - `funding_schedule_calendar_description` string, nullable
  - `funding_schedule_time_description` string, nullable
  - `funding_settlement_currency` string, required
  - `initial_margin_pct` string, required
  - `maintenance_margin_pct` string, required
  - `minimum_order_size` string, required
  - `multiplier` string, required
  - `price_band_lower_deviation_pct` string, nullable
  - `price_band_upper_deviation_pct` string, nullable
  - `price_bands` string, nullable
  - `price_quotation` string, nullable
  - `price_scale` integer, required
  - `product` string — Umbrella product this instrument belongs to (e.g. `XAU` for `XAU-PERP`, `XAU-2026-SEP`, `XAU-2026-DEC`). Instruments that share a `product` are the same underlying and can be grouped together in a product list.
  - `quote_currency` string, required
  - `symbol` string, required
  - `tick_size` string, required
  - `trading_schedule` TradingSchedule — Trading schedule for an instrument, containing multiple trading hour segments
    - `segments` TradingHoursSegment[], required
      - `days_of_week` integer[], required — Days of week using ISO 8601 numbering (1=Monday, 7=Sunday). This type ensures that all day values are in the valid range [1, 7]. It is serialized as a JSON array of numbers for API compatibility.
      - `duration_seconds` integer, required — Duration of this segment in seconds
      - `expire_all_orders` boolean, required — Whether to expire all orders during this segment
      - `hide_market_data` boolean, required — Whether to hide market data during this segment
      - `state` 'CLOSED_FROZEN' | 'PRE_OPEN' | 'OPEN' | 'CLOSED' | 'DELISTED' | 'HALTED' | 'MATCH_AND_CLOSE_AUCTION' | 'UNKNOWN', required
      - `time_of_day` TimeOfDay, required — Time of day representation
        - `hours` integer, required
        - `minutes` integer, required
        - `seconds` integer
  - `underlying_benchmark_price` string, nullable

## Other responses

- `404` — Instrument not found

---

[API](https://skmtc.net/architect/apis/ax-api-gateway.md) · [All operations](https://skmtc.net/architect/apis/ax-api-gateway/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/architect/ax-api-gateway/versions/2955c31c524d/schema)