{"uid":"cap_uf5P9JX15s4_IxEqXWnok","slug":"laevitas-historical-futures-settlement-funding-rate-648078ca","name":"Laevitas Historical Futures Settlement & Funding Rate","description":"Professional market data API for crypto derivatives, spot markets, prediction markets, Hyperliquid HyperCore data, proprietary volatility surfaces, and analytics.\n\n## Authentication\n\nUse an API key for authenticated REST requests:\n\n```http\nX-API-Key: your-api-key-here\n```\n\nData and history endpoints also accept x402 without an API key: 1, 5 or 10 credits ($0.001 each) for data up to 1 year, 1–3 years or older.\n\n**Subscriptions with USDC:** Premium and Enterprise can be purchased on Base or Solana for a month, a quarter, six months or a year. Access is prepaid, with no automatic renewal. [Buy a subscription](https://v3.laevitas.ch/profile/subscription/wallet) or read the [USDC subscription guide](/x402#subscriptions).\n\nThe subscription belongs to your signed-in Laevitas account; wallet sign-in does not require an email. Enterprise users generate an API key in V3 after activation. Plan and billing-period limits still apply. Subscription purchases are separate from API credit bundles.\n\nFor Claude MCP, add `https://apiv2.laevitas.ch/api/v1/mcp`, select **Sign in now → Register automatically**\nwith no custom headers, and authorize with your API key on the Laevitas page.\nDo not enter a client ID or secret manually. All OAuth clients require PKCE S256.\nConnection guide: [MCP setup](/mcp). CIMD / published client identity is not supported.\n\n| Resource | Path |\n| --- | --- |\n| OpenAPI JSON | `GET /openapi.json` |\n| x402 discovery | `GET /.well-known/x402` |\n| Changelog | `GET /api/v1/changelog` |\n| WebSocket docs | `GET /websocket` |\n\n## REST Surfaces\n\n| Surface | Examples |\n| --- | --- |\n| Instruments | Cross-market contract reference data |\n| Futures | OHLCVT, trades, tickers, orderbook, liquidations, carry |\n| Perpetuals | OHLCVT, trades, funding, open interest, orderbook, liquidations |\n| Options | OHLCVT, trades, Greeks, volatility, flow, dealer GEX |\n| Options Backtests | Strategy templates, asynchronous submission, status, combined results, cancellation |\n| Vol Surface | Proprietary surface snapshots, slices, strikes, term structure, risk |\n| Spot | OHLCVT, ticker, trades, volume, L2 orderbook, snapshots |\n| Predictions | Polymarket instruments, categories, trades, ticker history |\n| Hyperliquid - HyperCore | Node-derived fills, liquidations, positions, funding, TWAPs, resting orders, L2 books |\n| Analytics | Realized volatility and derived metrics |\n\n## Pagination\n\nBacktests are asynchronous jobs, not paginated market-data queries. Start with\n`GET /api/v1/options/backtests/strategies`, submit with `POST /api/v1/options/backtests`,\nthen poll `/{id}` and retrieve `/{id}/result`. These responses have no data/meta wrapper.\n\nPaginated endpoints return the cursor at `meta.next_cursor`. Pass that value back as the `cursor` query parameter to fetch the next page.\n\n## WebSocket Streaming\n\nReal-time streams are documented at `/websocket`.\n\n| Data | Channel pattern |\n| --- | --- |\n| Trades | `trades.{market}.{exchange}.{instrument}` |\n| OHLC ticker | `ohlc.ticker.{market}.{exchange}.{instrument}.{timeframe}` |\n| OHLCVT | `ohlc.vt.{market}.{exchange}.{instrument}.{timeframe}` |\n\nVariables: `market` is one of `perpetuals`, `futures`, `options`, or `spot`; `timeframe` is one of `1m`, `5m`, `15m`, `1h`, `4h`, or `1d`.\n\n## Quick Start\n\n```bash\ncurl \"https://apiv2.laevitas.ch/api/v1/futures/ohlcvt?exchange=deribit&instrument_name=BTC-PERPETUAL\" \\\n  -H \"X-API-Key: your-api-key-here\"\n```","url":"https://apiv2.laevitas.ch/api/v1/historical/futures/settlement_funding_rate/%7Bmarket%7D/%7Bsymbol%7D?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","required":["start"],"properties":{"end":{"type":"string","description":"Inclusive. Date-only includes the whole UTC day; omitted end includes tomorrow UTC."},"page":{"type":"number","description":"Default query page 1. Omitted meta.page preserved for single-generation requests."},"limit":{"type":"integer","description":"Default query 10 rows. Omitted total_pages divisor is 1, except cross-generation spot paging uses its actual limit."},"start":{"type":"string","description":"Inclusive legacy ISO/date-only or 10/13-digit epoch."}}},"responseSchema":{"type":"object","required":["items","meta"],"properties":{"meta":{"type":"object","required":["total","limit","total_pages"],"properties":{"limit":{"enum":[0],"type":"number"},"total":{"type":"integer","maximum":9007199254740991,"minimum":0},"total_pages":{"type":"integer","maximum":9007199254740991,"minimum":0}},"additionalProperties":false},"items":{"type":"array","items":{"type":"object","required":["date","funding_rate"],"properties":{"date":{"type":"integer","maximum":9007199254740991,"minimum":0,"description":"Settlement time, Unix epoch milliseconds, UTC."},"funding_rate":{"type":"number","nullable":true,"description":"Funding rate settled for the interval ending at this time, as a fraction; not annualized."}},"additionalProperties":false}}},"additionalProperties":false},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.1","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.1/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_GQr7YIDioyc784SQBuDRO","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.1","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns paginated historical funding rates settled at each interval for a specified crypto futures market and symbol over a given date range.","exampleAgentPrompt":"Pull the historical settlement funding rates for BTC perpetual futures on Binance from January 1, 2024 to March 31, 2024, page 1 with 50 rows per page.","exampleUseCases":[{"title":"Funding rate trend analysis for BTC perps","prompt":"Get me the daily settlement funding rates for BTC perpetuals on Bybit from July 1, 2023 through December 31, 2023 — I want to see how the rate evolved over those six months, first page with 100 rows."},{"title":"Carry trade backtesting data pull","prompt":"I need historical funding rate data for ETH perps on OKX going back to January 1, 2022 through December 31, 2022, 50 rows per page starting at page 1, so I can backtest a carry trade strategy."},{"title":"Cross-market funding rate comparison","prompt":"Fetch the funding rate history for SOL-PERP on dYdX from March 1, 2024 to May 31, 2024, page 1 with 200 rows, so I can compare it against another exchange's rates for the same period."}],"resultDescription":"Returns a paginated list of settlement funding rate records, each containing a Unix epoch millisecond timestamp (the settlement time) and a funding_rate value expressed as a raw fraction (not annualized). Also includes metadata: total record count, page limit, and total pages for navigating results.","failureModes":["Missing required 'start' parameter returns a 400 validation error","Invalid market or symbol path parameter may return 404 or empty items array","Date range too broad without pagination may return partial data or require multiple pages","Expired or invalid API key returns 401 unauthorized; insufficient credits return 402 Payment Required","Rate limiting may return 429 Too Many Requests for high-frequency callers"],"whenToPreferThis":"Choose this endpoint when you need time-series historical funding rate data for crypto perpetual or futures contracts, especially for backtesting, carry trade analysis, or academic research. Prefer this over real-time funding rate feeds when you need data spanning weeks, months, or years rather than the current snapshot. It supports paginated access, making it suitable for bulk data extraction across long periods.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:42:16.612Z","isFirstParty":false,"canonicalSlug":"laevitas-historical-futures-settlement-funding-rate-648078ca"}