> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kraken.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Ticker

> Subscribe to ticker information about listed products

<div className="api-banner">
  <span className="api-protocol ws">WSS</span>
  <span className="api-detail">futures.kraken.com/ws/v1</span>
  <span className="api-tag">ticker</span>
</div>

The `ticker` feed returns ticker information about listed products. Only tradeable markets are available via individual WebSocket market data feeds. Delta messages are throttled such that they are published every 1s.

***

## Request

<ResponseField name="event" type="string" required>
  `subscribe` or `unsubscribe`
</ResponseField>

<ResponseField name="feed" type="string" required>
  The requested subscription feed. Value: `ticker`
</ResponseField>

<ResponseField name="product_ids" type="list of strings" required>
  A list of strings which represent the products that user will receive information upon.
</ResponseField>

<CodeGroup>
  ```json Example theme={null}
  {
    "event": "subscribe",
    "feed": "ticker",
    "product_ids": ["PF_XBTUSD"]
  }
  ```
</CodeGroup>

***

## Response Success

<ResponseField name="event" type="string">
  <span className="field-attr">One of:</span> `subscribed`, `subscribed_failed`, `unsubscribed`, `unsubscribed_failed`

  The result.
</ResponseField>

<ResponseField name="feed" type="string">
  The requested subscription feed. Value: `ticker`
</ResponseField>

<ResponseField name="product_ids" type="list of strings" required>
  A list of strings which represent the products that user will receive information upon.
</ResponseField>

<CodeGroup>
  ```json Example theme={null}
  {
    "event": "subscribed",
    "feed": "ticker",
    "product_ids": ["PF_XBTUSD"]
  }
  ```
</CodeGroup>

***

## Response Snapshot

The subscription data will return values for all fields even if the value of only a single field has changed since the last payload.

<ResponseField name="time" type="positive integer">
  The UTC time of the server in milliseconds.
</ResponseField>

<ResponseField name="product_id" type="string">
  The subscribed product (referred also as instrument or symbol).
</ResponseField>

<ResponseField name="funding_rate" type="float">
  The current funding rate. If zero, field is not populated. (Perpetuals only)
</ResponseField>

<ResponseField name="funding_rate_prediction" type="float">
  The estimated next funding rate. If zero, field is not populated. (Perpetuals only)
</ResponseField>

<ResponseField name="relative_funding_rate" type="float">
  The absolute funding rate relative to the spot price at the time of funding rate calculation. If zero, field is not populated. (Perpetuals only)
</ResponseField>

<ResponseField name="relative_funding_rate_prediction" type="float">
  The estimated next absolute funding rate relative to the current spot price. If zero, field is not populated. (Perpetuals only)
</ResponseField>

<ResponseField name="next_funding_rate_time" type="float">
  The time until next funding rate in milliseconds. (Perpetuals only)
</ResponseField>

<ResponseField name="feed" type="string">
  The subscribed feed.
</ResponseField>

<ResponseField name="bid" type="positive float">
  The price of the current best bid.
</ResponseField>

<ResponseField name="ask" type="positive float">
  The price of the current best ask.
</ResponseField>

<ResponseField name="bid_size" type="positive float">
  The size of the current best bid.
</ResponseField>

<ResponseField name="ask_size" type="positive float">
  The size of the current best ask.
</ResponseField>

<ResponseField name="volume" type="positive float">
  The sum of the sizes of all fills observed in the last 24 hours.
</ResponseField>

<ResponseField name="dtm" type="positive integer">
  The days until maturity.
</ResponseField>

<ResponseField name="leverage" type="string">
  The leverage of the product.
</ResponseField>

<ResponseField name="index" type="positive float">
  The real time index of the product.
</ResponseField>

<ResponseField name="last" type="positive float">
  The price of the last fill.
</ResponseField>

<ResponseField name="change" type="float">
  The 24h change in price.
</ResponseField>

<ResponseField name="suspended" type="boolean">
  True if the market is suspended.
</ResponseField>

<ResponseField name="tag" type="string">
  Currently can be `perpetual`, `month` or `quarter`. Other tags may be added without notice.
</ResponseField>

<ResponseField name="pair" type="string">
  The currency pair of the instrument.
</ResponseField>

<ResponseField name="openInterest" type="float">
  The current open interest of the instrument.
