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

# Token Search

> Busca tokens por símbolo, nombre o dirección, con múltiples filtros y opciones de ordenación.

## SDK Example

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

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

const data = await client.searchTokens({ query: 'BONK', limit: 10 });
```


## OpenAPI

````yaml /es/data-api/openapi.json get /search
openapi: 3.1.0
info:
  title: API de datos Solana Tracker
  description: >-
    API de datos de Solana Tracker: precios de tokens, tenedores, operaciones,
    gráficos, datos de cartera, señales de riesgo y analítica de mercado.
  version: 1.0.0
  contact:
    email: contact@solanatracker.io
servers:
  - url: https://data.solanatracker.io
    description: Entorno de producción
security:
  - apiKey: []
paths:
  /search:
    get:
      tags:
        - Search
      summary: Token Search
      description: >-
        Busca tokens por símbolo, nombre o dirección, con múltiples filtros y
        opciones de ordenación.
      parameters:
        - name: query
          in: query
          description: 'Término: símbolo, nombre o dirección del token'
          schema:
            type: string
        - name: symbol
          in: query
          description: Devuelve todos los tokens cuyo símbolo coincide exactamente
          schema:
            type: string
        - name: page
          in: query
          description: Número de página (paginación por desplazamiento)
          schema:
            type: integer
            default: 1
        - name: limit
          in: query
          description: >-
            Primary page size for organic search hits (max 500, or max 100 when
            format=full). `pages` is calculated from this limit. The response
            `data` array may include up to **5 additional curated/promoted
            rows** on top of the organic page, so `data.length` can be as high
            as `limit + 5`.
          schema:
            type: integer
            default: 100
            maximum: 500
        - name: format
          in: query
          description: >-
            Formato de respuesta. Con full se devuelven objetos token completos
            (misma forma que GET /tokens/:token: token, pools, events, risk,
            compras, ventas, txns, holders, etc.). Con format=full el máximo por
            página es 100.
          schema:
            type: string
            enum:
              - full
        - name: cursor
          in: query
          description: >-
            Cursor para paginación por cursor (más eficiente en páginas
            profundas)
          schema:
            type: string
        - name: sortBy
          in: query
          description: Campo de ordenación
          schema:
            type: string
            default: createdAt
            enum:
              - liquidityUsd
              - marketCapUsd
              - priceUsd
              - volume
              - volume_5m
              - volume_15m
              - volume_30m
              - volume_1h
              - volume_6h
              - volume_12h
              - volume_24h
              - top10
              - dev
              - insiders
              - snipers
              - holders
              - buys
              - sells
              - totalTransactions
              - fees.total
              - fees.totalTrading
              - fees.totalTips
              - createdAt
              - lpBurn
              - curvePercentage
              - communityMessages
        - name: sortOrder
          in: query
          description: Dirección de ordenación
          schema:
            type: string
            default: desc
            enum:
              - asc
              - desc
        - name: hasImage
          in: query
          description: 'Filtrar por imagen: true = solo con imagen; false = solo sin imagen.'
          schema:
            type: boolean
        - name: hasSocials
          in: query
          description: 'Filtrar por redes sociales: true = con enlaces; false = sin enlaces.'
          schema:
            type: boolean
        - name: image
          in: query
          description: >-
            Filtra por URL de imagen o hash IPFS exactos. Acepta URL completas o
            CID. Si la URL contiene /ipfs/, solo se usa el hash/CID para
            coincidir (p. ej. QmXyZ… coincide con cualquier gateway con ese
            CID).
          schema:
            type: string
            maxLength: 500
        - name: launchpad
          in: query
          description: >-
            Filtra por plataforma launchpad; varios valores separados por comas
            (p. ej. pumpfun,boop). Un solo valor se comporta como antes.
          schema:
            type: string
            maxLength: 100
        - name: showAllPools
          in: query
          description: Si está activado, devuelve todas las pools de liquidez del token.
          schema:
            type: boolean
            default: false
        - name: showPriceChanges
          in: query
          description: Incluye en la respuesta datos de variación de precio.
          schema:
            type: boolean
            default: false
        - name: minCreatedAt
          in: query
          description: Fecha de creación mínima (Unix en milisegundos)
          schema:
            type: integer
        - name: maxCreatedAt
          in: query
          description: Fecha de creación máxima (Unix en milisegundos)
          schema:
            type: integer
        - name: minGraduatedAt
          in: query
          description: Fecha de graduación mínima (Unix en milisegundos)
          schema:
            type: integer
        - name: maxGraduatedAt
          in: query
          description: Fecha de graduación máxima (Unix en milisegundos)
          schema:
            type: integer
        - name: minLiquidity
          in: query
          description: Liquidez mínima (USD)
          schema:
            type: number
        - name: maxLiquidity
          in: query
          description: Liquidez máxima (USD, tope 100.000M)
          schema:
            type: number
        - name: minMarketCap
          in: query
          description: Capitalización mínima (USD)
          schema:
            type: number
        - name: maxMarketCap
          in: query
          description: Capitalización máxima (USD, tope 5 billones USD)
          schema:
            type: number
        - name: minVolume
          in: query
          description: Volumen mínimo (USD, marco temporal por defecto)
          schema:
            type: number
        - name: maxVolume
          in: query
          description: Volumen máximo (USD, marco temporal por defecto)
          schema:
            type: number
        - name: volumeTimeframe
          in: query
          description: Marco temporal para filtrar por volumen
          schema:
            type: string
            enum:
              - 5m
              - 15m
              - 30m
              - 1h
              - 6h
              - 12h
              - 24h
        - name: minVolume_5m
          in: query
          schema:
            type: number
        - name: maxVolume_5m
          in: query
          schema:
            type: number
        - name: minVolume_15m
          in: query
          schema:
            type: number
        - name: maxVolume_15m
          in: query
          schema:
            type: number
        - name: minVolume_30m
          in: query
          schema:
            type: number
        - name: maxVolume_30m
          in: query
          schema:
            type: number
        - name: minVolume_1h
          in: query
          schema:
            type: number
        - name: maxVolume_1h
          in: query
          schema:
            type: number
        - name: minVolume_6h
          in: query
          schema:
            type: number
        - name: maxVolume_6h
          in: query
          schema:
            type: number
        - name: minVolume_12h
          in: query
          schema:
            type: number
        - name: maxVolume_12h
          in: query
          schema:
            type: number
        - name: minVolume_24h
          in: query
          schema:
            type: number
        - name: maxVolume_24h
          in: query
          schema:
            type: number
        - name: minBuys
          in: query
          description: Número mínimo de compras
          schema:
            type: integer
        - name: maxBuys
          in: query
          description: Número máximo de compras
          schema:
            type: integer
        - name: minSells
          in: query
          description: Número mínimo de ventas
          schema:
            type: integer
        - name: maxSells
          in: query
          description: Número máximo de ventas
          schema:
            type: integer
        - name: minTotalTransactions
          in: query
          description: Número mínimo total de operaciones
          schema:
            type: integer
        - name: maxTotalTransactions
          in: query
          description: Número máximo total de operaciones
          schema:
            type: integer
        - name: minHolders
          in: query
          description: Número mínimo de tenedores
          schema:
            type: integer
        - name: maxHolders
          in: query
          description: Número máximo de tenedores
          schema:
            type: integer
        - name: minTop10
          in: query
          description: '% mínimo en manos del top 10 (0–100)'
          schema:
            type: number
            minimum: 0
            maximum: 100
        - name: maxTop10
          in: query
          description: '% máximo en manos del top 10 (0–100)'
          schema:
            type: number
            minimum: 0
            maximum: 100
        - name: minDev
          in: query
          description: '% mínimo en manos del desarrollador (0–100)'
          schema:
            type: number
            minimum: 0
            maximum: 100
        - name: maxDev
          in: query
          description: '% máximo en manos del desarrollador (0–100)'
          schema:
            type: number
            minimum: 0
            maximum: 100
        - name: minInsiders
          in: query
          description: '% mínimo en manos de insiders (0–100)'
          schema:
            type: number
            minimum: 0
            maximum: 100
        - name: maxInsiders
          in: query
          description: '% máximo en manos de insiders (0–100)'
          schema:
            type: number
            minimum: 0
            maximum: 100
        - name: minSnipers
          in: query
          description: '% mínimo en manos de snipers (0–100)'
          schema:
            type: number
            minimum: 0
            maximum: 100
        - name: maxSnipers
          in: query
          description: '% máximo en manos de snipers (0–100)'
          schema:
            type: number
            minimum: 0
            maximum: 100
        - name: minBundlers
          in: query
          description: Número mínimo de carteras bundler
          schema:
            type: integer
            minimum: 0
        - name: maxBundlers
          in: query
          description: Número máximo de carteras bundler
          schema:
            type: integer
            minimum: 0
        - name: minBundlerPercentage
          in: query
          description: '% mínimo en manos de bundlers (0–100)'
          schema:
            type: number
            minimum: 0
            maximum: 100
        - name: maxBundlerPercentage
          in: query
          description: '% máximo en manos de bundlers (0–100)'
          schema:
            type: number
            minimum: 0
            maximum: 100
        - name: minRiskScore
          in: query
          description: Puntuación de riesgo mínima
          schema:
            type: number
            minimum: 0
        - name: maxRiskScore
          in: query
          description: Puntuación de riesgo máxima
          schema:
            type: number
            minimum: 0
        - name: lpBurn
          in: query
          description: Porcentaje de quema del token LP (0–100)
          schema:
            type: integer
            minimum: 0
            maximum: 100
        - name: market
          in: query
          description: >-
            Identificador de mercado; varios valores separados por comas (p. ej.
            raydium,orca,pumpfun). Un solo valor se comporta como antes.
          schema:
            type: string
        - name: freezeAuthority
          in: query
          description: Dirección de autoridad de congelación (null si no existe)
          schema:
            type: string
        - name: mintAuthority
          in: query
          description: Dirección de autoridad de acuñación (null si no existe)
          schema:
            type: string
        - name: deployer
          in: query
          description: Dirección de la cartera desplegadora
          schema:
            type: string
        - name: creator
          in: query
          description: Dirección de la cartera creadora del token
          schema:
            type: string
        - name: status
          in: query
          description: Estado del token
          schema:
            type: string
            enum:
              - graduating
              - graduated
              - default
        - name: minCurvePercentage
          in: query
          description: Progreso mínimo de la curva de vinculación % (0–100)
          schema:
            type: number
            minimum: 0
            maximum: 100
        - name: maxCurvePercentage
          in: query
          description: Progreso máximo de la curva de vinculación % (0–100)
          schema:
            type: number
            minimum: 0
            maximum: 100
        - name: twitter
          in: query
          description: URL del perfil de Twitter/X (coincidencia exacta)
          schema:
            type: string
        - name: telegram
          in: query
          description: URL del canal o grupo de Telegram (coincidencia exacta)
          schema:
            type: string
        - name: discord
          in: query
          description: URL de invitación al servidor de Discord (coincidencia exacta)
          schema:
            type: string
        - name: website
          in: query
          description: URL del sitio web oficial (coincidencia exacta)
          schema:
            type: string
        - name: facebook
          in: query
          description: URL de la página de Facebook (coincidencia exacta)
          schema:
            type: string
        - name: instagram
          in: query
          description: URL del perfil de Instagram (coincidencia exacta)
          schema:
            type: string
        - name: youtube
          in: query
          description: URL del canal de YouTube (coincidencia exacta)
          schema:
            type: string
        - name: reddit
          in: query
          description: URL de la comunidad en Reddit (coincidencia exacta)
          schema:
            type: string
        - name: tiktok
          in: query
          description: URL del perfil de TikTok (coincidencia exacta)
          schema:
            type: string
        - name: github
          in: query
          description: URL del repositorio de GitHub (coincidencia exacta)
          schema:
            type: string
        - name: minFeesTotal
          in: query
          description: Comisiones totales pagadas mínimas (SOL)
          schema:
            type: number
        - name: maxFeesTotal
          in: query
          description: Comisiones totales pagadas máximas (SOL)
          schema:
            type: number
        - name: minFeesTrading
          in: query
          description: Comisiones de trading pagadas mínimas (SOL)
          schema:
            type: number
        - name: maxFeesTrading
          in: query
          description: Comisiones de trading pagadas máximas (SOL)
          schema:
            type: number
        - name: minFeesTips
          in: query
          description: Propinas / priority fees pagadas mínimas (SOL)
          schema:
            type: number
        - name: maxFeesTips
          in: query
          description: Propinas / priority fees pagadas máximas (SOL)
          schema:
            type: number
        - name: hasCoinCommunity
          in: query
          description: >-
            Filtra por actividad en Coin Communities. true = al menos un mensaje
            monitorizado; false = cero mensajes monitorizados.
          schema:
            type: boolean
        - name: minCommunityMessages
          in: query
          description: Recuento mínimo de mensajes en vivo de Coin Communities (inclusive)
          schema:
            type: integer
        - name: maxCommunityMessages
          in: query
          description: Recuento máximo de mensajes en vivo de Coin Communities (inclusive)
          schema:
            type: integer
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SearchResponse'
              example:
                status: success
                data:
                  - id: >-
                      1mHoWfm6z2rPwoYvDJnbXLBqn1Kz5uFphsuXFbNEpump_1mHoWfm6z2rPwoYvDJnbXLBqn1Kz5uFphsuXFbNEpump
                    name: Search Example
                    symbol: SEARCH
                    mint: 1mHoWfm6z2rPwoYvDJnbXLBqn1Kz5uFphsuXFbNEpump
                    image: >-
                      https://image.solanatracker.io/proxy?url=https%3A%2F%2Fipfs.io%2Fipfs%2Fbafkreieea4t7xuw6x52tzw3j4sl5khztxlvq6fkmmik2v4hue6gf3h6z4u
                    decimals: 6
                    hasSocials: true
                    hasCoinCommunity: true
                    communityMessages: 12
                    poolAddress: 9mHoWfm6z2rPwoYvDJnbXLBqn1Kz5uFphsuXFbNEpump
                    liquidityUsd: 11448.851629727089
                    marketCapUsd: 5598.428247103462
                    priceUsd: 0.000005598428247103462
                    lpBurn: 100
                    market: pumpfun
                    quoteToken: So11111111111111111111111111111111111111112
                    freezeAuthority: null
                    mintAuthority: null
                    deployer: 46AxLXbx5bG3jGcT881u61v7aRoAftmtA4JBtfVyiEmv
                    status: default
                    createdAt: 1760273456641
                    lastUpdated: 1760273468644
                    holders: 2
                    launchpad:
                      name: ''
                      url: ''
                      logo: ''
                      curvePercentage: 6.366677291506747
                      fee: 0.25
                    buys: 2
                    sells: 1
                    totalTransactions: 3
                    volume: 304.8940710222087
                    volume_5m: 286
                    volume_15m: 286
                    volume_30m: 286
                    volume_1h: 286
                    volume_6h: 286
                    volume_12h: 286
                    volume_24h: 286
                    top10: 5.0494
                    dev: 5.0494
                    insiders: 0
                    snipers: 0.3166
                    bundlers:
                      count: 0
                      balance: 0
                      percentage: 0
                    riskScore: 10
                    socials:
                      twitter: https://x.com/i/communities/1977354097570304425
                    fees:
                      total: 0.002086
                      totalTrading: 0.001966
                      totalTips: 0.00012
                    tokenDetails:
                      creator: 46AxLXbx5bG3jGcT881u61v7aRoAftmtA4JBtfVyiEmv
                      tx: >-
                        58DshkoV4EeiAi5d9szUuZu1Rj8HzbK9TbPLV4RjC1defyETUJb3wVXLY2h1SnZFgQdjXJC2o59Ty44BSDNerpHm
                      time: 1760273457
                total: 13144556
                pages: 13144556
                page: 1
                nextCursor: >-
                  WzE3NjAyNzM0NTY2NDEsIjltSG9XZm02ejJyUHdvWXZESm5iWExCcW4xS3o1dUZwaHN1WEZiTkVwdW1wIl0=
                hasMore: true
      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.searchTokens({ query: 'BONK', limit: 10
            });
      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.searchTokens({ query: 'BONK', limit: 10
            });
components:
  schemas:
    SearchResponse:
      type: object
      properties:
        status:
          type: string
        data:
          type: array
          items:
            $ref: '#/components/schemas/SearchToken'
        total:
          type: integer
        pages:
          type: integer
        page:
          type: integer
        cursor:
          type: string
          description: Cursor used for the current page (cursor-based pagination)
        nextCursor:
          type: string
        hasMore:
          type: boolean
    SearchToken:
      type: object
      properties:
        id:
          type: string
        name:
          type: string
        symbol:
          type: string
        mint:
          type: string
        decimals:
          type: integer
        image:
          type: string
        hasSocials:
          type: boolean
        hasCoinCommunity:
          type: boolean
          description: True when communityMessages > 0
        communityMessages:
          type: integer
          description: Live Coin Communities message count
        holders:
          type: integer
          description: Holder counts and holder concentration information when included.
        launchpad:
          type: object
          properties:
            name:
              type: string
            url:
              type: string
            logo:
              type: string
            curvePercentage:
              type: number
            fee:
              type: number
        jupiter:
          type: boolean
        verified:
          type: boolean
        liquidityUsd:
          type: number
        marketCapUsd:
          type: number
        priceUsd:
          type: number
        lpBurn:
          type: integer
        market:
          type: string
        quoteToken:
          type: string
        freezeAuthority:
          type: string
          nullable: true
        mintAuthority:
          type: string
          nullable: true
        poolAddress:
          type: string
        deployer:
          type: string
          nullable: true
        status:
          type: string
        createdAt:
          type: integer
        graduatedAt:
          type: integer
          nullable: true
        lastUpdated:
          type: integer
        events:
          $ref: '#/components/schemas/Events'
          description: >-
            Recent token events such as pool changes, burns, and liquidity
            updates.
        buys:
          type: integer
          description: >-
            Recent buy counts or buy activity, depending on the endpoint
            response.
        sells:
          type: integer
          description: >-
            Recent sell counts or sell activity, depending on the endpoint
            response.
        totalTransactions:
          type: integer
        volume:
          type: number
        volume_5m:
          type: number
        volume_15m:
          type: number
        volume_30m:
          type: number
        volume_1h:
          type: number
        volume_6h:
          type: number
        volume_12h:
          type: number
        volume_24h:
          type: number
        top10:
          type: number
        dev:
          type: number
        insiders:
          type: number
        snipers:
          type: number
        bundlers:
          type: object
          properties:
            count:
              type: integer
            balance:
              type: number
            percentage:
              type: number
        riskScore:
          type: integer
        socials:
          type: object
          properties:
            twitter:
              type: string
            website:
              type: string
            telegram:
              type: string
            discord:
              type: string
        fees:
          type: object
          properties:
            total:
              type: number
            totalTrading:
              type: number
            totalTips:
              type: number
        tokenDetails:
          type: object
          properties:
            creator:
              type: string
            tx:
              type: string
            time:
              type: integer
    Events:
      type: object
      additionalProperties:
        type: object
        properties:
          priceChangePercentage:
            type: number
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: x-api-key
      description: Clave API para autenticación

````

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