Docs
Tempest/API Reference/Tempest

Implied-volatility term structure per symbol

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

The symbol's implied-volatility term structure: one row per listed expiry used (days to expiry and the implied vol there), for contango/backwardation reads. The headline slope and curve state are in /v1/vol/iv. Optional term.earnings_context describes scheduled earnings exposure in the calendar-day 9-day and 30-day readings. overlap_9d and overlap_30d are none (before the known report), partial (spans the report), full (includes it), or null (unavailable). A report beyond nine days can already overlap the 9-day reading. This does not attribute premium or predict a flip. date and timing (bmo / amc) describe the recorded report, which can change; within_9d is nullable. status is scheduled, limited, calendar_unavailable, no_report, timing_unknown, or report_passed. Missing fields and nulls must not be treated as none. Response: data.symbols[] has symbol, asOf, sessionDate, stale and term. 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?