# Real-Time Data

This page provides comprehensive details on real-time data for derivatives available in our system. In today's complex financial environment, having access to real-time data on derivatives is crucial for businesses to navigate the market, react to rapid changes, and maintain a competitive position.

## What is Derivs Real-Time Data?

Derivs real-time data refers to the live data related to various financial derivatives in the market, such as options, futures, swaps, and more. This data is indispensable for traders, analysts, and financial institutions to make immediate and informed trading decisions. It covers metrics such as current derivative prices, volume, implied volatility, and other vital indicators.

## List of Requests

## Futures Live Data

<mark style="color:blue;">`GET`</mark> `https://api.laevitas.ch/analytics/derivs/futures/{market}/{currency}/{maturity}`

N/A

#### Path Parameters

| Name                                       | Type   | Description                                                                                                                                                          |
| ------------------------------------------ | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| market<mark style="color:red;">\*</mark>   | string | N/A example: DERIBIT, AEVO, BINANCE, BITFINEX, BITGET, BITMEX, BYBIT, COINBASE, DYDX, HUOBI, HYPERLIQUID, KRAKEN, OKX, PARADEX                                       |
| currency<mark style="color:red;">\*</mark> | string | Check analytics/futures/alt\_currency For more information about available currencies example: BTC, ADA, BCH, BNB, BTCDVOL, DOT, ETH, LINK, LTC, PAXG, SOL, TRX, XRP |
| maturity<mark style="color:red;">\*</mark> | string | Check analytics/futures/instruments for more information about available maturity example: 29DEC23, 30JUN23                                                          |

