{"slug":"api-usenami-io-v1-perp-oi-history-f09f44","title":"Historical open-interest timeseries for one crypto perpetual on one venue, aggre","host":"api.usenami.io","method":"GET","resource":"https://api.usenami.io/v1/perp/oi-history","category":"market","description":"Historical open-interest timeseries for one crypto perpetual on one venue, aggregated 1h/4h/1d — positioning over time for backtests and regime studies. 30–90d window cap.","price_listed":0.005,"price_asked":null,"state":"no_terms","state_label":"Answers HTTP 404 without x402 payment terms","checks_7d":1,"answered_7d":0,"latency_ms_median":null,"reported_calls_30d":1,"reported_payers_30d":1,"networks":["eip155:8453"],"badge":"unverified","paid_checks_7d":0,"paid_ok_7d":0,"example_input":{"method":"GET","queryParams":{"aggr":{"description":"Default 1h.","enum":["1h","4h","1d"],"required":false,"type":"string"},"from":{"description":"Default: 7 days ago.","format":"date-time","required":false,"type":"string"},"ticker":{"description":"Base ticker. Required.","required":true,"type":"string"},"to":{"description":"Default: now.","format":"date-time","required":false,"type":"string"},"venue":{"description":"Venue name. Required.","required":true,"type":"string"}},"type":"http"},"output_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"properties":{"method":{"type":"string"},"type":{"type":"string"}},"required":["type","method"],"type":"object"}},"required":["input"],"type":"object"},"history":[{"day":"2026-09-24","reachable":true,"status":404,"valid_402":false,"asked_usdc":null,"price_match":null,"latency_ms":705,"error":null}],"description_full":"Historical open-interest timeseries for one crypto perpetual on one venue, aggregated 1h/4h/1d — positioning over time for backtests and regime studies. 30–90d window cap.","last_updated":"2026-09-01T12:08:18.308Z","schemes":["exact"]}