{"openapi":"3.1.0","info":{"title":"Crypto Options Put/Call Ratio & Sentiment API","version":"1.0.0","description":"The single headline gauge of how the crypto options market is positioned, computed live from Deribit's public option book — no key, nothing stored. The put/call ratio is the amount of put activity divided by call activity: a low ratio means the market is loaded with calls (bullish, greedy positioning), a high ratio means puts dominate (hedging, fear). The ratio endpoint returns, for a currency (BTC or ETH), the market-wide put/call ratio computed two ways — by open interest (the standing positioning) and by 24-hour volume (today's flow) — with the call and put totals, the spot index and a plain-language sentiment label. The expiries endpoint breaks the put/call ratio down by expiry, revealing the term structure of sentiment: whether hedging is concentrated in the near term or further out. This is the aggregate options put/call sentiment cut for crypto — distinct from the US-equity put/call API (a different market), the max-pain / open-interest positioning view, the implied-vol skew surface and the gamma-exposure APIs in the catalogue. Below roughly 0.7 is call-heavy and bullish, above 1.0 put-heavy and defensive; it is most useful read as a contrarian gauge. Currency is BTC or ETH, the two assets Deribit lists liquid options for.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/cryptoputcall-api","description":"oanor gateway"}],"tags":[{"name":"Put/Call"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/expiries":{"get":{"operationId":"get_v1_expiries","tags":["Put/Call"],"summary":"Put/call ratio by expiry (term structure)","description":"","parameters":[{"name":"currency","in":"query","required":true,"description":"BTC or ETH","schema":{"type":"string"},"example":"BTC"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"put/call ratio by open interest per expiry — the term structure of options sentiment. A higher ratio at near-dated expiries means hedging is concentrated short-term.","count":12,"source":"Deribit","currency":"BTC","expiries":[{"expiry":"13JUN26","put_oi":3935.3,"call_oi":1668.6,"put_call_ratio_oi":2.358},{"expiry":"14JUN26","put_oi":1244.8,"call_oi":603.2,"put_call_ratio_oi":2.064},{"expiry":"15JUN26","put_oi":600.7,"call_oi":786.8,"put_call_ratio_oi":0.763},{"expiry":"16JUN26","put_oi":59.2,"call_oi":7,"put_call_ratio_oi":8.457},{"expiry":"19JUN26","put_oi":9750.8,"call_oi":14694.3,"put_call_ratio_oi":0.664},{"expiry":"26JUN26","put_oi":66834.5,"call_oi":85503.9,"put_call_ratio_oi":0.782},{"expiry":"3JUL26","put_oi":930.7,"call_oi":1290.4,"put_call_ratio_oi":0.721},{"expiry":"31JUL26","put_oi":12568.3,"call_oi":38181.5,"put_call_ratio_oi":0.329},{"expiry":"28AUG26","put_oi":3206.8,"call_oi":5650.2,"put_call_ratio_oi":0.568},{"expiry":"25SEP26","put_oi":27774.2,"call_oi":49194.3,"put_call_ratio_oi":0.565},{"expiry":"25DEC26","put_oi":27780.5,"call_oi":52475.6,"put_call_ratio_oi":0.529},{"expiry":"26MAR27","put_oi":6709.7,"call_oi":12467.1,"put_call_ratio_oi":0.538}],"underlying_price":64914.5},"meta":{"timestamp":"2026-06-12T10:35:38.412Z","request_id":"9914d09e-bf80-48d2-9556-1eea1dff3b4b"},"status":"ok","message":"Expiries retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/ratio":{"get":{"operationId":"get_v1_ratio","tags":["Put/Call"],"summary":"Market-wide put/call ratio & sentiment","description":"","parameters":[{"name":"currency","in":"query","required":true,"description":"BTC or ETH","schema":{"type":"string"},"example":"BTC"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"put/call ratio = put activity / call activity. By open interest it reflects standing positioning; by 24h volume it reflects today's flow. Below ~0.7 is call-heavy (bullish positioning); above ~1.0 is put-heavy (hedging/fear). A contrarian sentiment gauge.","put_oi":161395.5,"source":"Deribit","call_oi":262522.9,"currency":"BTC","total_oi":423918.4,"sentiment_oi":"bullish (calls dominate)","put_volume_24h":11535,"sentiment_flow":"bullish (calls dominate)","call_volume_24h":17732.1,"underlying_price":64914.5,"put_call_ratio_oi":0.615,"put_call_ratio_volume":0.651},"meta":{"timestamp":"2026-06-12T10:35:38.562Z","request_id":"c8c18eb3-0e13-4b69-8e7d-27a3de398aa3"},"status":"ok","message":"Ratio retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Spec","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"currency is BTC or ETH. The ratio is computed across all listed options. Below ~0.7 is call-heavy/bullish positioning, above ~1.0 put-heavy/hedging. Read fresh per call, nothing cached.","source":"Deribit public API (deribit.com/api/v2/public, live)","service":"cryptoputcall-api","endpoints":{"GET /v1/meta":"This document.","GET /v1/ratio":"Market-wide put/call ratio by OI and by 24h volume with sentiment (currency=BTC).","GET /v1/expiries":"Put/call ratio by expiry — the sentiment term structure (currency=BTC)."},"currencies":["BTC","ETH"],"description":"Crypto options put/call ratio and sentiment, computed live from Deribit's public option book (no key, nothing stored). ratio returns BTC's or ETH's market-wide put/call ratio by open interest (standing positioning) and by 24-hour volume (today's flow), with call/put totals, the spot index and a sentiment label. expiries breaks the ratio down by expiry — the term structure of sentiment. The aggregate options put/call sentiment cut for crypto — distinct from the US-equity put/call API, the max-pain / open-interest view, the IV skew surface and the gamma-exposure APIs.","upstream_status":"ok","btc_put_call_ratio_oi":0.615},"meta":{"timestamp":"2026-06-12T10:35:38.741Z","request_id":"d584cfc5-8d1f-4945-bd71-263a2fb3f6d8"},"status":"ok","message":"Meta","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":500,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":1144,"monthly_call_quota":11400,"rps_limit":6,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":3466,"monthly_call_quota":68000,"rps_limit":16,"hard_limit":true},{"slug":"business","name":"Business","price_cents_month":7840,"monthly_call_quota":360000,"rps_limit":40,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/cryptoputcall-api"}