Messaging

## WebSocket Streaming API For real-time data streams, see the [WebSocket Documentation](/websocket). ### Available channels: | Description | Channel | |-------|-------------| | Live trades | trades.{market}.{exchange}.{instrument} | | OHLC ticker | ohlc.ticker.{market}.{exchange}.{instrument}.{timeframe} | | OHLC VT | ohlc.vt.{market}.{exchange}.{instrument}.{timeframe} | | variable | Examples | |-------|-------------| | market | perpetuals, futures, options, spot | | exchange | supported exchange (e.g., binance, okx, deribit, bybit, hyperliquid) | | instrument | instrument name (e.g., BTC-PERPETUAL, ETH-30JUN23-2000-C) | | timeframe | 1m, 5m, 15m, 1h, 4h, 1d | --- ## Authentication All requests require an API key in the header: ```http X-API-Key: your-api-key-here ``` ## x402 Pay-Per-Request All data endpoints support x402 pay-per-request — no API key needed. - Discovery: `GET /.well-known/x402` - OpenAPI: `GET /openapi.json` - Price: $0.001 per request (USDC on Base) ## Quick Start ```bash curl -X GET "https://apiv2.laevitas.ch/futures/ohlcvt?exchange=deribit&instrument_name=BTC-PERPETUAL" -H "X-API-Key: your-api-key-here" ``` ## Python Example: Fetch Metadata and OHLCVT Data This example shows how to fetch metadata first to get data availability, then query OHLCVT data for BTC-PERPETUAL on Deribit: ```python import requests from datetime import datetime API_KEY = "your-api-key-here" BASE_URL = "https://apiv2.laevitas.ch" HEADERS = {"X-API-Key": API_KEY} # Step 1: Fetch metadata to get start date and data availability metadata_response = requests.get( f"{BASE_URL}/perpetuals/metadata", headers=HEADERS, params={ "exchange": "deribit", "instrument_name": "BTC-PERPETUAL", "limit": 100 } ) metadata = metadata_response.json() print(f"Instrument: {metadata['instrument_name']}") print(f"Exchange: {metadata['exchange']}") print(f"Data available from: {metadata['start_date']}") print(f"Data available until: {metadata['end_date']}") print(f"Total records: {metadata['total_count']:,}") print(f"Total pages (limit=100): {metadata['total_pages']:,}") # Step 2: Fetch OHLCVT data using the start date from metadata ohlcvt_response = requests.get( f"{BASE_URL}/perpetuals/ohlcvt", headers=HEADERS, params={ "exchange": "deribit", "instrument_name": "BTC-PERPETUAL", "resolution": "1h", "start": metadata['start_date'], "limit": 100 } ) ohlcvt_data = ohlcvt_response.json() print(f"\nFetched {len(ohlcvt_data['data'])} OHLCVT records") print(f"First record timestamp: {ohlcvt_data['data'][0]['minute']}") # Step 3: Paginate through data using cursor next_cursor = ohlcvt_data['meta']['next_cursor'] if next_cursor: next_page_response = requests.get( f"{BASE_URL}/perpetuals/ohlcvt", headers=HEADERS, params={ "exchange": "deribit", "instrument_name": "BTC-PERPETUAL", "resolution": "1h", "start": metadata['start_date'], "cursor": next_cursor, "limit": 100 } ) next_page_data = next_page_response.json() print(f"Next page has {len(next_page_data['data'])} records") ``` ### Available Data #### Perpetuals - OHLCVT candlestick data with volume breakdown - Mark and index reference prices - Open interest tracking - Funding rates and carry metrics - Trade-by-trade data - Best bid/ask snapshots - Metadata endpoint for data availability #### Futures - OHLCVT candlestick data with volume breakdown - Mark and index reference prices - Open interest tracking - Trade-by-trade data - Best bid/ask snapshots - Metadata endpoint for data availability #### Options - Options OHLC with Greeks and IV - Volatility surface data - Options flow and volume - Open interest by strike/expiry - Metadata endpoint for data availability #### Spot - OHLCVT candlestick data with buy/sell volume breakdown (base + quote currency) - Ticker OHLC (bid/ask/spread/size dynamics, 24h rolling stats) - Large trades (>=$1M) with quote amount and BBO at time of trade - Volume breakdown by time bucket - L2 orderbook aggregated depth metrics (4 depth levels) - Raw L2 orderbook snapshots with full bid/ask arrays - Per-instrument snapshots - Metadata endpoint for data availability ### Supported Exchanges Binance, OKX, Deribit, Bybit, Bullish (options + perpetuals), Derive (options only), Hyperliquid (perpetuals only), Nado (perpetuals only), Coinbase (spot only), Kraken (spot + futures + perpetuals) ### Response Format All endpoints return paginated JSON responses with cursor-based navigation for large datasets. ### Rate Limiting Default: 240 requests per 60 seconds per API key ### Support - Email: support@laevitas.ch - WebSocket API: [/websocket](/websocket) - Changelog: /api/v1/changelog

Solana Basex402

0.1 USDC / per-call

x402scan

View in directory ↗