Skip to main content
GET
Compare perps quotes

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
side
enum<string>
required

Order side.

Available options:
buy,
sell
size
number
required

Size in coin units.

Required range: x <= 1000000000000
holdHintHours
number
default:1

Expected hold duration.

Required range: 0 <= x <= 8760
venues
string

Comma-separated venue keys.

Required string length: 1 - 256

Response

Per-venue cost estimates.

perVenue
object[]
required
bestPick
object | null
required
reasonBps
number
required