{"uid":"cap_8j61SdcWBsdaM9wUWm19G","slug":"debyko-historical-snapshots-d99c6436","name":"DEBYKO Historical Snapshots","description":"Historical funding rate, open interest, mark price and order book data for crypto perpetual futures across 19 venues (Aster Perpetuals, Avantis, Binance USD-M Futures, Bitget Perpetual Futures, Bybit Perpetuals, Coinbase Global Derivatives and 13 more), exactly as stored: as of a past instant, per interval, or every update as received. For backtests and audits. Gaps are marked as gaps, not interpolated. No charge when nothing recorded is returned. 0.02 USDC per call.","url":"https://api.debyko.com/v2/snapshots/history?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"at":{"type":"array","items":{"type":"string"},"description":"Instants, UTC and ascending, to read as the history recorded them; instead of interval, without from and to."},"to":{"allOf":[{"type":"string","pattern":"^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}(\\.[0-9]{3})?Z$"}],"description":"End of the window, UTC, e.g. 2026-10-01T06:00:00Z."},"raw":{"type":"boolean","default":false,"description":"true returns every update as it arrived; needs from and to."},"from":{"allOf":[{"type":"string","pattern":"^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}(\\.[0-9]{3})?Z$"}],"description":"Start of the window, UTC, e.g. 2026-10-01T00:00:00Z."},"kind":{"enum":["perpetual","spot","all"],"type":"string","default":"perpetual"},"units":{"enum":["published","base"],"type":"string","default":"published"},"where":{"oneOf":[{"type":"string"},{"type":"object"}],"description":"DQL selection of the markets to read, e.g. base in (BTC) or venue = HYPERLIQUID and base = BTC."},"layers":{"type":"array","items":{"enum":["ticker","mark","funding","oi","book","stats","venue_depth"],"type":"string"},"description":"Layers to read: ticker, mark, funding, oi, book, stats, venue_depth."},"interval":{"type":"string","description":"One row per period of this length, e.g. 1m or 1h, holding the last reading in it; needs from and to."},"freshness":{"type":"string"},"allow_stale":{"type":"boolean","default":false},"include_gaps":{"type":"boolean","default":true},"number_format":{"enum":["json","string"],"type":"string","default":"json"},"include_synthetic":{"type":"boolean","default":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_6ocPZAqvBimYCol9QRNml","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns an as-of snapshot of any crypto perpetual instrument at a specified past moment, exactly as stored, with gaps returned as gaps.","exampleAgentPrompt":"Show me the funding rate, mark price, and open interest for BTC-PERP on Binance exactly as stored at 2024-11-15T08:00:00Z — include any gaps if the data isn't there.","exampleUseCases":[{"title":"Backtest funding rate at specific moment","prompt":"Pull the funding rate and open interest snapshot for ETH-PERP as it was stored at 2024-10-01T00:00:00Z — I need the raw stored values with gaps preserved, not any interpolated fill."},{"title":"Audit mark price at liquidation event","prompt":"What was the exact stored mark price and ticker data for SOL-PERP at 2024-09-12T14:30:00Z? I need the as-of historical snapshot with venue depth included for a liquidation audit."},{"title":"Historical book depth for strategy review","prompt":"Fetch the order book and venue depth snapshot for BTC-PERP across all venues as stored between 2024-08-01T00:00:00Z and 2024-08-01T06:00:00Z at 1-hour intervals — include stats and mark layers too."}],"resultDescription":"Returns one or more historical snapshots of the requested instrument, exactly as stored at the specified past moment(s). Each snapshot includes the requested data layers (ticker, mark price, funding rate, open interest, order book, stats, venue depth). Gaps in stored data are returned as explicit gap indicators rather than being filled or interpolated. Numbers can be returned as JSON or string format.","failureModes":["No data found for the requested instrument/timestamp combination — gap returned in response","Invalid timestamp format (must match ISO 8601 pattern with Z suffix)","Unknown instrument identifier in 'where' filter — empty or error response","Unsupported layer enum value — validation error","Interval string not parseable — request rejected","Payment not completed or insufficient USDC balance — 402 response","allow_stale=false with no fresh data available — gap or empty result"],"whenToPreferThis":"Use this endpoint when you need the exact stored value of a crypto perpetual market data point at a specific past moment, with no interpolation or gap-filling. Ideal for backtesting, auditing, or reconstructing market state at a precise historical timestamp. Prefer this over OHLCV candles when you need non-aggregated snapshots (mark, funding, OI, book) rather than open/high/low/close/volume. Choose this over the live/latest endpoint when historical precision matters and you explicitly want gaps returned as gaps.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-15T06:32:44.004Z","isFirstParty":false,"canonicalSlug":"debyko-historical-snapshots-d99c6436"}