---
title: Skew
description: Option summary skew via the Kiyotaka Data API. Advanced tier only.
---

# Skew

<EndpointBar method="GET" path="/v1/points"></EndpointBar>

<TypeHeader type="SKEW_OPTION_SUMMARY_AGG" meta="Weight: 1x | Max points: 100,000 | Advanced only"></TypeHeader>

Skew summary data for option markets. The current public API shape is a single summary series selected by `exchange`, `coin`, `rawSymbol`, and `tenor`.
In practice this is useful for option summary series such as `BTC_25`, where the raw symbol selects the skew flavor and the tenor selects the expiry bucket.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `exchange` | string | Yes | Use the option venue that exposes the summary series. The current public example uses `DERIBIT`. |
| `coin` | string | Yes | Underlying asset, for example `BTC`. |
| `rawSymbol` | string | Yes | Summary symbol, for example `BTC_25`. |
| `tenor` | Tenor | Yes | Option summary tenor, for example `ONE_W`. |

<Callout kind="note">

Use `GET /v1/markets` to discover available summary symbols and tenors before querying.

</Callout>

## Response fields

| Field | Type | Description |
| --- | --- | --- |
| `skew` | double | Skew summary value for the requested series |
| `timestamp` | Timestamp | Start of the returned interval bucket |

## Capabilities

| Feature | Supported | Details |
| --- | --- | --- |
| Summary series queries | Yes | Query by `exchange`, `coin`, `rawSymbol`, and `tenor` |
| Multi-exchange aggregation | No |  |

## Examples

### One-week BTC skew

Fetches 7 days of daily BTC skew data for the one-week tenor.

<CodeTabs>

<CodePanel lang="curl">
<pre><span class="s-f">curl</span> <span class="s-s">"https://api.kiyotaka.ai/v1/points</span>
    <span class="s-p">?type</span>=<span class="s-s">SKEW_OPTION_SUMMARY_AGG</span>
    <span class="s-p">&amp;exchange</span>=<span class="s-s">DERIBIT</span>
    <span class="s-p">&amp;coin</span>=<span class="s-s">BTC</span>
    <span class="s-p">&amp;rawSymbol</span>=<span class="s-s">BTC_25</span>
    <span class="s-p">&amp;tenor</span>=<span class="s-s">ONE_W</span>
    <span class="s-p">&amp;interval</span>=<span class="s-s">DAY</span>
    <span class="s-p">&amp;from</span>=<span class="s-n">1775635290</span>
    <span class="s-p">&amp;period</span>=<span class="s-n">604800</span><span class="s-s">"</span> \\
  <span class="s-k">-H</span> <span class="s-s">"X-Kiyotaka-Key: YOUR_API_KEY"</span></pre>
</CodePanel>

<CodePanel lang="python">
<pre><span class="s-k">import</span> <span class="s-v">requests</span>
&#10;
<span class="s-v">response</span> = requests.<span class="s-f">get</span>(
    <span class="s-s">"https://api.kiyotaka.ai/v1/points?type=SKEW_OPTION_SUMMARY_AGG&exchange=DERIBIT&coin=BTC&rawSymbol=BTC_25&tenor=ONE_W&interval=DAY&from=1775635290&period=604800"</span>,
    headers={<span class="s-s">"X-Kiyotaka-Key"</span>: <span class="s-s">"YOUR_API_KEY"</span>}
)
<span class="s-v">data</span> = response.<span class="s-f">json</span>()</pre>
</CodePanel>

<CodePanel lang="javascript">
<pre><span class="s-k">const</span> <span class="s-v">response</span> = <span class="s-k">await</span> <span class="s-f">fetch</span>(
  <span class="s-s">"https://api.kiyotaka.ai/v1/points?type=SKEW_OPTION_SUMMARY_AGG&exchange=DERIBIT&coin=BTC&rawSymbol=BTC_25&tenor=ONE_W&interval=DAY&from=1775635290&period=604800"</span>,
  { headers: { <span class="s-s">"X-Kiyotaka-Key"</span>: <span class="s-s">"YOUR_API_KEY"</span> } }
)
<span class="s-k">const</span> <span class="s-v">data</span> = <span class="s-k">await</span> response.<span class="s-f">json</span>()</pre>
</CodePanel>

</CodeTabs>

### Response

<CodeBlock lang="JSON">
<pre>{
  <span class="s-p">"series"</span>: [
    {
      <span class="s-p">"id"</span>: {
        <span class="s-p">"type"</span>: <span class="s-s">"SKEW_OPTION_SUMMARY_AGG"</span>,
        <span class="s-p">"exchange"</span>: <span class="s-s">"DERIBIT"</span>,
        <span class="s-p">"rawSymbol"</span>: <span class="s-s">"BTC_25"</span>,
        <span class="s-p">"normalizedSymbol"</span>: <span class="s-s">"BTC"</span>,
        <span class="s-p">"category"</span>: <span class="s-s">"OPTION"</span>,
        <span class="s-p">"interval"</span>: <span class="s-s">"DAY"</span>,
        <span class="s-p">"tenor"</span>: <span class="s-s">"ONE_W"</span>,
        <span class="s-p">"coin"</span>: <span class="s-s">"BTC"</span>
      },
      <span class="s-p">"points"</span>: [
        {
          <span class="s-p">"Point"</span>: {
            <span class="s-p">"skew"</span>: <span class="s-n">9.71701017415855</span>,
            <span class="s-p">"timestamp"</span>: { <span class="s-p">"s"</span>: <span class="s-n">1775692800</span> }
          }
        }
      ]
    }
  ]
}</pre>
</CodeBlock>