Skip to main content

instrument

CHANNEL 
wss://stream.crypto.com/fcm/v1/market
instrument
Instrument updates. Subscribe with channel ["instrument"] to receive updates for all instruments. Publishes instrument information when there are changes (e.g. tradable status, leverage updates).

Request​

Body

required
    id integerrequired

    Request id

    method stringrequired

    Possible values: [subscribe]

    params objectrequired
    channels string[]required

    e.g. ["instrument"]

    nonce integerrequired

    Current timestamp in milliseconds

WebSocket response
Schema
    id int64
    method string
    code int32
    result object
    subscription string
    channel string
    data object[]
  • Array [
    • symbol string

    Instrument name, e.g. BTCUSD-PERP

    inst_type string

    Instrument type, e.g. PERPETUAL_SWAP

    display_name string

    Display name, e.g. BTCUSD Perpetual

    base_ccy string

    Base currency, e.g. BTC

    quote_ccy string

    Quote currency, e.g. USD

    quote_decimals int32

    Minimum decimal place for price field

    quantity_decimals int32

    Minimum decimal place for qty field

    price_tick_size decimal

    Minimum price tick size

    qty_tick_size decimal

    Minimum trading quantity / tick size

    max_leverage decimal

    Max leverage of the product

    tradable boolean

    True or false

    expiry_timestamp_ms int64

    Expiry timestamp in milliseconds

    beta_product boolean

    Whether this is a beta product.

    underlying_symbol string

    Underlying symbol

    product_type string

    Product type of the instrument. Possible values: COMMODITIES, EQUITY_IND, CURRENCIES, DIGITAL_CURRENCIES, EVENTS, EQUITY, PRE_IPO. Only returned if applicable.

    contract_size decimal

    Contract size for the instrument.

    margin_buy_enabled boolean

    Whether margin buying is enabled for this instrument.

    margin_sell_enabled boolean

    Whether margin selling is enabled for this instrument.

    event_details object
    Event details for prediction market instruments. Structure is flexible and defined by external systems.
    property name* any

    Event details for prediction market instruments. Structure is flexible and defined by external systems.

    last_updated_time int64

    Unix timestamp in nanoseconds when the instrument was last updated.

    detail_product_type string

    Possible values: [COMMODITIES, CURRENCIES, EQUITY_IND, EVENTS, CROPS, EARNINGS, ECONOMIC_DERIV, ENERGY, HOUSING_PRICES, HURRICANES, MERGERS, MORTGAGE_RATES, REVENUES, DIGITAL_CURRENCIES, POLITICS, ECONOMIC_IND]

    DCM product type (FIX Tag 460 / WS p). Finer-grained classification than product_type.

    security_type string

    DCM security type (FIX Tag 167 / WS tp).

    security_sub_type string

    DCM security sub-type (FIX Tag 762 / WS subtp). Omitted when not applicable.

  • ]