# Historical Data This page provides comprehensive details on historical data for derivatives available in our system. With the ever-evolving nature of the financial markets, the significance of historical data on derivatives is paramount. It allows businesses to dissect past market behaviors, understand the evolution of various financial instruments, and predict potential future trends. ## What is Derivs Historical Data? Derivs historical data pertains to the archived data related to various financial derivatives in the market, such as options, futures, swaps, and more. This data is essential for traders, analysts, and financial institutions to analyze past market dynamics and derive insights. It includes metrics like historical derivative prices, past trading volumes, volatility trends, and other key indicators. ## List of Requests ## Fetches historical snapshot data for a specific derivative market and currency `GET` `https://api.laevitas.ch/historical/derivs/snapshot/{market}/{currency}` N/A #### Path Parameters | Name | Type | Description | | ------------------------------------------ | ------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | market\* | string | N/A example: DERIBIT, BINANCE, BITFINEX, BITMEX, BYBIT, HUOBI, KRAKEN, OKX | | currency\* | string | N/A example: DERIBIT (BTC, ADA, ALGO, AVAX, BCH, DOGE, DOT, ETH, LINK, LTC, MATIC, NEAR, SOL, TRX, UNI, XRP), BINANCE (1INCH, AAVE, ACH, ADA, AGIX, AGLD, ALGO, ALICE, ALPHA, AMB, ANKR, ANT, APE, API3, APT, AR, ARB, ARKM, ARPA, ASTR, ATA, ATOM, AUDIO, AVAX, AXS, BAKE, BAL, BAND, BAT, BCH, BEL, BLUEBIRD, BLUR, BLZ, BNB, BNT, BNX, BTC, BTCDOM, C98, CELO, CELR, CFX, CHR, CHZ, CKB, COCOS, COMBO, COMP, COTI, CRV, CTK, CTSI, CVX, DAR, DASH, DEFI, DENT, DGB, DODO, DODOX, DOGE, DOT, DUSK, DYDX, EDU, EGLD, ENJ, ENS, EOS, ETC, ETH, FET, FIL, FLM, FLOKI, FLOW, FOOTBALL, FTM, FXS, GAL, GALA, GMT, GMX, GRT, GTC, HBAR, HFT, HIGH, HOOK, HOT, ICP, ICX, ID, IDEX, IMX, INJ, IOST, IOTA, IOTX, JASMY, JOE, KAVA, KEY, KLAY, KNC, KSM, LDO, LEVER, LINA, LINK, LIT, LPT, LQTY, LRC, LTC, LUNA2, LUNC, MAGIC, MANA, MASK, MATIC, MAV, MDT, MINA, MKR, MTL, NEAR, NEO, NKN, NMR, OCEAN, OGN, OMG, ONE, ONT, OP, OXT, PENDLE, PEOPLE, PEPE, PERP, PHB, QNT, QTUM, RAD, RDNT, REEF, REN, RLC, RNDR, ROSE, RSR, RUNE, RVN, SAND, SFP, SHIB, SKL, SNX, SOL, SPELL, SSV, STG, STMX, STORJ, STX, SUI, SUSHI, SXP, T, THETA, TLM, TOMO, TRB, TRU, TRX, UMA, UNFI, UNI, USDC, VET, WAVES, WLD, WOO, XEC, XEM, XLM, XMR, XRP, XTZ, XVG, XVS, YFI, YGG, ZEC, ZEN, ZIL, ZRX), BITFINEX (AAVE, ADA, ALG, AMP, APE, APT, ARB, ATO, AUSTRALIA200IX, AVAX, AXS, BTC, BTCDOM, COMP, CRV, DOGE, DOT, EGLD, EOS, ETC, ETH, EUR, EUROPE50IX, FIL, FRANCE40IX, FTM, GALA, GBP, GERMANY40IX, HONGKONG50IX, ICP, IOT, JAPAN225IX, JASMY, JPY, KNC, LINK, LTC, MATIC, MKR, NEAR, NEO, OMG, SAND, SHIB, SOL, SPAIN35IX, STG, SUSHI, TRX, TRY, UK100IX, UKOIL, UNI, WAVES, XAG, XAUT, XLM, XMR, XPD, XPT, XRP, XTZ, ZEC), BITMEX (ADA, AIDOGE, APE, APT, ARB, AVAX, AXS, BCH, BLUR, BMEX, BNB, BOB, BTC, CRO, DOGE, DOT, EOS, ETH, FLOKI, FLR, GMT, GMX, KLAY, LINK, LTC, LUNA, MATIC, NEAR, ORDI, PEPE, RNDR, SOL, SUI, TURBO, WLD, XRP), BYBIT (10000LADYS, 1INCH, AAVE, ACH, ADA, AGIX, AGLD, AKRO, ALGO, ALICE, ALPACA, ALPHA, AMB, ANKR, ANT, APE, API3, APT, AR, ARB, ARK, ARKM, ARPA, ASTR, ATA, ATOM, AUCTION, AUDIO, AVAX, AXS, BAKE, BAL, BAND, BAT, BCH, BEL, BICO, BIT, BLUR, BLZ, BNB, BNT, BNX, BOBA, BONK, BSV, BSW, BTC, BTT, BUSD, C98, CEEK, CELO, CELR, CFX, CHR, CHZ, CKB, COCOS, COMBO, COMP, CORE, COTI, CREAM, CRO, CRV, CTC, CTK, CTSI, CVC, CVX, DAR, DASH, DENT, DGB, DODO, DOGE, DOT, DUSK, DYDX, EDU, EGLD, ENJ, ENS, EOS, ETC, ETH, ETHW, FET, FIL, FITFI, FLM, FLOKI, FLOW, FLR, FORTH, FTM, FXS, GAL, GALA, GFT, GLM, GLMR, GMT, GMX, GPT, GRT, GTC, HBAR, HFT, HIGH, HNT, HOOK, HOT, ICP, ICX, ID, IDEX, ILV, IMX, INJ, IOST, IOTA, IOTX, JASMY, JOE, JST, KAS, KAVA, KDA, KEY, KLAY, KNC, KSM, LADYS, LDO, LEVER, LINA, LINK, LIT, LOOKS, LPT, LQTY, LRC, LTC, LUNA2, LUNC, MAGIC, MANA, MASK, MATIC, MAV, MDT, MINA, MKR, MTL, NEAR, NEO, NFT, NKN, OCEAN, OGN, OMG, ONE, ONT, OP, ORDI, OXT, PAXG, PENDLE, PEOPLE, PEPE, PHB, QNT, QTUM, RAD, RDNT, REEF, REN, REQ, RLC, RNDR, ROSE, RPL, RSR, RSS3, RUNE, RVN, SAND, SC, SCRT, SFP, SHIB, SKL, SLP, SNX, SOL, SPELL, SSV, STG, STMX, STORJ, STX, SUI, SUN, SUSHI, SWEAT, SXP, T, THETA, TLM, TOMO, TRB, TRU, TRX, TWT, UMA, UNFI, UNI, USDC, VET, VGX, WAVES, WLD, WOO, XCN, XEC, XEM, XLM, XMR, XNO, XRP, XTZ, XVG, YFI, YGG, ZEC, ZEN, ZIL, ZRX), HUOBI (1INCH, AAVE, ACH, ADA, AGIX, AIDOGE, ALGO, ANKR, APE, APT, ARB, ATOM, AVAX, AXS, BCH, BLUR, BLZ, BNB, BOB, BSV, BTC, C98, CFX, CHZ, COMBO, COMP, CORE, CRV, DOGE, DOT, DYDX, EOS, ETC, ETH, FET, FIL, FLOKI, FTM, FTT, GAL, GALA, GMT, GRT, HT, IMX, JST, KAVA, KSM, LADYS, LDO, LINA, LINK, LPT, LRC, LTC, LUNA, LUNC, MANA, MASK, MATIC, MKR, MTL, NEAR, OG, OGN, ONE, OP, ORDI, PEPE, RDNT, REN, RNDR, SAND, SHIB, SNX, SOL, SSV, STG, SUI, SUSHI, THETA, TON, TRX, TURBO, UNI, USTC, WAVES, WIN, WLD, WOJAK, WOO, XLM, XMR, XRP, XVG, YFI, YGG), KRAKEN (1INCH, AAVE, ACH, ADA, ALGO, ALICE, ALPHA, ANKR, ANT, APE, APT, ARB, ARPA, ATOM, AUDIO, AVAX, AXS, BAL, BAND, BAT, BCH, BLUR, CFX, CHZ, COMP, CRV, CVX, DASH, DEFI, DOGE, DOT, DYDX, EGLD, ENJ, ENS, EOS, ETC, ETH, ETHW, FET, FIL, FLOW, FLR, FTM, GAL, GALA, GLMR, GMT, GMX, GRT, HFT, ICP, ICX, IMX, INJ, JASMY, KAVA, KNC, KSM, LDO, LINA, LINK, LPT, LRC, LTC, LUNA2, MANA, MASK, MATIC, MINA, MKR, MOON, NEAR, OCEAN, OGN, OMG, OP, PEPE, QNT, QTUM, REN, RLC, RNDR, RUNE, SAND, SC, SHIB, SNX, SOL, STG, STORJ, STX, SUI, SUSHI, SXP, THETA, TRX, TUSD, UNI, USDC, USDT, WAVES, WLD, WOO, XBT, XLM, XMR, XRP, XTZ, YFI, ZEC, ZRX), OKX (1INCH, AAVE, ADA, AGLD, AIDOGE, ALGO, ALPHA, ANT, APE, API3, APT, AR, ARB, ATOM, AVAX, AXS, BADGER, BAL, BAND, BAT, BCH, BICO, BLUR, BNB, BNT, BSV, BTC, CEL, CELO, CETUS, CFX, CHZ, COMP, CORE, CRO, CRV, CSPR, CVC, DASH, DOGE, DORA, DOT, DYDX, EGLD, ENJ, ENS, EOS, ETC, ETH, ETHW, FIL, FITFI, FLM, FLOKI, FTM, GALA, GFT, GMT, GMX, GODS, GRT, ICP, IMX, IOST, IOTA, JST, KISHU, KLAY, KNC, KSM, LDO, LINK, LOOKS, LPT, LRC, LTC, LUNA, LUNC, MAGIC, MANA, MASK, MATIC, MINA, MKR, NEAR, NEO, NFT, OMG, ONT, OP, ORDI, PEOPLE, PEPE, PERP, QTUM, RDNT, REN, RSR, RVN, SAND, SHIB, SLP, SNX, SOL, STARL, STORJ, STX, SUI, SUSHI, SWEAT, THETA, TON, TRB, TRX, UMA, UNI, USDC, USTC, WAVES, WLD, WOO, XCH, XLM, XMR, XRP, XTZ, YFI, YFII, YGG, ZEC, ZEN, ZIL, ZRX) | #### Query Parameters | Name | Type | Description | | --------------------------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | start\* | string | The start date of the search range , this date can be timestamps. Exp : 2025-09-02 , 2025-09-02T10:15 , 1756800000000 | | end\* | string | The end date of the search range , this date can be timestamps. Exp : 2025-09-09 , 2025-09-09T10:15 , 1757406000000 | | limit | number |

