> ## Documentation Index > Fetch the complete documentation index at: https://docs.oceanx.trade/llms.txt > Use this file to discover all available pages before exploring further. # Native token live > Owned multi-pool price, observed execution statistics, risk and viewed-token holder history. Top ten fresh pools with fully valued supported reserves; not a pool census. Stats count execution legs, not deduplicated economic routes. All-time totals require inception coverage and stay null. Imbalance is an observed heuristic, not a wash-trading verdict. No polling, vendor fallback or history scan. ## OpenAPI ````yaml https://www.oceanx.trade/api/v1/openapi.json get /api/v1/tokens/{chain}/{address}/live openapi: 3.1.0 info: title: OceanX Developer API version: 1.0.0 description: >- Public API for the OceanX trading platform. Currently in beta and free to use while in beta. This spec covers the **spot quote** domain. The wallet **tracker** and **perps** domains are documented at https://docs.oceanx.trade/api/overview and are not yet described here. contact: url: https://docs.oceanx.trade termsOfService: https://www.oceanx.trade/legal/terms license: name: Proprietary url: https://www.oceanx.trade/legal/terms servers: - url: https://www.oceanx.trade description: Production security: - bearerAuth: [] tags: - name: Router description: >- Read-only Raptor route quotes and public Solana transaction status. Build and execution remain separately gated. - name: Market Data description: Read-only OceanX market context sourced and cached by VM producers. - name: Spot description: >- Executable Solana swap quotes off OceanX's own router, and the exit checker that reports whether a whole position can be sold. - name: Callouts description: >- Public token callouts — user-posted token calls with live click/volume attribution stats. Read-only. - name: Copy Trading description: Key-owner follow, fill and PnL reads; no execution authority. - name: Price Alerts description: Key-owner alert management through the existing evaluator; no webhooks. paths: /api/v1/tokens/{chain}/{address}/live: get: tags: - Tokens summary: Native token live description: >- Owned multi-pool price, observed execution statistics, risk and viewed-token holder history. Top ten fresh pools with fully valued supported reserves; not a pool census. Stats count execution legs, not deduplicated economic routes. All-time totals require inception coverage and stay null. Imbalance is an observed heuristic, not a wash-trading verdict. No polling, vendor fallback or history scan. operationId: getTokenLive parameters: - name: chain in: path required: true schema: type: string enum: - solana - name: address in: path required: true schema: type: string - name: pool in: query schema: type: string description: >- Exact pool for prices and observed statistics. Holder/risk facts describe the mint. responses: '200': description: Owned observation. Coverage and nulls must be respected. content: application/json: schema: type: object required: - source - generated_at_ms - data properties: source: const: local generated_at_ms: type: integer data: type: object required: - mint - source - price - stats - risk - holderHistory - isHolderReward properties: mint: type: string source: const: oceanx_native price: type: object properties: aggregated: type: - object - 'null' properties: median: type: - string - 'null' description: >- Exact decimal; null means unobserved or incomplete. average: type: - string - 'null' description: >- Exact decimal; null means unobserved or incomplete. min: type: - string - 'null' description: >- Exact decimal; null means unobserved or incomplete. max: type: - string - 'null' description: >- Exact decimal; null means unobserved or incomplete. poolCount: type: integer maximum: 10 topPools: type: array maxItems: 10 items: type: object properties: poolId: type: string priceUsd: type: - string - 'null' description: >- Exact decimal; null means unobserved or incomplete. liquidityUsd: type: - string - 'null' description: >- Exact decimal; null means unobserved or incomplete. market: type: string observedAtMs: type: integer creation: type: object properties: createdAtMs: type: - integer - 'null' minimum: 0 reserves: type: - object - 'null' complete: const: false scope: type: string pool: type: - string - 'null' stats: type: object properties: allTime: type: 'null' description: >- Requires certified inception and pool census coverage; never substitute the observed subset. observed: type: - object - 'null' properties: buys: type: - integer - 'null' minimum: 0 sells: type: - integer - 'null' minimum: 0 volumeUsd: type: - string - 'null' description: >- Exact decimal; null means unobserved or incomplete. fromMs: type: - integer - 'null' minimum: 0 toMs: type: - integer - 'null' minimum: 0 unpricedExecutions: type: - integer - 'null' minimum: 0 pool: type: - string - 'null' complete: const: false truncated: type: boolean suspiciousVolume: type: object properties: value: type: - boolean - 'null' rule: type: string complete: const: false risk: type: object properties: asOf: type: - integer - 'null' minimum: 0 expiresAt: type: - integer - 'null' minimum: 0 source: type: string complete: const: false bundlerCount: type: - integer - 'null' minimum: 0 bundlerPercentage: type: - string - 'null' description: >- Exact decimal; null means unobserved or incomplete. sniperCount: type: - integer - 'null' minimum: 0 sniperPercentage: type: - string - 'null' description: >- Exact decimal; null means unobserved or incomplete. insiderCount: type: - integer - 'null' minimum: 0 insiderPercentage: type: - string - 'null' description: >- Exact decimal; null means unobserved or incomplete. bundlerRisk: type: object properties: score: type: - integer - 'null' minimum: 0 rule: type: string inferred: const: true holderHistory: type: object properties: points: type: array maxItems: 288 items: type: object required: - observedAtMs - holders - complete properties: observedAtMs: type: integer holders: type: integer minimum: 0 complete: const: true intervalMs: const: 300000 scope: type: string complete: const: false isHolderReward: type: - boolean - 'null' holderRewardReason: type: string holderRewardObservedAtMs: type: - integer - 'null' description: >- Confirmed native observation time; expires after 120 seconds. '400': description: Invalid or duplicate query parameter. '401': description: API key required. '403': description: md.read scope required. '409': description: Cursor expired or changed; restart pagination. '422': description: Unsupported chain or filter. '429': description: Rate or concurrency limit exceeded. '503': description: Native source unavailable or response budget exceeded. security: - bearerAuth: [] components: securitySchemes: bearerAuth: type: http scheme: bearer description: >- 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. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.