Skip to main content
GET
Read cached token execution legs

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, and alert operations use alerts.read or alerts.write. New scopes require explicit selection and grant no trading authority. Existing perps operations retain their documented scopes.

Path Parameters

chain
enum<string>
required
Available options:
solana
address
string
required
Pattern: ^[1-9A-HJ-NP-Za-km-z]{32,44}$

Query Parameters

events
enum<string>
default:trades

Default preserves the trade contract. all/liquidity return TokenActivityResponse from our own captures, with eventType discriminators and partial LP coverage. side/minUsd are rejected for mixed/LP reads. No SolanaTracker. LP scopes admit 2 concurrent requests/IP, 60 starts/min/IP and 32 global; unavailable limiter fails closed.

Available options:
trades,
all,
liquidity
pool
string
wallet
string

Exact case-sensitive Solana signer. Combines with pool. Public execution filter, not an owned-wallet permission.

sortDirection
enum<string>
default:desc

Execution time order. Repeat on every cursor request.

Available options:
asc,
desc
side
enum<string>
Available options:
buy,
sell
minUsd
string

Nonnegative decimal within native decimal precision/range; unsupported precision returns 400 invalid_min_usd. Unknown valuations are excluded by this filter.

Pattern: ^(0|[1-9]\d*)(\.\d+)?$
fromMs
integer

Inclusive epoch milliseconds. Defaults to toMs minus one hour.

Required range: x >= 0
toMs
integer

Exclusive epoch milliseconds, no later than now; defaults to now rounded down to a second.

Required range: x >= 0
limit
integer
default:100
Required range: 1 <= x <= 500
cursor
string

Opaque pinned cursor. Repeat fromMs, toMs, limit and filters from the first page. Restart on expiry or correction.

Required string length: 20 - 1024

Response

Cached execution-leg page with explicit retained coverage; no empty partial success.

data
object[]
required
Maximum array length: 500
nextCursor
string | null
required
hasNextPage
boolean
required

Another page exists in this retained snapshot; false is not proof of complete token or wallet history. Equivalent to nextCursor !== null.

meta
object
required