</ResponseField>

<ResponseField name="markPrice" type="float">
  The market price of the instrument.
</ResponseField>

<ResponseField name="maturityTime" type="positive integer">
  The UTC time, in milliseconds, at which the contract will stop trading.
</ResponseField>

<ResponseField name="post_only" type="boolean">
  True if the market is in post-only.
</ResponseField>

<ResponseField name="volumeQuote" type="positive float">
  The same as `volume` except that, for multi-collateral futures, it is converted to the non-base currency.
</ResponseField>

<ResponseField name="open" type="positive float">
  The first traded price in the last 24h.
</ResponseField>

<ResponseField name="high" type="positive float">
  The highest traded price in the last 24h.
</ResponseField>

<ResponseField name="low" type="positive float">
  The lowest traded price in the last 24h.
</ResponseField>

<ResponseField name="premium" type="float">
  The current premium (percentage difference between the futures price and the index price).
</ResponseField>

<ResponseField name="greeks" type="structure">
  The current Greeks, if this is an option.

  <Expandable title="properties">
    <ResponseField name="iv" type="float">The option's implied volatility.</ResponseField>
    <ResponseField name="delta" type="float">Delta, the option value's sensitivity to change in the underlying price.</ResponseField>
    <ResponseField name="theta" type="float">Theta, the option value's sensitivity to the passage of time.</ResponseField>
    <ResponseField name="gamma" type="float">Gamma, delta's sensitivity to change in the underlying price.</ResponseField>
    <ResponseField name="vega" type="float">Vega, the option value's sensitivity to change in volatility.</ResponseField>
    <ResponseField name="rho" type="float">Rho, the option value's sensitivity to the interest rate.</ResponseField>
  </Expandable>
</ResponseField>

<CodeGroup>
  ```json Example: Futures Snapshot theme={null}
  {
    "time": 1676393235406,
    "product_id": "PF_XBTUSD",
    "funding_rate": -6.2604214e-11,
    "funding_rate_prediction": -3.65989977e-10,
    "relative_funding_rate": -1.380384722222e-6,
    "relative_funding_rate_prediction": -8.047629166667e-6,
    "next_funding_rate_time": 1676394000000,
    "feed": "ticker",
    "bid": 21978.5,
    "ask": 21987.0,
    "bid_size": 2536.0,
    "ask_size": 13948.0,
    "volume": 31403908.0,
    "dtm": 0,
    "leverage": "50x",
    "index": 21984.54,
    "premium": -0.0,
    "last": 21983.5,
    "change": 1.9974017538161748,
    "suspended": false,
    "tag": "perpetual",
    "pair": "XBT:USD",
    "openInterest": 30072580.0,
    "markPrice": 21979.68641534714,
    "maturityTime": 0,
    "post_only": false,
    "volumeQuote": 31403908.0,
    "open": 21968.5,
    "high": 22123.0,
    "low": 21456.0
  }
  ```

  ```json Example: Options Snapshot theme={null}
  {
    "time": 1676393235406,
    "product_id": "OF_ETHUSD_240101_1000_C",
    "feed": "ticker",
    "bid": 21978.5,
    "ask": 21987.0,
    "bid_size": 2536.0,
    "ask_size": 13948.0,
    "volume": 31403908.0,
    "dtm": 0,
    "index": 21984.54,
    "last": 21983.5,
    "change": 1.9974017538161748,
    "suspended": false,
    "tag": "month",
    "pair": "ETH:USD",
    "openInterest": 30072580.0,
    "markPrice": 100.68641534714,
    "maturityTime": 1676393235406,
    "post_only": false,
    "volumeQuote": 31403908.0,
    "greeks": {
      "iv": 0.3,
      "delta": 0.5,
      "gamma": 0.5,
      "vega": 0.5,
      "theta": 0.5,
      "rho": 0.5
    }
  }
  ```
</CodeGroup>

***

## Response Error

<ResponseField name="event" type="string">
  Value: `error`
</ResponseField>

<ResponseField name="message" type="string">
  <span className="field-attr">One of:</span> `Invalid product id`, `Invalid feed`, `Json Error`

  An error message.
</ResponseField>

<CodeGroup>
  ```json Example theme={null}
  {
    "event": "error",
    "message": "Invalid product id"
  }
  ```
</CodeGroup>