> ## 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.

# KOL ranking, calendar or date range availability

> Currently 503 kol_roster_unverified. The retained roster was built by SolanaTracker; its credential expired 2026-09-30, freshness is unknown and the roster is unverified. No rankings or calendar zeros are fabricated. Supply one period, UTC month, date, or inclusive from/to range. Same admission as trader research.



## OpenAPI

````yaml https://www.oceanx.trade/api/v1/openapi.json get /api/v1/leaderboards/kols
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/leaderboards/kols:
    get:
      tags:
        - Research
      summary: KOL ranking, calendar or date range availability
      description: >-
        Currently 503 kol_roster_unverified. The retained roster was built by
        SolanaTracker; its credential expired 2026-09-30, freshness is unknown
        and the roster is unverified. No rankings or calendar zeros are
        fabricated. Supply one period, UTC month, date, or inclusive from/to
        range. Same admission as trader research.
      operationId: getNativeKolLeaderboard
      parameters:
        - name: period
          in: query
          description: Requested period.
          schema:
            type: string
        - name: month
          in: query
          description: YYYY-MM.
          schema:
            type: string
        - name: date
          in: query
          description: YYYY-MM-DD UTC.
          schema:
            type: string
        - name: from
          in: query
          description: Inclusive YYYY-MM-DD UTC.
          schema:
            type: string
        - name: to
          in: query
          description: Inclusive YYYY-MM-DD UTC.
          schema:
            type: string
        - name: limit
          in: query
          description: Page size.
          schema:
            type: integer
            minimum: 1
            maximum: 200
        - name: cursor
          in: query
          description: Opaque cursor.
          schema:
            type: string
      responses:
        '400':
          description: Invalid selectors.
        '401':
          description: Missing or invalid API key.
        '403':
          description: API-key policy or md.read scope forbids the request.
        '429':
          description: Per-caller rate or concurrency limit; retry with backoff.
        '503':
          description: >-
            Native source, admission or verified KOL roster unavailable; no
            vendor fallback.
      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.