Skip to main content
GET
Read a retained Scout stage snapshot

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

stage
enum<string>
required
Available options:
new,
graduating,
migrated

Query Parameters

chain
enum<string>
default:solana
Available options:
solana
launchpad
string

Exact case-sensitive producer launchpad match; unknown excluded.

Pattern: ^[a-zA-Z0-9_.-]{1,64}$
minLiquidityUsd
string

Inclusive exact decimal threshold. Unknown liquidity is excluded, including when the minimum is zero.

Maximum string length: 128
Pattern: ^\d+(\.\d+)?$
maxAgeSeconds
integer

Inclusive age from producer-pinned first observation (createdAtMs), relative to selectionAtMs. Unknown/future creation observations are excluded.

Required range: 1 <= x <= 2592000
sort
enum<string>
default:createdAt
Available options:
createdAt,
volume5m,
liquidityUsd
order
enum<string>
default:desc
Available options:
asc,
desc
limit
integer
default:50
Required range: 1 <= x <= 200
cursor
string

Opaque HMAC-signed five-minute pagination cursor. Tampering or changed selectors: 400; expiry or evicted version: 410.

Required string length: 1 - 2048

Response

Qualified retained stage window; producer clocks and coverage preserved.

data
object
required
meta
object
required