Skip to main content
GET
Open-interest history

Authorizations

Authorization
string
header
required

An OceanX API key, created in the app under Settings → Developer API. Send it as Authorization: Bearer ox_live_…. Required scopes are operation-specific: market reads use md.read, tracker uses tracker.read, copy reads use copy.read, alert operations use alerts.read or alerts.write, and owned wallet/funding reads require explicit account.read. New scopes require explicit selection and grant no trading authority. Existing perps operations retain their documented scopes.

Query Parameters

symbol
string
required

Cross-venue symbol.

Required string length: 1 - 64
venue
string

Optional venue filter.

Required string length: 1 - 32
hours
number

Default 6. Router clamps to at least 0.25 hours; range rounds down to whole minutes.

Required range: x <= 48

Response

Captured history window.

symbol
string
required
hours
number
required
rows
object[]
required
Maximum array length: 50000