> ## Documentation Index
> Fetch the complete documentation index at: https://docs.solanatracker.io/llms.txt
> Use this file to discover all available pages before exploring further.

# API de últimos trades de KOL en Solana

> Obtén los trades spot de DEX más recientes de wallets de la lista de KOL, con filtro de volumen mínimo en USD. Cada trade incluye identidad si existe.

Devuelve los trades spot de DEX más recientes de las wallets de la lista compartida de KOL con un volumen absoluto en USD igual o superior a `minVolume`. Cada trade incluye `identity` cuando está disponible.

## SDK Example

```typescript
import { Client } from '@solana-tracker/data-api';

const client = new Client({ apiKey: 'YOUR_API_KEY' });

const data = await client.getKolTrades({ limit: 100, showMeta: true });
```


## OpenAPI

````yaml /es/data-api/whale-kol.json get /trades/kols
openapi: 3.1.0
info:
  title: API de trades de ballenas y KOL de Solana Tracker
  version: 1.0.0
  description: >-
    Feeds REST con los últimos trades spot de alto volumen (ballenas) y los
    trades de Key Opinion Leaders (KOL).


    Los objetos de trade coinciden con los de `/trades/:token`, con `identity`
    de KOL opcional. Los feeds de ballenas usan `minVolume=1000` por defecto;
    los de KOL, `minVolume=0`.


    Los timestamps son milisegundos Unix. Los valores monetarios están en USD
    salvo que se indique lo contrario.
  contact:
    email: contact@solanatracker.io
  license:
    name: Proprietary
    url: https://www.solanatracker.io/terms
servers:
  - url: https://data.solanatracker.io
    description: Producción (mainnet)
  - url: https://data.solanatracker.io
    description: Producción (datos)
security:
  - apiKey: []
tags:
  - name: Whale Trades
    description: Últimos trades spot de DEX de alto volumen.
  - name: KOL Trades
    description: Últimos trades spot de DEX de las wallets de la lista compartida de KOL.
paths:
  /trades/kols:
    get:
      tags:
        - KOL Trades
      summary: Latest KOL spot trades
      description: >-
        Devuelve los trades spot de DEX más recientes de las wallets de la lista
        compartida de KOL con un volumen absoluto en USD igual o superior a
        `minVolume`. Cada trade incluye `identity` cuando está disponible.
      operationId: getKolTrades
      parameters:
        - $ref: '#/components/parameters/KolMinVolume'
        - $ref: '#/components/parameters/Cursor'
        - $ref: '#/components/parameters/Limit'
        - $ref: '#/components/parameters/ShowMeta'
        - $ref: '#/components/parameters/HideArb'
        - $ref: '#/components/parameters/SortDirection'
      responses:
        '200':
          $ref: '#/components/responses/TradesSuccess'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '500':
          $ref: '#/components/responses/ServerError'
      x-codeSamples:
        - lang: typescript
          label: SDK
          source: >
            import { Client } from '@solana-tracker/data-api';


            const client = new Client({ apiKey: 'YOUR_API_KEY' });


            const data = await client.getKolTrades({ limit: 100, showMeta: true
            });
      x-code-samples:
        - lang: typescript
          label: SDK
          source: >
            import { Client } from '@solana-tracker/data-api';


            const client = new Client({ apiKey: 'YOUR_API_KEY' });


            const data = await client.getKolTrades({ limit: 100, showMeta: true
            });
