{"schemaVersion":1,"name":"PerpFinder Public Data API","description":"Stable, keyless and CORS-open crypto derivatives datasets intended for humans, search systems and software agents.","lastReviewed":"2026-07-23","documentation":"https://perpfinder.com/docs/api","openapi":"https://perpfinder.com/openapi.json","llms":"https://perpfinder.com/llms.txt","llmsFull":"https://perpfinder.com/llms-full.txt","dataDefinitions":"https://perpfinder.com/data-definitions","status":"https://perpfinder.com/status","attribution":"Data: PerpFinder (https://perpfinder.com)","conventions":{"missingValues":"null, never zero-filled","totalExecutionCost":"feeBps + halfSpreadBps + slippageBps","statusFields":["dataStatus","coverage","generatedAt","upstreamTimestamp","schemaVersion","sources"]},"endpoints":[{"path":"/api/data/perps","params":"","description":"Perp DEX volume overview (24h/7d/30d, change %, per protocol).","fields":"protocols[], dataStatus, generatedAt, upstreamTimestamp, schemaVersion, sources, ETag","public":true},{"path":"/api/data/slippage","params":"?asset=BTC&size=100000&feeType=taker|maker&side=buy|sell","description":"Live perp execution-cost ladder from order books and supported oracle/pool models. Total cost is fee + half-spread + size-dependent impact beyond the best quote.","fields":"asset, sizeUsd, side, results[].{exchange,feeBps,feeBpsMin,feeBpsMax,feeModel,slippageBps,halfSpreadBps,spreadBps,totalBps,midPrice,vwap,sufficient,quoteStatus,maxExecutableSizeUsd}, coverage, dataStatus, generatedAt, schemaVersion, sources, ETag","public":true},{"path":"/api/data/slippage-spot","params":"?asset=BTC&size=10000&feeType=taker|maker&side=buy|sell","description":"Live spot execution-cost ladder using venue order books, pair-specific fees, spread, VWAP impact and explicit depth coverage.","fields":"asset, sizeUsd, side, results[].{exchange,baseAsset,quoteAsset,feeBps,slippageBps,halfSpreadBps,spreadBps,totalBps,midPrice,vwap,sufficient}, coverage, dataStatus, generatedAt, schemaVersion, sources, ETag","public":true},{"path":"/api/data/dex-enrichment","params":"","description":"Direct DEX market enrichment: OI, volume, funding, prices, protocol stats and venue coverage.","fields":"protocols[], crossVenueFunding, coverage, dataStatus, generatedAt, upstreamTimestamp, schemaVersion, sources, ETag","public":true},{"path":"/api/data/perps-chart","params":"?days=90","description":"Aggregate daily perp-volume time series + total open interest per day (own snapshots).","fields":"chart[{date,volume,oi}]","public":true},{"path":"/api/data/volume","params":"","description":"CEX 24h volume per venue from direct venue-reported futures tickers + top symbols.","fields":"exchanges[], venueSlugs, updatedAt, dataStatus, generatedAt, upstreamTimestamp, schemaVersion, sources, ETag","public":true},{"path":"/api/data/open-interest","params":"","description":"Open interest per exchange (CEX+DEX) + aggregate total.","fields":"byExchange[], venueSlugs, updatedAt","public":true},{"path":"/api/data/oi-long-short","params":"","description":"DEX long vs short open-interest split per protocol.","fields":"rows[], updatedAt","public":true},{"path":"/api/data/funding-rates","params":"","description":"Live funding-rate matrix: asset × exchange (normalized 1h). Missing OI/price are null with per-venue field support and explicit feed coverage.","fields":"rows[], exchanges[], coverage, updatedAt, meta.fieldSupport, meta.venueSlugs, dataStatus, generatedAt, upstreamTimestamp, schemaVersion, sources, ETag","public":true},{"path":"/api/data/fees","params":"","description":"Protocol fees (DEX, 24h/7d/30d per protocol).","fields":"protocols[], dataStatus, generatedAt, upstreamTimestamp, schemaVersion, sources, ETag","public":true},{"path":"/api/data/liquidations","params":"","description":"Liquidations 24h/4h/1h, long vs short split.","fields":"rows[], updatedAt","public":true},{"path":"/api/data/options","params":"","description":"BTC/ETH options market state: mark IV per strike/expiry, ATM term structure, put/call, Deribit DVOL (attributed), expiries.","fields":"assets.{BTC,ETH}, dvol, termStructure[], expiries[], status, updatedAt","public":true},{"path":"/api/data/options-history","params":"?asset=BTC&metric=dvol&interval=15m|1d&days=N","description":"Self-collected options time series (no synthetic backfill); allowlisted metrics; maturity + methodologyVersion in every response.","fields":"series[], maturity, methodologyVersion, firstObservedAt, dataStatus, ETag","public":true},{"path":"/api/data/volume-quality","params":"","description":"Reported vs observable CEX volume signals with separate data-confidence scoring.","fields":"sweep.venues[], maturity, methodologyVersion, datasetStart, dataStatus","public":true},{"path":"/api/data/rwa-markets","params":"","description":"RWA perp markets: stocks / forex / commodities across venues.","fields":"markets[], updatedAt","public":true},{"path":"/api/data/mica","params":"","description":"Committed ESMA MiCA register snapshot joined to PerpFinder venue status, service permissions, EU-derivatives scope and fee context.","fields":"register, scope, coverage, authorized[], tracked[], dataStatus, generatedAt, upstreamTimestamp, schemaVersion, sources, ETag","public":true},{"path":"/api/data/premium","params":"","description":"Perp premium / basis vs spot per venue.","fields":"rows[], updatedAt","public":true},{"path":"/api/data/fear-greed","params":"","description":"Fear & Greed index (alternative.me, attributed).","fields":"value, updatedAt","public":true},{"path":"/api/data/funding-history","params":"?asset=BTC&type=aggregates|venue|realized&days=7&venue=Binance&rateType=current|predicted&format=csv","description":"Self-collected funding history: aggregates, per-venue sweeps, or the append-only realized-settlement ledger. Rate types never mixed; no synthetic backfill.","fields":"series[]/entries[], coverage, maturity, methodologyVersion, datasetStart, dataStatus, generatedAt, schemaVersion, sources, ETag","public":true},{"path":"/api/data/volume-quality-history","params":"?days=7&venue=&format=csv","description":"Volume-quality sweep history per venue (reported vs observable signals over time). Measurements, never accusations.","fields":"series[], maturity, methodologyVersion, datasetStart, updatedAt","public":true},{"path":"/api/data/venue-history","params":"?venue=Binance&days=30&format=csv","description":"Per-venue daily volume/OI history from the committed snapshot series (since 2026-06-05) — venue-reported figures, normalized; null never zero-filled.","fields":"series[], venueSlug, datasetStart, updatedAt","public":true},{"path":"/api/data/cost-history","params":"?market=perp&asset=BTC&size=100000&days=7&format=csv","description":"Execution-cost ladder history (fee + spread + VWAP slippage per venue, 4×/day). Young series — maturity labeled honestly.","fields":"series[], maturity, methodologyVersion, datasetStart, updatedAt","public":true}]}