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

> 按符号、名称或地址搜索代币，并提供多种筛选与排序选项。

## SDK Example

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

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

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

  ```
</CodeGroup>


## OpenAPI

````yaml /cn/data-api/openapi.json get /search
openapi: 3.1.0
info:
  title: Solana Tracker 数据 API
  description: Solana Tracker 数据 API：提供代币价格、持币地址、成交、图表、钱包数据、风险信号与市场分析等能力。
  version: 1.0.0
  contact:
    email: contact@solanatracker.io
servers:
  - url: https://data.solanatracker.io
    description: 生产环境
security:
  - apiKey: []
paths:
  /search:
    get:
      tags:
        - Search
      summary: Token Search
      description: 按符号、名称或地址搜索代币，并提供多种筛选与排序选项。
      parameters:
        - name: query
          in: query
          description: 搜索词：代币符号、名称或地址
          schema:
            type: string
        - name: symbol
          in: query
          description: 返回与指定符号完全匹配的全部代币
          schema:
            type: string
        - name: page
          in: query
          description: 基于偏移分页时的页码
          schema:
            type: integer
            default: 1
        - name: limit
          in: query
          description: 每页条数上限：默认最多 500；当 format=full 时最多 100。
          schema:
            type: integer
            default: 100
            maximum: 500
        - name: format
          in: query
          description: >-
            响应格式。设为 full 时返回完整代币对象（结构与 GET /tokens/:token 一致，包含
            token、pools、events、risk、buy、sell、txns、holders 等）。format=full 时每页上限为
            100。
          schema:
            type: string
            enum:
              - full
        - name: cursor
          in: query
          description: 基于游标的分页 cursor（深度翻页时更快）
          schema:
            type: string
        - name: sortBy
          in: query
          description: 排序字段
          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: 排序方向
          schema:
            type: string
            default: desc
            enum:
              - asc
              - desc
        - name: hasImage
          in: query
          description: 是否仅有图代币：true 表示必须有头像；false 表示必须无头像。
          schema:
            type: boolean
        - name: hasSocials
          in: query
          description: 是否含社交链接：true 表示必须有；false 表示必须无。
          schema:
            type: boolean
        - name: image
          in: query
          description: >-
            按图片 URL 或 IPFS 哈希精确筛选。支持完整 URL 或 IPFS CID。若 URL 含
            /ipfs/，仅使用其中的哈希/CID 匹配（例如 QmXyZ… 可匹配任意网关下该 CID）。
          schema:
            type: string
            maxLength: 500
        - name: launchpad
          in: query
          description: 按发射台（launchpad）平台名筛选；多个值用英文逗号分隔（如 pumpfun,boop）。单个值行为与原先一致。
          schema:
            type: string
            maxLength: 100
        - name: showAllPools
          in: query
          description: 启用时返回该代币关联的全部流动性池
          schema:
            type: boolean
            default: false
        - name: showPriceChanges
          in: query
          description: 在响应中包含涨跌幅等价格变动数据
          schema:
            type: boolean
            default: false
        - name: minCreatedAt
          in: query
          description: 最早创建时间（Unix 毫秒时间戳）
          schema:
            type: integer
        - name: maxCreatedAt
          in: query
          description: 最晚创建时间（Unix 毫秒时间戳）
          schema:
            type: integer
        - name: minGraduatedAt
          in: query
          description: 最早毕业时间（Unix 毫秒时间戳）
          schema:
            type: integer
        - name: maxGraduatedAt
          in: query
          description: 最晚毕业时间（Unix 毫秒时间戳）
          schema:
            type: integer
        - name: minLiquidity
          in: query
          description: 最低流动性（美元）
          schema:
            type: number
        - name: maxLiquidity
          in: query
          description: 最高流动性（美元，上限 1000 亿）
          schema:
            type: number
        - name: minMarketCap
          in: query
          description: 最低市值（美元）
          schema:
            type: number
        - name: maxMarketCap
          in: query
          description: 最高市值（美元，上限 5 万亿）
          schema:
            type: number
        - name: minVolume
          in: query
          description: 最低成交额（美元，默认周期内）
          schema:
            type: number
        - name: maxVolume
          in: query
          description: 最高成交额（美元，默认周期内）
          schema:
            type: number
        - name: volumeTimeframe
          in: query
          description: 按成交量筛选时的时间范围
          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: 最低买入笔数
          schema:
            type: integer
        - name: maxBuys
          in: query
          description: 最高买入笔数
          schema:
            type: integer
        - name: minSells
          in: query
          description: 最低卖出笔数
          schema:
            type: integer
        - name: maxSells
          in: query
          description: 最高卖出笔数
          schema:
            type: integer
        - name: minTotalTransactions
          in: query
          description: 最低总成交笔数
          schema:
            type: integer
        - name: maxTotalTransactions
          in: query
          description: 最高总成交笔数
          schema:
            type: integer
        - name: minHolders
          in: query
          description: 最低持币地址数
          schema:
            type: integer
        - name: maxHolders
          in: query
          description: 最高持币地址数
          schema:
            type: integer
        - name: minTop10
          in: query
          description: 前 10 大地址合计持仓占比下限（0–100）
          schema:
            type: number
            minimum: 0
            maximum: 100
        - name: maxTop10
          in: query
          description: 前 10 大地址合计持仓占比上限（0–100）
          schema:
            type: number
            minimum: 0
            maximum: 100
        - name: minDev
          in: query
          description: 开发者持仓占比下限（0–100）
          schema:
            type: number
            minimum: 0
            maximum: 100
        - name: maxDev
          in: query
          description: 开发者持仓占比上限（0–100）
          schema:
            type: number
            minimum: 0
            maximum: 100
        - name: minInsiders
          in: query
          description: 内部人持仓占比下限（0–100）
          schema:
            type: number
            minimum: 0
            maximum: 100
        - name: maxInsiders
          in: query
          description: 内部人持仓占比上限（0–100）
          schema:
            type: number
            minimum: 0
            maximum: 100
        - name: minSnipers
          in: query
          description: 狙击者持仓占比下限（0–100）
          schema:
            type: number
            minimum: 0
            maximum: 100
        - name: maxSnipers
          in: query
          description: 狙击者持仓占比上限（0–100）
          schema:
            type: number
            minimum: 0
            maximum: 100
        - name: minBundlers
          in: query
          description: 捆绑（bundler）地址数量下限
          schema:
            type: integer
            minimum: 0
        - name: maxBundlers
          in: query
          description: 捆绑（bundler）地址数量上限
          schema:
            type: integer
            minimum: 0
        - name: minBundlerPercentage
          in: query
          description: 捆绑者持仓占比下限（0–100）
          schema:
            type: number
            minimum: 0
            maximum: 100
        - name: maxBundlerPercentage
          in: query
          description: 捆绑者持仓占比上限（0–100）
          schema:
            type: number
            minimum: 0
            maximum: 100
        - name: minRiskScore
          in: query
          description: 风险评分下限
          schema:
            type: number
            minimum: 0
        - name: maxRiskScore
          in: query
          description: 风险评分上限
          schema:
            type: number
            minimum: 0
        - name: lpBurn
          in: query
          description: LP 代币销毁比例（0–100）
          schema:
            type: integer
            minimum: 0
            maximum: 100
        - name: market
          in: query
          description: 市场标识；多个市场用英文逗号分隔（如 raydium,orca,pumpfun）。单个值行为与原先一致。
          schema:
            type: string
        - name: freezeAuthority
          in: query
          description: 冻结权限地址（无则传 null）
          schema:
            type: string
        - name: mintAuthority
          in: query
          description: 铸造权限地址（无则传 null）
          schema:
            type: string
        - name: deployer
          in: query
          description: 部署者钱包地址
          schema:
            type: string
        - name: creator
          in: query
          description: 代币创建者钱包地址
          schema:
            type: string
        - name: status
          in: query
          description: 代币状态
          schema:
            type: string
            enum:
              - graduating
              - graduated
              - default
        - name: minCurvePercentage
          in: query
          description: 联合曲线进度下限 %（0–100）
          schema:
            type: number
            minimum: 0
            maximum: 100
        - name: maxCurvePercentage
          in: query
          description: 联合曲线进度上限 %（0–100）
          schema:
            type: number
            minimum: 0
            maximum: 100
        - name: twitter
          in: query
          description: Twitter/X 主页 URL（精确匹配）
          schema:
            type: string
        - name: telegram
          in: query
          description: Telegram 频道或群组 URL（精确匹配）
          schema:
            type: string
        - name: discord
          in: query
          description: Discord 邀请链接（精确匹配）
          schema:
            type: string
        - name: website
          in: query
          description: 官网 URL（精确匹配）
          schema:
            type: string
        - name: facebook
          in: query
          description: Facebook 专页 URL（精确匹配）
          schema:
            type: string
        - name: instagram
          in: query
          description: Instagram 主页 URL（精确匹配）
          schema:
            type: string
        - name: youtube
          in: query
          description: YouTube 频道 URL（精确匹配）
          schema:
            type: string
        - name: reddit
          in: query
          description: Reddit 社区 URL（精确匹配）
          schema:
            type: string
        - name: tiktok
          in: query
          description: TikTok 主页 URL（精确匹配）
          schema:
            type: string
        - name: github
          in: query
          description: GitHub 仓库 URL（精确匹配）
          schema:
            type: string
        - name: minFeesTotal
          in: query
          description: 累计支付费用下限（SOL）
          schema:
            type: number
        - name: maxFeesTotal
          in: query
          description: 累计支付费用上限（SOL）
          schema:
            type: number
        - name: minFeesTrading
          in: query
          description: 交易手续费累计下限（SOL）
          schema:
            type: number
        - name: maxFeesTrading
          in: query
          description: 交易手续费累计上限（SOL）
          schema:
            type: number
        - name: minFeesTips
          in: query
          description: 优先费/小费累计下限（SOL）
          schema:
            type: number
        - name: maxFeesTips
          in: query
          description: 优先费/小费累计上限（SOL）
          schema:
            type: number
        - name: hasCoinCommunity
          in: query
          description: 按 Coin Communities 活跃度筛选。true 表示至少有一条已监控的社区消息；false 表示无已监控消息。
          schema:
            type: boolean
        - name: minCommunityMessages
          in: query
          description: Coin Communities 实时消息数下限（含边界）
          schema:
            type: integer
        - name: maxCommunityMessages
          in: query
          description: Coin Communities 实时消息数上限（含边界）
          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: 用于鉴权的 API Key

````