The maximum number of results to return per page. The maximum limit is 144.

Each page corresponds to one minute of data and includes all derivs data in that snapshot.

| | page | number |

The page of results to return, where each page corresponds to one minute of data within the specified time range.

Use this parameter to select which minute of data to access.

| | granularity | string | The interval between dates of result data | {% tabs %} {% tab title="200: OK example route : /historical/derivs/snapshot/DERIBIT/BTC?start=2025-09-02\&end=2025-09-09" %} [swagger link](https://api.laevitas.ch/swagger/#/Analytics%20Options/getHistoricalDerivsSnapshot) ```json { "meta": { "total": 10582, "items": 0 }, "items": [ null ] } ``` {% endtab %} {% endtabs %} ## Fetches historical contract liquidations for a specific derivative market and symbol `GET` `https://api.laevitas.ch/historical/derivs/liquidation/{market}/{symbol}` N/A #### Path Parameters | Name | Type | Description | | ---------------------------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | market\* | string | The market identifier. The value should be one of the valid markets defined in the Market enum. The input value will be transformed to uppercase. example: DERIBIT, BINANCE, BITFINEX, BITMEX, BYBIT, HUOBI, KRAKEN, OKX | | symbol\* | string | The symbol identifier example: DERIBIT (ETH\_USDC, ETH\_USDC, ETH, ETH), BINANCE (BTCDOMUSDT, BTCUSD\_PERP, BTCUSDC, BTCUSDT, BTCUSDT\_250926), BITFINEX (TETHF0:USTF0), BITMEX (ETHUSD), BYBIT (BTCPERP, BTCUSD, BTCUSDT, BTCUSDT, BTCUSDT), HUOBI (BTC, BTC, ETH, ETH, ETHFI), KRAKEN (PF\_ETHUSD, PF\_NEIROETHUSD, PI\_ETHUSD), OKX (BTC, BTC, ETH, ETH, ETHFI) | #### Query Parameters | Name | Type | Description | | --------------------------------------- | ------ | --------------------------------------------------------------------------------------------------------------------- | | start\* | string | The start date of the search range , this date can be timestamps. Exp : 2025-09-02 , 2025-09-02T10:15 , 1756800000000 | | end\* | string | The end date of the search range , this date can be timestamps. Exp : 2025-09-09 , 2025-09-09T10:15 , 1757406000000 | | limit | number |

The maximum number of results to return per page

Max limit=144

| | page | number | The page of results to return | | granularity | string | The interval between dates of result data | {% tabs %} {% tab title="200: OK example route : /historical/derivs/liquidation/DERIBIT/ETH\_USDC-26SEP25?start=2025-09-02\&end=2025-09-09" %} [swagger link](https://api.laevitas.ch/swagger/#/Analytics%20Options/getDerivativesLiquidationData) ```json { "meta": { "total": 2, "page": 1, "items": 1, "total_pages": 1 }, "items": [ { "date": 1757332800000, "usd_amount": 0, "side": "long" } ] } ``` {% endtab %} {% endtabs %} ## Fetches historical contract liquidations for a specific derivative market and currency `GET` `https://api.laevitas.ch/historical/derivs/liquidation_by_currency/{market}/{currency}` N/A #### Path Parameters | Name | Type | Description | | ------------------------------------------ | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | market\* | string | The market identifier. The value should be one of the valid markets defined in the Market enum. The input value will be transformed to uppercase. example: DERIBIT, AGGREGATED, BINANCE, BITFINEX, BITMEX, BYBIT, HUOBI, KRAKEN, OKX | | currency\* | string | The currency identifier 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, AITECH, 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, AUD, 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, BITCOIN, 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, CHF, 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, 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, KRL, KSM, L3, LA, LADYS, LAUNCHCOIN, LAYER, LDO, LEVER, LINEA, LINK, LISTA, LOOKS, LOT, LOUD, 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, MGO, 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, NFT, 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, POKT, 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, RWA, 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, TKO, 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, USDT, 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, XYO, YALA, YFI, YGG, YZY, ZBCN, ZEC, ZEN, ZENT, ZEREBRO, ZEUS, ZIL, ZK, ZKJ, ZORA, ZRC, ZRO, ZRX | #### Query Parameters | Name | Type | Description | | --------------------------------------- | ------ | --------------------------------------------------------------------------------------------------------------------- | | start\* | string | The start date of the search range , this date can be timestamps. Exp : 2025-09-02 , 2025-09-02T10:15 , 1756800000000 | | end\* | string | The end date of the search range , this date can be timestamps. Exp : 2025-09-09 , 2025-09-09T10:15 , 1757406000000 | | limit | number |

The maximum number of results to return per page

Max limit=144

| | page | number | The page of results to return | | granularity | string | The interval between dates of result data | {% tabs %} {% tab title="200: OK example route : /historical/derivs/liquidation\_by\_currency/DERIBIT/BTC?start=2025-09-02\&end=2025-09-09" %} [swagger link](https://api.laevitas.ch/swagger/#/Analytics%20Options/getDerivativesLiquidationByCurrencyData) ```json { "meta": { "total": 110, "page": 1, "items": 2, "total_pages": 22 }, "items": [ { "date": 1756782000000, "usd_amount": 5000, "side": "short" } ] } ``` {% endtab %} {% endtabs %} ## Returns historical summary data for derivative contracts of a specific currency `GET` `https://api.laevitas.ch/historical/derivs/summary/{currency}` N/A #### Path Parameters | Name | Type | Description | | ------------------------------------------ | ------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | currency\* | string | N/A 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, AITECH, 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, AUD, 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, BITCOIN, 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, CHF, 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, 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, KRL, KSM, L3, LA, LADYS, LAUNCHCOIN, LAYER, LDO, LEVER, LINEA, LINK, LISTA, LOOKS, LOT, LOUD, 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, MGO, 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, NFT, 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, POKT, 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, RWA, 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, TKO, 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, USDT, 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, XYO, YALA, YFI, YGG, YZY, ZBCN, ZEC, ZEN, ZENT, ZEREBRO, ZEUS, ZIL, ZK, ZKJ, ZORA, ZRC, ZRO, ZRX | #### Query Parameters | Name | Type | Description | | --------------------------------------- | ------ | --------------------------------------------------------------------------------------------------------------------- | | start\* | string | The start date of the search range , this date can be timestamps. Exp : 2025-09-02 , 2025-09-02T10:15 , 1756800000000 | | end\* | string | The end date of the search range , this date can be timestamps. Exp : 2025-09-09 , 2025-09-09T10:15 , 1757406000000 | | limit | number |

The maximum number of results to return per page

Max limit=144

| | page | number | The page of results to return | | granularity | string | The interval between dates of result data | {% tabs %} {% tab title="200: OK example route : /historical/derivs/summary/BTC?start=2025-09-02\&end=2025-09-09" %} [swagger link](https://api.laevitas.ch/swagger/#/Analytics%20Options/getHistoricalDerivsSummary) ```json { "meta": { "total": 2117, "page": 1, "items": 5, "total_pages": 424 }, "items": [ { "date": 1756771200000, "price": 109150.59, "open_interest": 47345554758, "volume": 63284864109, "funding": 0.00762, "next_fr": 0.0000931, "yield": 8.314, "liquidations_long": 36768610, "liquidations_short": 21019577, "market_cap": 2158880764122, "oi_volume24h": 0.748, "rv": { "3": 31.95, "7": 32.88, "30": 32.35, "60": 32.07, "90": 32.08, "180": 40.35, "270": 45.68, "365": 46.33 }, "correlation": { "ETH": { "7": 0.786, "30": 0.0578 } } } ] } ``` {% endtab %} {% endtabs %} ## Get total trading volume for perpetuals across all markets `GET` `https://api.laevitas.ch/historical/derivs/perpetual/total_volume_by_currency` N/A #### Query Parameters | Name | Type | Description | | --------------------------------------- | ------ | --------------------------------------------------------------------------------------------------------------------- | | start\* | string | The start date of the search range , this date can be timestamps. Exp : 2025-09-02 , 2025-09-02T10:15 , 1756800000000 | | end\* | string | The end date of the search range , this date can be timestamps. Exp : 2025-09-09 , 2025-09-09T10:15 , 1757406000000 | | limit | number |

The maximum number of results to return per page

Max limit=144

| | page | number | The page of results to return | | granularity | string | The interval between dates of result data | | legacy | string | use old endpoint logic | {% tabs %} {% tab title="200: OK example route : /historical/derivs/perpetual/total\_volume\_by\_currency?start=2025-09-02\&end=2025-09-09" %} [swagger link](https://api.laevitas.ch/swagger/#/Analytics%20Options/getTotalVolumeForPerpetuals) ```json { "meta": { "total": 2117, "page": 1, "items": 5, "total_pages": 424 }, "items": [ { "date": 1756771200000, "BTC": 63284864109.19301, "ETH": 78187751249.65399, "Other": 84610428814.87665 } ] } ``` {% endtab %} {% endtabs %} ## Get total open interest (OI) for perpetuals across all markets `GET` `https://api.laevitas.ch/historical/derivs/perpetual/total_open_interest_by_currency` N/A #### Query Parameters | Name | Type | Description | | --------------------------------------- | ------ | --------------------------------------------------------------------------------------------------------------------- | | start\* | string | The start date of the search range , this date can be timestamps. Exp : 2025-09-02 , 2025-09-02T10:15 , 1756800000000 | | end\* | string | The end date of the search range , this date can be timestamps. Exp : 2025-09-09 , 2025-09-09T10:15 , 1757406000000 | | limit | number |

The maximum number of results to return per page

Max limit=144

| | page | number | The page of results to return | | granularity | string | The interval between dates of result data | | legacy | string | use old endpoint logic | {% tabs %} {% tab title="200: OK example route : /historical/derivs/perpetual/total\_open\_interest\_by\_currency?start=2025-09-02\&end=2025-09-09" %} [swagger link](https://api.laevitas.ch/swagger/#/Analytics%20Options/getTotalOiForPerpetuals) ```json { "meta": { "total": 2117, "page": 1, "items": 5, "total_pages": 424 }, "items": [ { "date": 1756771200000, "BTC": 47345554758.122, "ETH": 34540077175.543, "Other": 41487037704.42948 } ] } ``` {% endtab %} {% endtabs %} ## Retrieves historical data of futures contracts for a specific market and symbol `GET` `https://api.laevitas.ch/historical/derivs/futures/{market}/{symbol}` N/A #### Path Parameters | Name | Type | Description | | ---------------------------------------- | ------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | market\* | string | The market identifier. The value should be one of the valid markets defined in the Market enum. The input value will be transformed to uppercase. example: DERIBIT, BINANCE, BITGET, BITMEX, BYBIT, HUOBI, KRAKEN, OKX | | symbol\* | string | The symbol identifier example: DERIBIT (BTC, ETH, BTC, ETH), BINANCE (BTCUSD\_250627, ETHUSD\_250627, ETHUSDT\_250627, BTCUSDT\_250627), BITGET (BTCUSD\_250627, ETHUSD\_250627, ETHUSD\_250926, BTCUSD\_250926), BITMEX (XBTUSDTU25, XBTN25, ETHUSDM25, ETHUSDU25), BYBIT (BTC, ETH, BTC, ETH), HUOBI (ETH250704, BTC250704, ETH250926, BTC250627), KRAKEN (FI\_ETHUSD\_250926, FF\_ETHUSD\_250926, FF\_XBTUSD\_250926, FI\_XBTUSD\_250926), OKX (ETH, BTC, BTC, ETH) | #### Query Parameters | Name | Type | Description | | --------------------------------------- | ------ | --------------------------------------------------------------------------------------------------------------------- | | start\* | string | The start date of the search range , this date can be timestamps. Exp : 2025-09-02 , 2025-09-02T10:15 , 1756800000000 | | end\* | string | The end date of the search range , this date can be timestamps. Exp : 2025-09-09 , 2025-09-09T10:15 , 1757406000000 | | limit | number |

The maximum number of results to return per page

Max limit=144

| | page | number | The page of results to return | | granularity | string | The interval between dates of result data | {% tabs %} {% tab title="200: OK example route : /historical/derivs/futures/DERIBIT/BTC-26SEP25?start=2025-09-02\&end=2025-09-09" %} [swagger link](https://api.laevitas.ch/swagger/#/Analytics%20Options/getHistoricalFuturesData) ```json { "meta": { "total": 10581, "items": 10, "total_pages": 10581 }, "items": [ { "date": 1756771200000, "expiry": "26/09/25", "price": 109692.25, "index": 109195.47, "basis": 0.455, "yield": 6.82, "volume": 43978696.17, "volume_coin": 402.752, "open_interest": 351131770, "open_interest_coin": 3201.063, "oi_volume24h": 7.9841, "bid": 109692.5, "bid_amount": 5000, "ask": 109695, "ask_amount": 37460 } ] } ``` {% endtab %} {% endtabs %} ## Historical data for perpetual derivative contracts `GET` `https://api.laevitas.ch/historical/derivs/perpetuals/{market}/{symbol}` N/A #### Path Parameters | Name | Type | Description | | ---------------------------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | market\* | string | The market identifier. The value should be one of the valid markets defined in the Market enum. The input value will be transformed to uppercase. example: DERIBIT, AEVO, BINANCE, BITFINEX, BITGET, BITMEX, BLITZ, BYBIT, COINBASE, DYDX, HUOBI, HYPERLIQUID, KRAKEN, OKX, PARADEX, VERTEX | | symbol\* | string | The symbol identifier example: DERIBIT (ETH, BTC\_USDT, BTC, ETH\_USDC), AEVO (ETH, BTC), BINANCE (BTCUSD\_PERP, ETHUSD\_PERP, BTCUSDC, ETHUSDT), BITFINEX (tBTCF0:USTF0, tETHF0:USTF0), BITGET (BTCPERP, ETHUSDT, ETHUSD, BTCUSDT), BITMEX (XBTUSDT, XBTUSD, ETHUSD, ETHUSDT), BLITZ (BTC, ETH), BYBIT (BTCUSD, ETHUSD, BTCPERP, ETHPERP), COINBASE (ETH, BTC), DYDX (BTC, ETH), HUOBI (BTC, ETH, BTC, ETH), HYPERLIQUID (BTC, ETH), KRAKEN (PI\_XBTUSD, PF\_XBTUSD, PI\_ETHUSD, PF\_ETHUSD), OKX (ETH, ETH, BTC, BTC), PARADEX (BTC, ETH), VERTEX (BTC, BTC, ETH, ETH) | #### Query Parameters | Name | Type | Description | | --------------------------------------- | ------ | --------------------------------------------------------------------------------------------------------------------- | | start\* | string | The start date of the search range , this date can be timestamps. Exp : 2025-09-02 , 2025-09-02T10:15 , 1756800000000 | | end\* | string | The end date of the search range , this date can be timestamps. Exp : 2025-09-09 , 2025-09-09T10:15 , 1757406000000 | | limit | number |

The maximum number of results to return per page

Max limit=144

| | page | number | The page of results to return | | granularity | string | The interval between dates of result data | {% tabs %} {% tab title="200: OK example route : /historical/derivs/perpetuals/DERIBIT/ETH-PERPETUAL?start=2025-09-02\&end=2025-09-09" %} [swagger link](https://api.laevitas.ch/swagger/#/Analytics%20Options/getHistoricalPerpetualDerivativesData) ```json { "meta": { "total": 10581, "items": 10, "total_pages": 10581 }, "items": [ { "date": 1756771200000, "price": 4313.45, "index": 4312.4, "basis": 0.024, "funding": 0.0013, "yield": 1.423, "volume": 414642048.43, "volume_coin": 96151.11, "open_interest": 523106122, "open_interest_coin": 121273.255, "oi_volume24h": 1.2616, "long_short_ratio": 0, "next_funding": 0, "bid": 4313.6, "bid_amount": 3000, "ask": 4313.65, "ask_amount": 66400 } ] } ``` {% endtab %} {% endtabs %}