{% tabs %}
{% tab title="200: OK example route : /analytics/derivs/futures/DERIBIT/BTC/12SEP25" %}
[swagger link](https://api.laevitas.ch/swagger/#/Analytics%20Options/futures)

```json
{
  "date": 1757406060,
  "data": [
    {
      "symbol": "BTC-12SEP25",
      "base_currency": "BTC",
      "margin": "coin",
      "index_price": 112918.75,
      "price": 113021.04,
      "basis": 0.091,
      "apy": 11.07,
      "open_interest": 38409190,
      "open_interest_coin": 339.84,
      "oi_volume24h": 1.601,
      "volume24h": 23997191.37,
      "volume24h_coin": 212.52,
      "bid": 113025,
      "ask": 113027.5,
      "bid_amount": 30,
      "ask_amount": 170330,
      "liquidations": {
        "short": 0,
        "long": 0
      }
    }
  ]
}
```

{% endtab %}
{% endtabs %}

## Perpetual Swaps Live Data

<mark style="color:blue;">`GET`</mark> `https://api.laevitas.ch/analytics/derivs/perpetuals/{market}/{currency}`

N/A

#### Path Parameters

| Name                                       | Type   | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| ------------------------------------------ | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| market<mark style="color:red;">\*</mark>   | string | N/A example: DERIBIT, AEVO, BINANCE, BITFINEX, BITGET, BITMEX, BYBIT, COINBASE, DYDX, HUOBI, HYPERLIQUID, KRAKEN, OKX, PARADEX                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| currency<mark style="color:red;">\*</mark> | string | Check analytics/futures/alt\_currency For more information about available currencies example: BTC, 1INCH, A, A2Z, A8, AAPL, AAVE, ACE, ACH, ACT, ACX, ADA, AERGO, AERO, AEVO, AGI, AGIX, AGLD, AGT, AI, AI16Z, AIDOGE, AIN, AIO, AIOT, AIOZ, AITECH, AIXBT, AKT, ALCH, ALEO, ALG, ALGO, ALICE, ALL, ALPACA, ALPHA, ALPINE, ALT, ALU, AMP, AMPL, AMZN, ANIME, ANKR, APE, API3, APT, APU, AR, ARB, ARC, ARIA, ARK, ARKM, ARM, ARPA, ASML, ASP, ASR, ASTR, ATA, ATH, ATOM, AUCTION, AUD, AUDIO, AURORA, AUSTRALIA200IX, AVA, AVAAI, AVAIL, AVAX, AVL, AWE, AXL, AXS, B, B2, B3, BABA, BABY, BABYDOGE, BADGER, BAKE, BAN, BANANA, BANANAS31, BAND, BANK, BAS, BAT, BB, BCH, BCUT, BDXN, BEAM, BEL, BERA, BGB, BGSC, BICO, BID, BIGTIME, BIO, BITCOIN, BLAST, BLUE, BLUR, BLZ, BMEX, BMT, BNB, BNT, BOB, BOBA, BODEN, BOME, BONK, BR, BRETT, BROCCOLI, BROCCOLI714, BROCCOLIF3B, BSU, BSV, BSW, BTCDOM, BTR, BTRUMP, BTT, BULLA, BVIV, C, C98, CAKE, CAMP, CANTO, CARV, CAT, CATI, CELO, CELR, CETUS, CFX, CGPT, CHEEMS, CHESS, CHF, CHILLGUY, CHR, CHZ, CIG, CKB, CLANKER, CLOUD, CLV, COIN, COIN50, COMP, COOK, COOKIE, COQ, CORE, COS, COTI, COW, CPOOL, CRCL, CRO, CROSS, CRV, CTC, CTK, CTSI, CUDIS, CVC, CVX, CYBER, D, DAI, DAKU, DAM, DASH, DBR, DEEP, DEGEN, DEGO, DENT, DEXE, DF, DFDV, DGB, DIA, DINNER, DMAIL, DMC, DODO, DOG, DOGE, DOGS, DOLO, DOOD, DOT, DRIFT, DUCK, DUSK, DYDX, DYM, EDGE, EDU, EGLD, EIGEN, ELON, ELX, ENA, ENJ, ENS, EOS, EPIC, EPT, ERA, ES, ESPORTS, ETC, ETH, ETHBTC, ETHFI, ETHW, EUR, EURC, EUROPE50IX, EVIV, F, FAI, FARTCOIN, FET, FHE, FIDA, FIL, FIO, FIS, FLM, FLOCK, FLOKI, FLOW, FLR, FLUX, FORM, FORTH, FOXY, FRAG, FRANCE40IX, FRIEND, FTM, FTT, FUEL, FUN, FWOG, FXS, G, GALA, GAS, GBP, GERMANY40IX, GHST, GIGA, GLM, GLMR, GME, GMT, GMX, GNO, GOAT, GODS, GOOGL, GORK, GPS, GRASS, GRIFFAIN, GRT, GTC, GUN, H, HAEDAL, HAWKTUAH, HBAR, HEI, HEMI, HFT, HIFI, HIGH, HIPPO, HIVE, HMSTR, HNT, HOME, HONGKONG50IX, HOOD, HOOK, HOT, HOUSE, HPOS, HPOS10I, HUMA, HYPE, HYPER, IBM, ICNT, ICP, ICX, ID, IDEX, IDOL, IKA, ILV, IMX, IN, INIT, INJ, INTC, IO, IOST, IOTA, IOTX, IP, J, JAPAN225IX, JASMY, JELLYJELLY, JOE, JPY, JST, JTO, JUP, K, KAIA, KAITO, KAS, KAVA, KDA, kDOGS, KERNEL, kFLOKI, kLUNC, KMNO, KNC, kNEIRO, KOMA, KRL, KSM, L3, LA, LADYS, LAUNCHCOIN, LAYER, LDO, LEVER, LINEA, LINK, LISTA, LOOKS, LOOM, LOT, LOUD, LPT, LQTY, LRC, LSK, LTC, LUCE, LUMIA, LUNA2, LUNC, M, MAD, MAGIC, MAJOR, MANA, MANTA, MANTLE, MASA, MASK, MATIC, MAV, MAVIA, MBOX, MCD, MDT, ME, MELANIA, MEME, MEMEFI, MERL, META, METIS, MEW, MGO, MICHI, MILK, MINA, MITO, MKR, MLN, MNRY, MNT, MOCA, MOG, MOODENG, MOONPIG, MORPHO, MOTHER, MOVE, MOVR, MSTR, MTL, MUBARAK, MVL, MYRIA, MYRO, MYX, NAORIS, NAVX, NC, NEAR, NEIRO, NEIROETH, NEO, NEWT, NFP, NFT, NFTI, NIL, NKN, NMR, NODE, NOT, NS, NTRN, NVDA, NXPC, OBOL, OBT, OCEAN, OG, OGN, OKB, OL, OM, OMNI, ONDO, ONE, ONG, ONT, OP, OPEN, ORBS, ORCA, ORDER, ORDI, OSMO, OX, OXT, PAIN, PANDORA, PARTI, PAXG, PEAQ, PEIPEI, PENDLE, PENGU, PEOPLE, PEPE, PERP, PHA, PHB, PI, PIPPIN, PIRATE, PIXEL, PLAY, PLUME, PNUT, POKT, POL, POLYX, PONKE, POPCAT, PORT3, PORTAL, POWR, POWSCHE, PRCL, PRIME, PROM, PROMPT, PROVE, PTB, PUFFER, PUMP, PUMPBTC, PUMPFUN, PUNDIX, PURR, PYR, PYTH, Q, QI, QNT, QTUM, QUBIC, QUICK, RAD, RARE, RATS, RAY, RDNT, RED, REI, REN, RENDER, REQ, RESOLV, RETARDIO, REX, REZ, RFC, RHEA, RIF, RLB, RLC, RNDR, ROAM, RON, RONIN, ROSE, RPL, RSR, RSS3, RUNE, RVN, S, SAFE, SAGA, SAHARA, SAND, SANTOS, SAPIEN, SAROS, SATS, SC, SCA, SCR, SCRT, SD, SDM, SEI, SEND, SERAPH, SFP, SHELL, SHIA, SHIB, SIGN, SIREN, SKATE, SKITTEN, SKL, SKY, SKYAI, SLERF, SLF, SLP, SNT, SNX, SOL, SOLO, SOLV, SOMI, SONIC, SOON, SOPH, SOSO, SPAIN35IX, SPEC, SPELL, SPK, SPX, SQD, SSV, STEEM, STG, STO, STORJ, STRAX, STRK, STX, SUI, SUN, SUNDOG, SUPER, SUSHI, SWARMS, SWEAT, SWELL, SXP, SXT, SYN, SYRUP, SYS, T, TA, TAC, TAG, TAI, TAIKO, TAKE, TANSSI, TAO, THE, THETA, TIA, TIBBIR, TKO, TLM, TLOS, TNSR, TOKEN, TON, TOSHI, TOWNS, TRB, TREE, TREMP, TROY, TRU, TRUMP, TRUMPOFFICIAL, TRUMPWIN, TRX, TRY, TSLA, TSLAX, TST, TSTBSC, TURBO, TUT, TWT, U, UK100IX, UKOIL, UMA, UNI, UNIBOT, USD1, USDC, USDE, USDT, USELESS, USTC, USUAL, UXLINK, VANA, VANRY, VELO, VELODROME, VELVET, VET, VIC, VINE, VIRTUAL, VOXEL, VR, VRTX, VTHO, VVV, W, WAL, WAVES, WAXP, WBTC, WCT, WELL, WEN, WHY, WIF, WIN, WLD, WLFI, WOO, WSTETH, X, XAG, XAI, XAUT, XCH, XCN, XCX, XDC, XEC, XEM, XION, XLM, XMR, XNO, XNY, XPD, XPL, XPT, XRP, XTER, XTZ, XVG, XVS, XYO, YALA, YFI, YGG, YZY, ZBCN, ZEC, ZEN, ZENT, ZEREBRO, ZERO, ZETA, ZEUS, ZIL, ZK, ZKJ, ZORA, ZRC, ZRO, ZRX |

{% tabs %}
{% tab title="200: OK example route : /analytics/derivs/perpetuals/DERIBIT/BTC" %}
[swagger link](https://api.laevitas.ch/swagger/#/Analytics%20Options/perpetuals)

```json
{
  "date": 1757405760,
  "data": [
    {
      "symbol": "BTC_USDC-PERPETUAL",
      "base_currency": "BTC",
      "margin": "usd",
      "market_cap": 2250861688202,
      "index_price": 113038.98,
      "price": 113065.34,
      "basis": 0.023,
      "funding": 0.0025,
      "next_funding": 0,
      "apy": 2.74,
      "open_interest": 31890712.31,
      "open_interest_coin": 282.06,
      "oi_volume24h": 1.292,
      "volume24h": 24686571.54,
      "volume24h_coin": 218.39,
      "bid": 113070,
      "ask": 113070.5,
      "bid_amount": 0.1259,
      "ask_amount": 0.2317,
      "liquidations": {
        "short": 0,
        "long": 0
      },
      "long_short_ratio": 0,
      "realized_vol": {
        "3": 19.6,
        "7": 34.91,
        "30": 34.32,
        "60": 32.31,
        "90": 32.45,
        "180": 37.55,
        "270": 45.23,
        "365": 45.98
      },
      "avg_apr": {
        "1": 2.9541,
        "3": 1.5755,
        "7": 1.0322,
        "30": 7.3586,
        "60": 0,
        "90": 6.0049,
        "180": 0,
        "270": 0,
        "365": 5.507
      }
    }
  ]
}
```

{% endtab %}
{% endtabs %}

## Aggregated Perps Summary

<mark style="color:blue;">`GET`</mark> `https://api.laevitas.ch/analytics/derivs/summary/{currency}`

N/A

#### Path Parameters

| Name                                       | Type   | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| ------------------------------------------ | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| currency<mark style="color:red;">\*</mark> | string | Check analytics/futures/alt\_currency For more information about available currencies example: BTC, 1INCH, A, A2Z, A8, AAPL, AAVE, ACE, ACH, ACT, ACX, ADA, AERGO, AERO, AEVO, AGI, AGLD, AGT, AI, AI16Z, AIDOGE, AIN, AIO, AIOT, AIOZ, AIXBT, AKT, ALCH, ALEO, ALG, ALGO, ALICE, ALL, ALPHA, ALPINE, ALT, ALU, AMP, AMZN, ANIME, ANKR, APE, API3, APT, APU, AR, ARB, ARC, ARIA, ARK, ARKM, ARM, ARPA, ASML, ASP, ASR, ASTR, ATA, ATH, ATOM, AUCTION, AUDIO, AUSTRALIA200IX, AVA, AVAAI, AVAIL, AVAX, AVL, AWE, AXL, AXS, B, B2, B3, BABA, BABY, BABYDOGE, BADGER, BAKE, BAN, BANANA, BANANAS31, BAND, BANK, BAS, BAT, BB, BCH, BDXN, BEAM, BEL, BERA, BGB, BGSC, BICO, BID, BIGTIME, BIO, BLAST, BLUE, BLUR, BMEX, BMT, BNB, BNT, BOB, BOBA, BOME, BONK, BR, BRETT, BROCCOLI, BROCCOLI714, BROCCOLIF3B, BSU, BSV, BSW, BTCDOM, BTR, BTT, BULLA, BVIV, C, C98, CAKE, CAMP, CARV, CAT, CATI, CELO, CELR, CETUS, CFX, CGPT, CHEEMS, CHESS, CHILLGUY, CHR, CHZ, CKB, CLANKER, CLOUD, COIN, COIN50, COMP, COOK, COOKIE, COQ, CORE, COS, COTI, COW, CPOOL, CRCL, CRO, CROSS, CRV, CTC, CTK, CTSI, CUDIS, CVC, CVX, CYBER, D, DAM, DASH, DBR, DEEP, DEGEN, DEGO, DENT, DEXE, DF, DFDV, DGB, DIA, DMC, DODO, DOG, DOGE, DOGS, DOLO, DOOD, DOT, DRIFT, DUCK, DUSK, DYDX, DYM, EDGE, EDU, EGLD, EIGEN, ELON, ELX, ENA, ENJ, ENS, EPIC, EPT, ERA, ES, ESPORTS, ETC, ETH, ETHBTC, ETHFI, ETHW, EUR, EURC, EUROPE50IX, EVIV, F, FAI, FARTCOIN, FET, FHE, FIDA, FIL, FIO, FIS, FLM, FLOCK, FLOKI, FLOW, FLR, FLUX, FORM, FORTH, FRAG, FRANCE40IX, FTT, FUEL, FUN, FWOG, FXS, G, GALA, GAS, GBP, GERMANY40IX, GHST, GIGA, GLM, GLMR, GME, GMT, GMX, GNO, GOAT, GODS, GOOGL, GORK, GPS, GRASS, GRIFFAIN, GRT, GTC, GUN, H, HAEDAL, HBAR, HEI, HEMI, HFT, HIFI, HIGH, HIPPO, HIVE, HMSTR, HNT, HOME, HONGKONG50IX, HOOD, HOOK, HOT, HOUSE, HPOS10I, HUMA, HYPE, HYPER, IBM, ICNT, ICP, ICX, ID, IDEX, IDOL, IKA, ILV, IMX, IN, INIT, INJ, INTC, IO, IOST, IOTA, IOTX, IP, J, JAPAN225IX, JASMY, JELLYJELLY, JOE, JPY, JST, JTO, JUP, K, KAIA, KAITO, KAS, KAVA, KDA, KERNEL, kFLOKI, kLUNC, KMNO, KNC, kNEIRO, KOMA, KSM, L3, LA, LADYS, LAUNCHCOIN, LAYER, LDO, LEVER, LINEA, LINK, LISTA, LOOKS, LPT, LQTY, LRC, LSK, LTC, LUMIA, LUNA2, LUNC, M, MAGIC, MAJOR, MANA, MANTA, MANTLE, MASA, MASK, MAV, MAVIA, MBOX, MCD, MDT, ME, MELANIA, MEME, MEMEFI, MERL, META, METIS, MEW, MILK, MINA, MITO, MKR, MLN, MNT, MOCA, MOG, MOODENG, MOONPIG, MORPHO, MOVE, MOVR, MSTR, MTL, MUBARAK, MVL, MYRIA, MYRO, MYX, NAORIS, NAVX, NEAR, NEIRO, NEIROETH, NEO, NEWT, NFP, NIL, NKN, NMR, NODE, NOT, NS, NTRN, NVDA, NXPC, OBOL, OBT, OG, OGN, OKB, OL, OM, OMNI, ONDO, ONE, ONG, ONT, OP, OPEN, ORBS, ORCA, ORDER, ORDI, OSMO, OXT, PARTI, PAXG, PEAQ, PEIPEI, PENDLE, PENGU, PEOPLE, PEPE, PERP, PHA, PHB, PI, PIPPIN, PIXEL, PLAY, PLUME, PNUT, POL, POLYX, PONKE, POPCAT, PORT3, PORTAL, POWR, PRCL, PRIME, PROM, PROMPT, PROVE, PTB, PUFFER, PUMP, PUMPBTC, PUMPFUN, PUNDIX, PURR, PYR, PYTH, Q, QI, QNT, QTUM, QUBIC, QUICK, RAD, RARE, RATS, RAY, RDNT, RED, REI, RENDER, REQ, RESOLV, REX, REZ, RFC, RHEA, RIF, RLC, ROAM, RON, RONIN, ROSE, RPL, RSR, RSS3, RUNE, RVN, S, SAFE, SAGA, SAHARA, SAND, SANTOS, SAPIEN, SAROS, SATS, SC, SCA, SCR, SCRT, SD, SEI, SEND, SERAPH, SFP, SHELL, SHIB, SIGN, SIREN, SKATE, SKL, SKY, SKYAI, SLERF, SLF, SLP, SNT, SNX, SOL, SOLO, SOLV, SOMI, SONIC, SOON, SOPH, SOSO, SPAIN35IX, SPEC, SPELL, SPK, SPX, SQD, SSV, STEEM, STG, STO, STORJ, STRK, STX, SUI, SUN, SUNDOG, SUPER, SUSHI, SWARMS, SWEAT, SWELL, SXP, SXT, SYN, SYRUP, SYS, T, TA, TAC, TAG, TAI, TAIKO, TAKE, TANSSI, TAO, THE, THETA, TIA, TLM, TNSR, TOKEN, TON, TOSHI, TOWNS, TRB, TREE, TRU, TRUMP, TRUMPOFFICIAL, TRX, TRY, TSLA, TST, TSTBSC, TURBO, TUT, TWT, U, UKOIL, UMA, UNI, USD1, USDC, USDE, USELESS, USTC, USUAL, UXLINK, VANA, VANRY, VELO, VELODROME, VELVET, VET, VIC, VINE, VIRTUAL, VOXEL, VR, VTHO, VVV, W, WAL, WAVES, WAXP, WCT, WEN, WHY, WIF, WIN, WLD, WLFI, WOO, X, XAG, XAI, XAUT, XCH, XCN, XCX, XDC, XEC, XEM, XION, XLM, XMR, XNO, XNY, XPD, XPL, XPT, XRP, XTER, XTZ, XVG, XVS, YALA, YFI, YGG, YZY, ZBCN, ZEC, ZEN, ZENT, ZEREBRO, ZETA, ZEUS, ZIL, ZK, ZKJ, ZORA, ZRC, ZRO, ZRX |

{% tabs %}
{% tab title="200: OK example route : /analytics/derivs/summary/BTC" %}
[swagger link](https://api.laevitas.ch/swagger/#/Analytics%20Options/summary_c)

```json
{
  "date": 1757406060,
  "data": [
    {
      "currency": "BTC",
      "price": 112876.23,
      "change": 1.418,
      "market_cap": 2250861688202,
      "realized_vol": {
        "3": 19.6,
        "7": 34.91,
        "30": 34.32,
        "60": 32.31,
        "90": 32.45,
        "180": 37.55,
        "270": 45.23,
        "365": 45.98
      },
      "open_interest": 50098454061,
      "open_interest_change_usd": 1599993239,
      "open_interest_change_usd_percentage": 3.3,
      "open_interest_notional": 443835,
      "open_interest_change_notional": 8081,
      "open_interest_change_notional_percentage": 1.85,
      "volume": 52130204111,
      "volume_change_usd_percentage": 102,
      "volume_notional": 461835,
      "volume_change_notional": 229916,
      "volume_change_notional_percentage": 99.1,
      "oi_volume_24h": 0.961,
      "markets": [
        "HYPERLIQUID",
        "AEVO",
        "PARADEX",
        "DYDX",
        "OKX",
        "HUOBI",
        "BYBIT",
        "BITFINEX",
        "BITGET",
        "BINANCE",
        "BITMEX",
        "KRAKEN",
        "COINBASE",
        "DERIBIT"
      ],
      "funding": 0.00936,
      "next_fr": 0.000155,
      "yield": 10.24,
      "liquidations": {
        "long": 15887032,
        "short": 25289792
      },
      "correlation": {
        "btc": {
          "7": null,
          "30": null
        },
        "eth": {
          "7": 0.514,
          "30": 0.284
        }
      },
      "sectors": [
        "DIGITAL_ASSET"
      ],
      "ls_ratio": 0.973
    }
  ]
}
```

{% endtab %}
{% endtabs %}

## Aggregated Perps Summary All Currencies

<mark style="color:blue;">`GET`</mark> `https://api.laevitas.ch/analytics/derivs/summary`

N/A

{% tabs %}
{% tab title="200: OK example route : /analytics/derivs/summary" %}
[swagger link](https://api.laevitas.ch/swagger/#/Analytics%20Options/summary)

```json
{
  "date": 1757406060,
  "data": [
    {
      "currency": "BTC",
      "price": 112876.23,
      "change": 1.418,
      "market_cap": 2250861688202,
      "realized_vol": {
        "3": 19.6,
        "7": 34.91,
        "30": 34.32,
        "60": 32.31,
        "90": 32.45,
        "180": 37.55,
        "270": 45.23,
        "365": 45.98
      },
      "open_interest": 50098454061,
      "open_interest_change_usd": 1599993239,
      "open_interest_change_usd_percentage": 3.3,
      "open_interest_notional": 443835,
      "open_interest_change_notional": 8081,
      "open_interest_change_notional_percentage": 1.85,
      "volume": 52130204111,
      "volume_change_usd_percentage": 102,
      "volume_notional": 461835,
      "volume_change_notional": 229916,
      "volume_change_notional_percentage": 99.1,
      "oi_volume_24h": 0.961,
      "markets": [
        "HYPERLIQUID",
        "AEVO",
        "PARADEX",
        "DYDX",
        "OKX",
        "HUOBI",
        "BYBIT",
        "BITFINEX",
        "BITGET",
        "BINANCE",
        "BITMEX",
        "KRAKEN",
        "COINBASE",
        "DERIBIT"
      ],
      "funding": 0.00936,
      "next_fr": 0.000155,
      "yield": 10.24,
      "liquidations": {
        "long": 15887032,
        "short": 25289792
      },
      "correlation": {
        "btc": {
          "7": null,
          "30": null
        },
        "eth": {
          "7": 0.514,
          "30": 0.284
        }
      },
      "sectors": [
        "DIGITAL_ASSET"
      ],
      "ls_ratio": 0.973
    }
  ]
}
```

{% endtab %}
{% endtabs %}

## Open Interest Gainers

<mark style="color:blue;">`GET`</mark> `https://api.laevitas.ch/analytics/derivs/oi_gainers/{market}/{type}/{period}`

N/A

#### Path Parameters

| Name                                     | Type   | Description                                                                                                                                                                                      |
| ---------------------------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| market<mark style="color:red;">\*</mark> | string | N/A example: DERIBIT, AEVO, BINANCE, BITFINEX, BITGET, BITMEX, BYBIT, COINBASE, DYDX, HUOBI, HYPERLIQUID, KRAKEN, OKX, PARADEX                                                                   |
| type<mark style="color:red;">\*</mark>   | string | N/A example: future, perpetual                                                                                                                                                                   |
| period<mark style="color:red;">\*</mark> | string | Specifies the number of hours over which to track gainer in open interest, with the value representing the change interval in hours example: 1, 12, 168, 18, 2, 24, 336, 4, 48, 504, 720, 8, ytd |

{% tabs %}
{% tab title="200: OK example route : /analytics/derivs/oi\_gainers/DERIBIT/future/1" %}
[swagger link](https://api.laevitas.ch/swagger/#/Analytics%20Options/oi_gainers)

```json
{
  "date": 1757405760,
  "data": [
    {
      "symbol": "BTC-12SEP25",
      "open_interest_change": -62640,
      "open_interest_change_notional": -0.4687,
      "open_interest_change_percentage": -0.1628
    }
  ]
}
```

{% endtab %}
{% endtabs %}

## Price Gainers

<mark style="color:blue;">`GET`</mark> `https://api.laevitas.ch/analytics/derivs/price_gainers/{market}/{type}/{period}`

N/A

#### Path Parameters

| Name                                     | Type   | Description                                                                                                                                                                              |
| ---------------------------------------- | ------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| market<mark style="color:red;">\*</mark> | string | N/A example: DERIBIT, AEVO, BINANCE, BITFINEX, BITGET, BITMEX, BYBIT, COINBASE, DYDX, HUOBI, HYPERLIQUID, KRAKEN, OKX, PARADEX                                                           |
| type<mark style="color:red;">\*</mark>   | string | N/A example: future, perpetual                                                                                                                                                           |
| period<mark style="color:red;">\*</mark> | string | Specifies the number of hours over which to track gainer in price, with the value representing the change interval in hours example: 1, 12, 168, 18, 2, 24, 336, 4, 48, 504, 720, 8, ytd |

{% tabs %}
{% tab title="200: OK example route : /analytics/derivs/price\_gainers/DERIBIT/future/1" %}
[swagger link](https://api.laevitas.ch/swagger/#/Analytics%20Options/price_gainers)

```json
{
  "date": 1757405760,
  "data": [
    {
      "symbol": "BTCDVOL_USDC-1OCT25",
      "priceChange": -0.9103
    }
  ]
}
```

{% endtab %}
{% endtabs %}

## Get perpetuals snapshot data for a specific market

<mark style="color:blue;">`GET`</mark> `https://api.laevitas.ch/analytics/derivs/perpetuals_snapshot/{market}`

perpetuals data for a given market symbol. The data contains information about various perpetual contracts for the specified market, including the contract symbol, base currency, margin type, index price, current price, annual percentage yield (APY), open interest, 24-hour trading volume, and liquidations.

#### Path Parameters

| Name                                     | Type   | Description                                                                                                                        |
| ---------------------------------------- | ------ | ---------------------------------------------------------------------------------------------------------------------------------- |
| market<mark style="color:red;">\*</mark> | string | N/A example: DERIBIT, AEVO, BINANCE, BITFINEX, BITGET, BITMEX, BLITZ, BYBIT, COINBASE, HUOBI, KRAKEN, KWENTA, OKX, PARADEX, VERTEX |

{% tabs %}
{% tab title="200: OK example route : /analytics/derivs/perpetuals\_snapshot/DERIBIT" %}
[swagger link](https://api.laevitas.ch/swagger/#/Analytics%20Options/getPerpetualsSnapshotDataByMarket)

```json
{
  "date": 1757406000,
  "data": {
    "BTC": {
      "BTC-PERPETUAL": {
        "next_fr": 0,
        "mark_price": 112946.72,
        "fr": 0.004338,
        "volume": 6492.868,
        "volume_usd": 733166514.48,
        "base_currency": "BTC",
        "bid": 112956,
        "bid_amount": 193550,
        "ask": 112956.5,
        "ask_amount": 986660,
        "underlyer_spot": 112918.75,
        "underlyer": "BTC_USD",
        "datetime": "2025-09-09T08:20:00"
      },
      "BTC_USDC-PERPETUAL": {
        "next_fr": 0.001125,
        "mark_price": 112948.25,
        "fr": 0.002507,
        "volume": 218.643,
        "volume_usd": 24688916.84,
        "base_currency": "BTC",
        "bid": 112937,
        "bid_amount": 0.3984,
        "ask": 112937.5,
        "ask_amount": 0.337,
        "underlyer_spot": 112918.75,
        "underlyer": "BTC_USDC_USD",
        "datetime": "2025-09-09T08:20:00"
      }
    },
    "ETH": {
      "ETH-PERPETUAL": {
        "next_fr": 0,
        "mark_price": 4347.84,
        "fr": -0.0003,
        "volume": 51905.213,
        "volume_usd": 225635074.03,
        "base_currency": "ETH",
        "bid": 4347.85,
        "bid_amount": 132361,
        "ask": 4347.9,
        "ask_amount": 78720,
        "underlyer_spot": 4347.06,
        "underlyer": "ETH_USD",
        "datetime": "2025-09-09T08:20:00"
      },
      "ETH_USDC-PERPETUAL": {
        "next_fr": 0.018,
        "mark_price": 4348.97,
        "fr": 0.0013,
        "volume": 11660.829,
        "volume_usd": 50690789.75,
        "base_currency": "ETH",
        "bid": 4348.85,
        "bid_amount": 4.904,
        "ask": 4348.9,
        "ask_amount": 1.379,
        "underlyer_spot": 4347.1,
        "underlyer": "ETH_USDC_USD",
        "datetime": "2025-09-09T08:20:00"
      }
    },
    "SOL": {
      "SOL_USDC-PERPETUAL": {
        "next_fr": 0.07019,
        "mark_price": 218.812,
        "fr": 0.03423,
        "volume": 127622.8,
        "volume_usd": 27898829.05,
        "base_currency": "SOL",
        "bid": 218.8,
        "bid_amount": 21.1,
        "ask": 218.81,
        "ask_amount": 107.1,
        "underlyer_spot": 218.604,
        "underlyer": "SOL_USDC_USD",
        "datetime": "2025-09-09T08:20:00"
      }
    },
    "LINK": {
      "LINK_USDC-PERPETUAL": {
        "next_fr": 0,
        "mark_price": 23.595,
        "fr": 0.04867,
        "volume": 89412,
        "volume_usd": 2109497.32,
        "base_currency": "LINK",
        "bid": 23.605,
        "bid_amount": 12,
        "ask": 23.616,
        "ask_amount": 21,
        "underlyer_spot": 23.593,
        "underlyer": "LINK_USDC_USD",
        "datetime": "2025-09-09T08:20:00"
      }
    },
    "UNI": {
      "UNI_USDC-PERPETUAL": {
        "next_fr": 0.01108,
        "mark_price": 9.7051,
        "fr": 0.01223,
        "volume": 10414,
        "volume_usd": 101032.15,
        "base_currency": "UNI",
        "bid": 9.704,
        "bid_amount": 6,
        "ask": 9.705,
        "ask_amount": 63,
        "underlyer_spot": 9.7016,
        "underlyer": "UNI_USDC_USD",
        "datetime": "2025-09-09T08:20:00"
      }
    }
  }
}
```

{% endtab %}
{% endtabs %}

## Get perpetuals data for a specific market

<mark style="color:blue;">`GET`</mark> `https://api.laevitas.ch/analytics/derivs/perpetuals/{market}`

perpetuals data for a given market symbol. The data contains information about various perpetual contracts for the specified market, including the contract symbol, base currency, margin type, index price, current price, annual percentage yield (APY), open interest, 24-hour trading volume, and liquidations.

#### Path Parameters

| Name                                     | Type   | Description                                                                                                                    |
| ---------------------------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------ |
| market<mark style="color:red;">\*</mark> | string | N/A example: DERIBIT, AEVO, BINANCE, BITFINEX, BITGET, BITMEX, BYBIT, COINBASE, DYDX, HUOBI, HYPERLIQUID, KRAKEN, OKX, PARADEX |

{% tabs %}
{% tab title="200: OK example route : /analytics/derivs/perpetuals/DERIBIT" %}
[swagger link](https://api.laevitas.ch/swagger/#/Analytics%20Options/getPerpetualsDataByMarket)

```json
{
  "date": 1757405760,
  "data": [
    {
      "symbol": "ALGO_USDC-PERPETUAL",
      "base_currency": "ALGO",
      "margin": "usd",
      "market_cap": 2103810219,
      "index_price": 0.241,
      "price": 0.242,
      "basis": 0.124,
      "funding": 0.0492,
      "next_funding": 0.0992,
      "apy": 53.85,
      "open_interest": 34316.26,
      "open_interest_coin": 141920,
      "oi_volume24h": 10.07,
      "volume24h": 3407.57,
      "volume24h_coin": 14110,
      "bid": 0.2416,
      "ask": 0.2421,
      "bid_amount": 11200,
      "ask_amount": 43390,
      "liquidations": {
        "short": 0,
        "long": 0
      },
      "long_short_ratio": 0,
      "realized_vol": {
        "3": 45.08,
        "7": 58.5,
        "30": 83.81,
        "60": 99.7,
        "90": 93.75,
        "180": 92.34,
        "270": 109.19,
        "365": 113.98
      },
      "avg_apr": {
        "1": 53.087,
        "3": 43.931,
        "7": 26.546,
        "30": 8.7718,
        "60": 0,
        "90": -8.7509,
        "180": 0,
        "270": 0,
        "365": 5.4661
      }
    }
  ]
}
```

{% endtab %}
{% endtabs %}

## Get futures data for a specific market

<mark style="color:blue;">`GET`</mark> `https://api.laevitas.ch/analytics/derivs/futures/{market}`

futures data for a given market symbol. The data contains information about various futures contracts for the specified market, including the contract symbol, base currency, margin type, index price, basis value, funding, APY, open interest, 24-hour open interest volume, 24-hour trading volume, and liquidations.

#### Path Parameters

| Name                                     | Type   | Description                                                                                                                    |
| ---------------------------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------ |
| market<mark style="color:red;">\*</mark> | string | N/A example: DERIBIT, AEVO, BINANCE, BITFINEX, BITGET, BITMEX, BYBIT, COINBASE, DYDX, HUOBI, HYPERLIQUID, KRAKEN, OKX, PARADEX |

{% tabs %}
{% tab title="200: OK example route : /analytics/derivs/futures/DERIBIT" %}
[swagger link](https://api.laevitas.ch/swagger/#/Analytics%20Options/getFuturesDataByMarket)

```json
{
  "date": 1757406060,
  "data": [
    {
      "symbol": "ETH-12SEP25",
      "base_currency": "ETH",
      "margin": "coin",
      "index_price": 4347.06,
      "price": 4347.64,
      "basis": 0.013,
      "apy": 1.63,
      "open_interest": 12378915,
      "open_interest_coin": 2847.27,
      "oi_volume24h": 0.863,
      "volume24h": 14347206.15,
      "volume24h_coin": 3300.44,
      "bid": 4347.5,
      "ask": 4347.75,
      "bid_amount": 8860,
      "ask_amount": 7613,
      "liquidations": {
        "short": 0,
        "long": 0
      }
    }
  ]
}
```

{% endtab %}
{% endtabs %}

## Get alternative options data for a specific market

<mark style="color:blue;">`GET`</mark> `https://api.laevitas.ch/analytics/derivs/alt_option/{market}`

alternative options data for a given market symbol. The data contains information about various alternative options contracts for the specified market, including the contract symbol, base currency, margin type, index price, underlying price, ATM volatility, 25 delta risk reversal, 25 delta butterfly, open interest, open interest notional, 24-hour call volume, 24-hour call volume notional, 24-hour put volume, 24-hour put volume notional, 24-hour trading volume, 24-hour trading volume notional, basis value, and expiry date.

#### Path Parameters

| Name                                     | Type   | Description |
| ---------------------------------------- | ------ | ----------- |
| market<mark style="color:red;">\*</mark> | string | N/A         |

{% tabs %}
{% tab title="200: OK example route : /analytics/derivs/alt\_option/DERIBIT" %}
[swagger link](https://api.laevitas.ch/swagger/#/Analytics%20Options/getAltOptionDataByMarket)

```json
{
  "date": 1757406060,
  "data": [
    {
      "market": "DERIBIT",
      "symbol": "BTC Daily Options 10SEP25",
      "margin": "coin",
      "index_price": 112927.74,
      "underlying_price": 112961.66,
      "atm_vol": 30.21,
      "_25_delta_risk_reversal": -1.58,
      "_25_delta_butterfly": 0.66,
      "open_interest": 367996513.4,
      "open_interest_notional": 3303.92,
      "volume24h_call": 244094450.1,
      "volume24h_call_notional": 2191.51,
      "volume24h_put": 98856948,
      "volume24h_put_notional": 875.14,
      "volume24h": 342951398.1,
      "volume24h_notional": 3036,
      "basis": 0.03,
      "expiry": "10/09/25"
    }
  ]
}
```

{% endtab %}
{% endtabs %}

## &#x20;top funding data for a specific market.

<mark style="color:blue;">`GET`</mark> `https://api.laevitas.ch/analytics/derivs/top_funding/{market}`

This endpoint provides top funding data for a given market. It returns an array of funding data for various trading symbols, including the symbol, funding value, and yield value.

#### Path Parameters

| Name                                     | Type   | Description                                                                                                                    |
| ---------------------------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------ |
| market<mark style="color:red;">\*</mark> | string | N/A example: DERIBIT, AEVO, BINANCE, BITFINEX, BITGET, BITMEX, BYBIT, COINBASE, DYDX, HUOBI, HYPERLIQUID, KRAKEN, OKX, PARADEX |

{% tabs %}
{% tab title="200: OK example route : /analytics/derivs/top\_funding/DERIBIT" %}
[swagger link](https://api.laevitas.ch/swagger/#/Analytics%20Options/getTopFundingData)

```json
{
  "date": 1757406060,
  "data": [
    {
      "symbol": "TRX_USDC-PERPETUAL",
      "funding": -0.06058,
      "yield": -66.337
    }
  ]
}
```

{% endtab %}
{% endtabs %}

## Retrieves a timestamped summary of open interest changes for perpetual in a specific currency over a given period.

<mark style="color:blue;">`GET`</mark> `https://api.laevitas.ch/analytics/derivs/perpetual/open_interest_change_summary/{currency}/{period}`

N/A

#### Path Parameters

| Name                                       | Type   | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| ------------------------------------------ | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| currency<mark style="color:red;">\*</mark> | string | Currency example: BTC, 1INCH, A, A2Z, A8, AAPL, AAVE, ACE, ACH, ACT, ACX, ADA, AERGO, AERO, AEVO, AGI, AGLD, AGT, AI, AI16Z, AIDOGE, AIN, AIO, AIOT, AIOZ, AIXBT, AKT, ALCH, ALEO, ALG, ALGO, ALICE, ALL, ALPHA, ALPINE, ALT, ALU, AMP, AMZN, ANIME, ANKR, APE, API3, APT, APU, AR, ARB, ARC, ARIA, ARK, ARKM, ARM, ARPA, ASML, ASP, ASR, ASTR, ATA, ATH, ATOM, AUCTION, AUDIO, AUSTRALIA200IX, AVA, AVAAI, AVAIL, AVAX, AVL, AWE, AXL, AXS, B, B2, B3, BABA, BABY, BABYDOGE, BADGER, BAKE, BAN, BANANA, BANANAS31, BAND, BANK, BAS, BAT, BB, BCH, BDXN, BEAM, BEL, BERA, BGB, BGSC, BICO, BID, BIGTIME, BIO, BLAST, BLUE, BLUR, BMEX, BMT, BNB, BNT, BOB, BOBA, BOME, BONK, BR, BRETT, BROCCOLI, BROCCOLI714, BROCCOLIF3B, BSU, BSV, BSW, BTCDOM, BTR, BTT, BULLA, BVIV, C, C98, CAKE, CAMP, CARV, CAT, CATI, CELO, CELR, CETUS, CFX, CGPT, CHEEMS, CHESS, CHILLGUY, CHR, CHZ, CKB, CLANKER, CLOUD, COIN, COIN50, COMP, COOK, COOKIE, COQ, CORE, COS, COTI, COW, CPOOL, CRCL, CRO, CROSS, CRV, CTC, CTK, CTSI, CUDIS, CVC, CVX, CYBER, D, DAM, DASH, DBR, DEEP, DEGEN, DEGO, DENT, DEXE, DF, DFDV, DGB, DIA, DMC, DODO, DOG, DOGE, DOGS, DOLO, DOOD, DOT, DRIFT, DUCK, DUSK, DYDX, DYM, EDGE, EDU, EGLD, EIGEN, ELON, ELX, ENA, ENJ, ENS, EPIC, EPT, ERA, ES, ESPORTS, ETC, ETH, ETHBTC, ETHFI, ETHW, EUR, EURC, EUROPE50IX, EVIV, F, FAI, FARTCOIN, FET, FHE, FIDA, FIL, FIO, FIS, FLM, FLOCK, FLOKI, FLOW, FLR, FLUX, FORM, FORTH, FRAG, FRANCE40IX, FTT, FUEL, FUN, FWOG, FXS, G, GALA, GAS, GBP, GERMANY40IX, GHST, GIGA, GLM, GLMR, GME, GMT, GMX, GNO, GOAT, GODS, GOOGL, GORK, GPS, GRASS, GRIFFAIN, GRT, GTC, GUN, H, HAEDAL, HBAR, HEI, HEMI, HFT, HIFI, HIGH, HIPPO, HIVE, HMSTR, HNT, HOME, HONGKONG50IX, HOOD, HOOK, HOT, HOUSE, HPOS10I, HUMA, HYPE, HYPER, IBM, ICNT, ICP, ICX, ID, IDEX, IDOL, IKA, ILV, IMX, IN, INIT, INJ, INTC, IO, IOST, IOTA, IOTX, IP, J, JAPAN225IX, JASMY, JELLYJELLY, JOE, JPY, JST, JTO, JUP, K, KAIA, KAITO, KAS, KAVA, KDA, KERNEL, kFLOKI, kLUNC, KMNO, KNC, kNEIRO, KOMA, KSM, L3, LA, LADYS, LAUNCHCOIN, LAYER, LDO, LEVER, LINEA, LINK, LISTA, LOOKS, LPT, LQTY, LRC, LSK, LTC, LUMIA, LUNA2, LUNC, M, MAGIC, MAJOR, MANA, MANTA, MANTLE, MASA, MASK, MAV, MAVIA, MBOX, MCD, MDT, ME, MELANIA, MEME, MEMEFI, MERL, META, METIS, MEW, MILK, MINA, MITO, MKR, MLN, MNT, MOCA, MOG, MOODENG, MOONPIG, MORPHO, MOVE, MOVR, MSTR, MTL, MUBARAK, MVL, MYRIA, MYRO, MYX, NAORIS, NAVX, NEAR, NEIRO, NEIROETH, NEO, NEWT, NFP, NIL, NKN, NMR, NODE, NOT, NS, NTRN, NVDA, NXPC, OBOL, OBT, OG, OGN, OKB, OL, OM, OMNI, ONDO, ONE, ONG, ONT, OP, OPEN, ORBS, ORCA, ORDER, ORDI, OSMO, OXT, PARTI, PAXG, PEAQ, PEIPEI, PENDLE, PENGU, PEOPLE, PEPE, PERP, PHA, PHB, PI, PIPPIN, PIXEL, PLAY, PLUME, PNUT, POL, POLYX, PONKE, POPCAT, PORT3, PORTAL, POWR, PRCL, PRIME, PROM, PROMPT, PROVE, PTB, PUFFER, PUMP, PUMPBTC, PUMPFUN, PUNDIX, PURR, PYR, PYTH, Q, QI, QNT, QTUM, QUBIC, QUICK, RAD, RARE, RATS, RAY, RDNT, RED, REI, RENDER, REQ, RESOLV, REX, REZ, RFC, RHEA, RIF, RLC, ROAM, RON, RONIN, ROSE, RPL, RSR, RSS3, RUNE, RVN, S, SAFE, SAGA, SAHARA, SAND, SANTOS, SAPIEN, SAROS, SATS, SC, SCA, SCR, SCRT, SD, SEI, SEND, SERAPH, SFP, SHELL, SHIB, SIGN, SIREN, SKATE, SKL, SKY, SKYAI, SLERF, SLF, SLP, SNT, SNX, SOL, SOLO, SOLV, SOMI, SONIC, SOON, SOPH, SOSO, SPAIN35IX, SPEC, SPELL, SPK, SPX, SQD, SSV, STEEM, STG, STO, STORJ, STRK, STX, SUI, SUN, SUNDOG, SUPER, SUSHI, SWARMS, SWEAT, SWELL, SXP, SXT, SYN, SYRUP, SYS, T, TA, TAC, TAG, TAI, TAIKO, TAKE, TANSSI, TAO, THE, THETA, TIA, TLM, TNSR, TOKEN, TON, TOSHI, TOWNS, TRB, TREE, TRU, TRUMP, TRUMPOFFICIAL, TRX, TRY, TSLA, TST, TSTBSC, TURBO, TUT, TWT, U, UKOIL, UMA, UNI, USD1, USDC, USDE, USELESS, USTC, USUAL, UXLINK, VANA, VANRY, VELO, VELODROME, VELVET, VET, VIC, VINE, VIRTUAL, VOXEL, VR, VTHO, VVV, W, WAL, WAVES, WAXP, WCT, WEN, WHY, WIF, WIN, WLD, WLFI, WOO, X, XAG, XAI, XAUT, XCH, XCN, XCX, XDC, XEC, XEM, XION, XLM, XMR, XNO, XNY, XPD, XPL, XPT, XRP, XTER, XTZ, XVG, XVS, YALA, YFI, YGG, YZY, ZBCN, ZEC, ZEN, ZENT, ZEREBRO, ZETA, ZEUS, ZIL, ZK, ZKJ, ZORA, ZRC, ZRO, ZRX |
| period<mark style="color:red;">\*</mark>   | string | change period in hours example: 1, 2, 4, 8, 12, 18, 24, 48, 168, 336, 504, 720, 8760, ytd                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |

{% tabs %}
{% tab title="200: OK example route : /analytics/derivs/perpetual/open\_interest\_change\_summary/BTC/1" %}
[swagger link](https://api.laevitas.ch/swagger/#/Analytics%20Options/getDerivsOpenInterestChangeSummary)

```json
{
  "date": 1757406060,
  "data": [
    {
      "markets": [
        "HYPERLIQUID",
        "AEVO",
        "PARADEX",
        "DYDX",
        "OKX",
        "HUOBI",
        "BYBIT",
        "BITFINEX",
        "BITGET",
        "BINANCE",
        "BITMEX",
        "KRAKEN",
        "COINBASE",
        "DERIBIT"
      ],
      "open_interest": 50098454061,
      "open_interest_notional": 443835,
      "open_interest_change_usd": -138997497,
      "open_interest_notional_change_usd": -216
    }
  ]
}
```

{% endtab %}
{% endtabs %}

## Retrieves a timestamped report of open interest changes for a specific market and currency over a given period.

<mark style="color:blue;">`GET`</mark> `https://api.laevitas.ch/analytics/derivs/perpetual/open_interest_change/{market}/{currency}/{period}`

N/A

#### Path Parameters

| Name                                       | Type   | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| ------------------------------------------ | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| market<mark style="color:red;">\*</mark>   | string | Market example: DERIBIT, AEVO, BINANCE, BITFINEX, BITGET, BITMEX, BYBIT, COINBASE, DYDX, HUOBI, HYPERLIQUID, KRAKEN, OKX, PARADEX                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| currency<mark style="color:red;">\*</mark> | string | Currency example: BTC, 1INCH, A, A2Z, A8, AAPL, AAVE, ACE, ACH, ACT, ACX, ADA, AERGO, AERO, AEVO, AGI, AGLD, AGT, AI, AI16Z, AIDOGE, AIN, AIO, AIOT, AIOZ, AIXBT, AKT, ALCH, ALEO, ALG, ALGO, ALICE, ALL, ALPHA, ALPINE, ALT, ALU, AMP, AMZN, ANIME, ANKR, APE, API3, APT, APU, AR, ARB, ARC, ARIA, ARK, ARKM, ARM, ARPA, ASML, ASP, ASR, ASTR, ATA, ATH, ATOM, AUCTION, AUDIO, AUSTRALIA200IX, AVA, AVAAI, AVAIL, AVAX, AVL, AWE, AXL, AXS, B, B2, B3, BABA, BABY, BABYDOGE, BADGER, BAKE, BAN, BANANA, BANANAS31, BAND, BANK, BAS, BAT, BB, BCH, BDXN, BEAM, BEL, BERA, BGB, BGSC, BICO, BID, BIGTIME, BIO, BLAST, BLUE, BLUR, BMEX, BMT, BNB, BNT, BOB, BOBA, BOME, BONK, BR, BRETT, BROCCOLI, BROCCOLI714, BROCCOLIF3B, BSU, BSV, BSW, BTCDOM, BTR, BTT, BULLA, BVIV, C, C98, CAKE, CAMP, CARV, CAT, CATI, CELO, CELR, CETUS, CFX, CGPT, CHEEMS, CHESS, CHILLGUY, CHR, CHZ, CKB, CLANKER, CLOUD, COIN, COIN50, COMP, COOK, COOKIE, COQ, CORE, COS, COTI, COW, CPOOL, CRCL, CRO, CROSS, CRV, CTC, CTK, CTSI, CUDIS, CVC, CVX, CYBER, D, DAM, DASH, DBR, DEEP, DEGEN, DEGO, DENT, DEXE, DF, DFDV, DGB, DIA, DMC, DODO, DOG, DOGE, DOGS, DOLO, DOOD, DOT, DRIFT, DUCK, DUSK, DYDX, DYM, EDGE, EDU, EGLD, EIGEN, ELON, ELX, ENA, ENJ, ENS, EPIC, EPT, ERA, ES, ESPORTS, ETC, ETH, ETHBTC, ETHFI, ETHW, EUR, EURC, EUROPE50IX, EVIV, F, FAI, FARTCOIN, FET, FHE, FIDA, FIL, FIO, FIS, FLM, FLOCK, FLOKI, FLOW, FLR, FLUX, FORM, FORTH, FRAG, FRANCE40IX, FTT, FUEL, FUN, FWOG, FXS, G, GALA, GAS, GBP, GERMANY40IX, GHST, GIGA, GLM, GLMR, GME, GMT, GMX, GNO, GOAT, GODS, GOOGL, GORK, GPS, GRASS, GRIFFAIN, GRT, GTC, GUN, H, HAEDAL, HBAR, HEI, HEMI, HFT, HIFI, HIGH, HIPPO, HIVE, HMSTR, HNT, HOME, HONGKONG50IX, HOOD, HOOK, HOT, HOUSE, HPOS10I, HUMA, HYPE, HYPER, IBM, ICNT, ICP, ICX, ID, IDEX, IDOL, IKA, ILV, IMX, IN, INIT, INJ, INTC, IO, IOST, IOTA, IOTX, IP, J, JAPAN225IX, JASMY, JELLYJELLY, JOE, JPY, JST, JTO, JUP, K, KAIA, KAITO, KAS, KAVA, KDA, KERNEL, kFLOKI, kLUNC, KMNO, KNC, kNEIRO, KOMA, KSM, L3, LA, LADYS, LAUNCHCOIN, LAYER, LDO, LEVER, LINEA, LINK, LISTA, LOOKS, LPT, LQTY, LRC, LSK, LTC, LUMIA, LUNA2, LUNC, M, MAGIC, MAJOR, MANA, MANTA, MANTLE, MASA, MASK, MAV, MAVIA, MBOX, MCD, MDT, ME, MELANIA, MEME, MEMEFI, MERL, META, METIS, MEW, MILK, MINA, MITO, MKR, MLN, MNT, MOCA, MOG, MOODENG, MOONPIG, MORPHO, MOVE, MOVR, MSTR, MTL, MUBARAK, MVL, MYRIA, MYRO, MYX, NAORIS, NAVX, NEAR, NEIRO, NEIROETH, NEO, NEWT, NFP, NIL, NKN, NMR, NODE, NOT, NS, NTRN, NVDA, NXPC, OBOL, OBT, OG, OGN, OKB, OL, OM, OMNI, ONDO, ONE, ONG, ONT, OP, OPEN, ORBS, ORCA, ORDER, ORDI, OSMO, OXT, PARTI, PAXG, PEAQ, PEIPEI, PENDLE, PENGU, PEOPLE, PEPE, PERP, PHA, PHB, PI, PIPPIN, PIXEL, PLAY, PLUME, PNUT, POL, POLYX, PONKE, POPCAT, PORT3, PORTAL, POWR, PRCL, PRIME, PROM, PROMPT, PROVE, PTB, PUFFER, PUMP, PUMPBTC, PUMPFUN, PUNDIX, PURR, PYR, PYTH, Q, QI, QNT, QTUM, QUBIC, QUICK, RAD, RARE, RATS, RAY, RDNT, RED, REI, RENDER, REQ, RESOLV, REX, REZ, RFC, RHEA, RIF, RLC, ROAM, RON, RONIN, ROSE, RPL, RSR, RSS3, RUNE, RVN, S, SAFE, SAGA, SAHARA, SAND, SANTOS, SAPIEN, SAROS, SATS, SC, SCA, SCR, SCRT, SD, SEI, SEND, SERAPH, SFP, SHELL, SHIB, SIGN, SIREN, SKATE, SKL, SKY, SKYAI, SLERF, SLF, SLP, SNT, SNX, SOL, SOLO, SOLV, SOMI, SONIC, SOON, SOPH, SOSO, SPAIN35IX, SPEC, SPELL, SPK, SPX, SQD, SSV, STEEM, STG, STO, STORJ, STRK, STX, SUI, SUN, SUNDOG, SUPER, SUSHI, SWARMS, SWEAT, SWELL, SXP, SXT, SYN, SYRUP, SYS, T, TA, TAC, TAG, TAI, TAIKO, TAKE, TANSSI, TAO, THE, THETA, TIA, TLM, TNSR, TOKEN, TON, TOSHI, TOWNS, TRB, TREE, TRU, TRUMP, TRUMPOFFICIAL, TRX, TRY, TSLA, TST, TSTBSC, TURBO, TUT, TWT, U, UKOIL, UMA, UNI, USD1, USDC, USDE, USELESS, USTC, USUAL, UXLINK, VANA, VANRY, VELO, VELODROME, VELVET, VET, VIC, VINE, VIRTUAL, VOXEL, VR, VTHO, VVV, W, WAL, WAVES, WAXP, WCT, WEN, WHY, WIF, WIN, WLD, WLFI, WOO, X, XAG, XAI, XAUT, XCH, XCN, XCX, XDC, XEC, XEM, XION, XLM, XMR, XNO, XNY, XPD, XPL, XPT, XRP, XTER, XTZ, XVG, XVS, YALA, YFI, YGG, YZY, ZBCN, ZEC, ZEN, ZENT, ZEREBRO, ZETA, ZEUS, ZIL, ZK, ZKJ, ZORA, ZRC, ZRO, ZRX |
| period<mark style="color:red;">\*</mark>   | string | change period in hours example: 1, 2, 4, 8, 12, 18, 24, 48, 168, 336, 504, 720, 8760, ytd                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |

{% tabs %}
{% tab title="200: OK example route : /analytics/derivs/perpetual/open\_interest\_change/DERIBIT/BTC/1" %}
[swagger link](https://api.laevitas.ch/swagger/#/Analytics%20Options/getDerivsOpenInterestChange)

```json
{
  "date": 1757405760,
  "data": [
    {
      "symbol": "BTC_USDC-PERPETUAL",
      "open_interest": 31890712.31,
      "open_interest_notional": 282.06,
      "open_interest_change_usd": 798710.87,
      "open_interest_notional_change": 7.107
    }
  ]
}
```

{% endtab %}
{% endtabs %}