components:
  parameters:
    KolMinVolume:
      name: minVolume
      in: query
      required: false
      description: >-
        Volumen absoluto mínimo en USD para trades de KOL. Usa `0` u omite el
        parámetro para recibir todos los trades de KOL elegibles. Valores
        permitidos: `0`, `1000`, `2500`, `5000`, `10000`. Valor por defecto:
        `0`.
      schema:
        type: number
        enum:
          - 0
          - 1000
          - 2500
          - 5000
          - 10000
        default: 0
    Cursor:
      name: cursor
      in: query
      required: false
      description: >-
        Cursor de paginación. Usa preferiblemente el `nextCursor` opaco de la
        respuesta anterior (JSON en base64url de
        `time`/`tx`/`token`/`side`/`wallet`). También se acepta un timestamp en
        milisegundos sin procesar.
      schema:
        type: string
    Limit:
      name: limit
      in: query
      required: false
      description: 'Tamaño de página. Valor por defecto: `250`; máximo: `500`.'
      schema:
        type: integer
        minimum: 1
        maximum: 500
        default: 250
    ShowMeta:
      name: showMeta
      in: query
      required: false
      description: >-
        Si es true, añade metadatos de token `meta.from` / `meta.to` y precios
        históricos.
      schema:
        type: boolean
        default: false
    HideArb:
      name: hideArb
      in: query
      required: false
      description: >-
        Solo para KOL por token. Conserva las filas en las que from o to
        coincide con el token de la ruta.
      schema:
        type: boolean
        default: false
    SortDirection:
      name: sortDirection
      in: query
      required: false
      description: Solo se admite `DESC`.
      schema:
        type: string
        enum:
          - DESC
        default: DESC
  responses:
    TradesSuccess:
      description: Últimos trades spot
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/TradesResponse'
    BadRequest:
      description: Solicitud no válida (p. ej., cursor o minVolume incorrectos)
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          examples:
            invalidMinVolume:
              value:
                error: 'Invalid minVolume. Allowed: 1000, 2500, 5000, 10000'
            invalidCursor:
              value:
                error: Invalid cursor
    Unauthorized:
      description: API key ausente o no válida
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    ServerError:
      description: Error del servidor
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  schemas:
    TradesResponse:
      type: object
      required:
        - trades
        - nextCursor
        - hasNextPage
        - sortDirection
      properties:
        trades:
          type: array
          items:
            $ref: '#/components/schemas/Trade'
        nextCursor:
          type:
            - string
            - 'null'
          description: Cursor opaco en base64url para la siguiente página
        hasNextPage:
          type: boolean
        sortDirection:
          type: string
          enum:
            - DESC
        minVolume:
          type: number
          enum:
            - 1000
            - 2500
            - 5000
            - 10000
          description: Filtro de la solicitud devuelto tal cual
      example:
        trades:
          - tx: >-
              2fWJCNojUK7SyLY1atumdq1tPyUZSS9ENvH6XmdhozvkbZEjqF3aeh2APc93QNBCE4L1yDZCB5a3wp4fS7KCRc7H
            amount: 13720522.130153
            priceUsd: 0.0001106240879205581
            volume: 1517.8202464420085
            volumeSol: 20.202379779999998
            type: buy
            wallet: 9jyqFiLnruggwNn4EQwBNFXwpbLM9hrA4hV59ytyAVVz
            time: 1786471285000
            program: axiom-flash
            pools: []
            identity:
              name: Nach
              twitter: '@NachSOL'
              avatar: >-
                https://kol-avatar.solanatracker.io/9jyqFiLnruggwNn4EQwBNFXwpbLM9hrA4hV59ytyAVVz
        nextCursor: eyJ0aW1lIjoxNzg2NDcxMTg1MDAwfQ
        hasNextPage: true
        sortDirection: DESC
        minVolume: 1000
    Error:
      type: object
      required:
        - error
      properties:
        error:
          type: string
    Trade:
      type: object
      required:
        - tx
        - amount
        - priceUsd
        - volume
        - volumeSol
        - type
        - wallet
        - time
        - program
        - pools
      properties:
        tx:
          type: string
          description: Firma de la transacción
        amount:
          type: number
          description: Cantidad del token principal
        priceUsd:
          type:
            - number
            - 'null'
        volume:
          type: number
          description: Volumen en USD igual o superior a `$minVolume`
        volumeSol:
          type: number
        type:
          type: string
          enum:
            - buy
            - sell
        wallet:
          type: string
        time:
          type: integer
          description: Timestamp Unix en milisegundos
        program:
          type: string
        pools:
          type: array
          items:
            type: string
        identity:
          $ref: '#/components/schemas/Identity'
        meta:
          type: object
          description: Presente cuando `showMeta=true`
          properties:
            from:
              $ref: '#/components/schemas/TokenMetaSide'
            to:
              $ref: '#/components/schemas/TokenMetaSide'
    Identity:
      type: object
      description: Presente cuando la wallet está en la lista compartida de KOL.
      properties:
        name:
          type:
            - string
            - 'null'
        twitter:
          type:
            - string
            - 'null'
        avatar:
          type: string
    TokenMetaSide:
      type: object
      properties:
        name:
          type:
            - string
            - 'null'
        symbol:
          type:
            - string
            - 'null'
        image:
          type:
            - string
            - 'null'
        decimals:
          type:
            - integer
            - 'null'
        amount:
          type: number
        address:
          type: string
        priceUsd:
          type:
            - number
            - 'null'
      additionalProperties: true
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: x-api-key

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.