Docs
Tempest/API Reference/Tempest

Expected-move cones per symbol

GEThttps://api.skylit.ai/v1/vol/cones

Tempest Cones: the move the options market prices for each horizon (close, 1d, week, opex, 30d), as 1-sigma percent and price bands around spot (from implied variance), plus the level set drawn on the chart. A horizon that does not exist at that moment (the close horizon after hours) is null. Two different questions. horizons[] is priced from the current spot: how much further options price the move from now to each settle. It moves with price, so it is not a budget to measure a move against. levels[] is priced at a past close and does not move intraday: read how far a move has gone against hi1 / lo1 (1-sigma) and hi2 / lo2 (2-sigma).

Levels (levels[]): day (the prior close, to today's close), week (last week's final close, to this week's last close) and month (the last monthly options expiration's close, to the next monthly expiration's close). Each has name, label, anchor, priced_at, until, em1_pct and hi1/lo1/hi2/lo2. A level is absent when its anchor close has no reading.

Per horizon (horizons[]): name, minutes to the settle, em1_pct (1-sigma, % of spot), em1 / em2 (1- and 2-sigma in price), realized_em_pct (20-day realized vol over the same span). Optional, null when not available, and absent on older readings:

  • up1_pct, dn1_pct, up2_pct, dn2_pct: the move to each side in % of spot as the options' skew prices it (put skew makes the downside wider). Null: read em1_pct both ways.
  • tail_src: how the 2-sigma sides were read: quantile (from the fitted smile, within the quoted strikes) or wing (twice the 1-sigma side, which understates a steep tail).
  • skew_expiry: the expiration whose smile set that shape.
  • events[]: scheduled events inside the horizon (after asOf, at or before the settle), each {kind, label, at, timing, jump_pct, var_share}: kind is earnings, fomc, cpi or nfp; at is the ISO-8601 instant it is modelled at; earnings add timing (bmo / amc), jump_pct (the report's own implied move, %) and var_share (the share of the horizon's priced variance that is the report, 0-1).
  • event_adjusted: true when this horizon's move includes an earnings report. Response: data.symbols[] has symbol, asOf, sessionDate, stale and cones. Symbols Tempest does not cover are listed in data.missing. Cost: 1 credit per call (up to 10 symbols).

Authorization

Authorization: Bearer <your API key>

Required. A missing header returns 401; an invalid, revoked or expired key returns 403.

Query parameters

  • symbolsstringrequired

    Comma-separated Tempest symbols (up to 10). Tempest keys the S&P complex on the option root SPXW and Nasdaq-100 on NDXP; see /v1/vol/symbols.

Responses

  • 200

    OK.

  • 400

    Request validation failed.

  • 401

    Missing API key (unauthorized), sent by the gateway.

  • 402

    Out of credits (insufficient_credits).

  • 403

    As Forbidden, or not_entitled: Tempest data is not enabled for this account (it is in preview). Refunded.

  • 404

    Unknown symbol, no data available, or none of the requested expirations exist for the symbol (code: expiration_not_found).

  • 429

    Per-minute rate limit exceeded.

  • 503

    Tempest data is loading (warming_up, with Retry-After) or not configured (unavailable). Refunded.

  • 504

    The request did not finish in time (gateway_timeout). Refunded; retry, or narrow the request.

Response fields

  • dataobjectrequired
    • symbolsobject[]required
    • missingobject[]required
  • metaobjectrequired
    • modulestringrequired

      Which endpoint answered (iv, cones, screener, ...).

    • asOfstringdate-time

      When Tempest computed the newest value in this response.

    • sessionDatestringdate

      The trading session (ET) that asOf belongs to. The close state is stamped 15:59 ET and always belongs to its own session.

    • marketStatestringrequired

      US equity session at request time.

      pre_openopenpost_closeclosed
    • frozenbooleanrequired

      True while Tempest serves the previous close (outside regular hours).

    • publishedAtstringdate-time

      When Tempest last published to the API.

    • cachedbooleanrequired
    • attributionobject

      Whether and how this response's data may be published. See /legal/api#sharing. An Agent or MCP client should never publish data where shareable is false, regardless of shareClass. required, license, shareable and shareClass are always sent on /v1/options/* and absent from the short form.

Last updated

Was this page helpful?