Skip to main content
POST
Route quote

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.

Body

application/json
inputMint
string
required

Base58 Solana mint address.

Pattern: ^[1-9A-HJ-NP-Za-km-z]{32,44}$
outputMint
string
required

Base58 Solana mint address.

Pattern: ^[1-9A-HJ-NP-Za-km-z]{32,44}$
amount
string

Atomic (base-unit) amount as a decimal integer string. A string, not a number, because a large 9-decimal balance exceeds Number.MAX_SAFE_INTEGER and would be corrupted by JSON float parsing.

Pattern: ^\d+$
Example:

"1000000000"

uiAmount
number
inputDecimals
integer
Required range: 0 <= x <= 18
slippageBps
integer
default:50
Required range: 1 <= x <= 1000
dexes
string
Maximum string length: 256
pools
string
Maximum string length: 256
maxHops
integer
Required range: 1 <= x <= 4
onlyDirectRoutes
boolean

Response

Raptor quote response.

The response is of type object.