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

> Searches for tokens by symbol, name, or address with various filtering and sorting options



## OpenAPI

````yaml /data-api/openapi.json get /search
openapi: 3.1.0
info:
  title: Solana Tracker Data API
  description: >-
    Solana Tracker Data API for token prices, holders, trades, charts, wallet
    data, risk signals, and market analytics.
  version: 1.0.0
  contact:
    email: contact@solanatracker.io
servers:
  - url: https://data.solanatracker.io
    description: Production server
security:
  - apiKey: []
paths:
  /search:
    get:
      tags:
        - Search
      summary: Token Search
      description: >-
        Searches for tokens by symbol, name, or address with various filtering
        and sorting options
      parameters:
        - name: query
          in: query
          description: Search term for token symbol, name, or address
          schema:
            type: string
        - name: symbol
          in: query
          description: Search for all tokens matching an exact symbol
          schema:
            type: string
        - name: page
          in: query
          description: Page number for offset-based pagination
          schema:
            type: integer
            default: 1
        - name: limit
          in: query
          description: Number of results per page (max 500, or max 100 when format=full)
          schema:
            type: integer
            default: 100
            maximum: 500
        - name: format
          in: query
          description: >-
            Response format. Set to 'full' to return results as full token
            objects (same shape as /tokens/:token — includes token, pools,
            events, risk, buys, sells, txns, holders). When format=full, the max
            per-page limit is capped at 100.
          schema:
            type: string
            enum:
              - full
        - name: cursor
          in: query
          description: Cursor for cursor-based pagination (faster for deep pagination)
          schema:
            type: string
        - name: sortBy
          in: query
          description: Field to sort by
          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
        - name: sortOrder
          in: query
          description: Sort order
          schema:
            type: string
            default: desc
            enum:
              - asc
              - desc
        - name: hasImage
          in: query
          description: >-
            Filter tokens by image presence. Set to true for tokens with images,
            false for tokens without images
          schema:
            type: boolean
        - name: hasSocials
          in: query
          description: >-
            Filter tokens by social presence. Set to true for tokens with
            socials, false for tokens without socials
          schema:
            type: boolean
        - name: image
          in: query
          description: >-
            Filter by exact image URL or IPFS hash. Supports full URLs or IPFS
            content identifiers (CID). For IPFS URLs containing '/ipfs/', only
            the hash/CID is used for matching (e.g., 'QmXyZ...' will match any
            gateway URL with that hash)
          schema:
            type: string
            maxLength: 500
        - name: launchpad
          in: query
          description: >-
            Filter by launchpad platform name. Supports comma-separated values
            for multiple launchpads (e.g., 'pumpfun,boop'). Single values still
            work as before.
          schema:
            type: string
            maxLength: 100
        - name: showAllPools
          in: query
          description: Return all pools for a token if enabled
          schema:
            type: boolean
            default: false
        - name: showPriceChanges
          in: query
          description: Include price change data in response
          schema:
            type: boolean
            default: false
        - name: minCreatedAt
          in: query
          description: Minimum creation date in unix time (ms)
          schema:
            type: integer
        - name: maxCreatedAt
          in: query
          description: Maximum creation date in unix time (ms)
          schema:
            type: integer
        - name: minGraduatedAt
          in: query
          description: Minimum graduation date in unix time (ms)
          schema:
            type: integer
        - name: maxGraduatedAt
          in: query
          description: Maximum graduation date in unix time (ms)
          schema:
            type: integer
        - name: minLiquidity
          in: query
          description: Minimum liquidity in USD
          schema:
            type: number
        - name: maxLiquidity
          in: query
          description: Maximum liquidity in USD (capped at $100B)
          schema:
            type: number
        - name: minMarketCap
          in: query
          description: Minimum market cap in USD
          schema:
            type: number
        - name: maxMarketCap
          in: query
          description: Maximum market cap in USD (capped at $5T)
          schema:
            type: number
        - name: minVolume
          in: query
          description: Minimum volume in USD (for default timeframe)
          schema:
            type: number
        - name: maxVolume
          in: query
          description: Maximum volume in USD (for default timeframe)
          schema:
            type: number
        - name: volumeTimeframe
          in: query
          description: Timeframe for volume filtering
          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: Minimum number of buy transactions
          schema:
            type: integer
        - name: maxBuys
          in: query
          description: Maximum number of buy transactions
          schema:
            type: integer
        - name: minSells
          in: query
          description: Minimum number of sell transactions
          schema:
            type: integer
        - name: maxSells
          in: query
          description: Maximum number of sell transactions
          schema:
            type: integer
        - name: minTotalTransactions
          in: query
          description: Minimum total number of transactions
          schema:
            type: integer
        - name: maxTotalTransactions
          in: query
          description: Maximum total number of transactions
          schema:
            type: integer
        - name: minHolders
          in: query
          description: Minimum number of token holders
          schema:
            type: integer
        - name: maxHolders
          in: query
          description: Maximum number of token holders
          schema:
            type: integer
        - name: minTop10
          in: query
          description: Minimum % held by top 10 holders (0-100)
          schema:
            type: number
            minimum: 0
            maximum: 100
        - name: maxTop10
          in: query
          description: Maximum % held by top 10 holders (0-100)
          schema:
            type: number
            minimum: 0
            maximum: 100
        - name: minDev
          in: query
          description: Minimum % held by developer (0-100)
          schema:
            type: number
            minimum: 0
            maximum: 100
        - name: maxDev
          in: query
          description: Maximum % held by developer (0-100)
          schema:
            type: number
            minimum: 0
            maximum: 100
        - name: minInsiders
          in: query
          description: Minimum % held by insiders (0-100)
          schema:
            type: number
            minimum: 0
            maximum: 100
        - name: maxInsiders
          in: query
          description: Maximum % held by insiders (0-100)
          schema:
            type: number
            minimum: 0
            maximum: 100
        - name: minSnipers
          in: query
          description: Minimum % held by snipers (0-100)
          schema:
            type: number
            minimum: 0
            maximum: 100
        - name: maxSnipers
          in: query
          description: Maximum % held by snipers (0-100)
          schema:
            type: number
            minimum: 0
            maximum: 100
        - name: minBundlers
          in: query
          description: Minimum bundler wallet count
          schema:
            type: integer
            minimum: 0
        - name: maxBundlers
          in: query
          description: Maximum bundler wallet count
          schema:
            type: integer
            minimum: 0
        - name: minBundlerPercentage
          in: query
          description: Minimum % held by bundlers (0-100)
          schema:
            type: number
            minimum: 0
            maximum: 100
        - name: maxBundlerPercentage
          in: query
          description: Maximum % held by bundlers (0-100)
          schema:
            type: number
            minimum: 0
            maximum: 100
        - name: minRiskScore
          in: query
          description: Minimum risk score filter
          schema:
            type: number
            minimum: 0
        - name: maxRiskScore
          in: query
          description: Maximum risk score filter
          schema:
            type: number
            minimum: 0
        - name: lpBurn
          in: query
          description: LP token burn percentage (0-100)
          schema:
            type: integer
            minimum: 0
            maximum: 100
        - name: market
          in: query
          description: >-
            Market identifier. Supports comma-separated values for multiple
            markets (e.g., 'raydium,orca,pumpfun'). Single values still work as
            before.
          schema:
            type: string
        - name: freezeAuthority
          in: query
          description: Freeze authority address (use 'null' for none)
          schema:
            type: string
        - name: mintAuthority
          in: query
          description: Mint authority address (use 'null' for none)
          schema:
            type: string
        - name: deployer
          in: query
          description: Deployer wallet address
          schema:
            type: string
        - name: creator
          in: query
          description: Token creator wallet address
          schema:
            type: string
        - name: status
          in: query
          description: Token status
          schema:
            type: string
            enum:
              - graduating
              - graduated
              - default
        - name: minCurvePercentage
          in: query
          description: Minimum bonding curve % (0-100)
          schema:
            type: number
            minimum: 0
            maximum: 100
        - name: maxCurvePercentage
          in: query
          description: Maximum bonding curve % (0-100)
          schema:
            type: number
            minimum: 0
            maximum: 100
        - name: twitter
          in: query
          description: Twitter/X profile URL (exact match)
          schema:
            type: string
        - name: telegram
          in: query
          description: Telegram channel/group URL (exact match)
          schema:
            type: string
        - name: discord
          in: query
          description: Discord server invite URL (exact match)
          schema:
            type: string
        - name: website
          in: query
          description: Official website URL (exact match)
          schema:
            type: string
        - name: facebook
          in: query
          description: Facebook page URL (exact match)
          schema:
            type: string
        - name: instagram
          in: query
          description: Instagram profile URL (exact match)
          schema:
            type: string
        - name: youtube
          in: query
          description: YouTube channel URL (exact match)
          schema:
            type: string
        - name: reddit
          in: query
          description: Reddit community URL (exact match)
          schema:
            type: string
        - name: tiktok
          in: query
          description: TikTok profile URL (exact match)
          schema:
            type: string
        - name: github
          in: query
          description: GitHub repository URL (exact match)
          schema:
            type: string
        - name: minFeesTotal
          in: query
          description: Minimum total fees paid (in SOL)
          schema:
            type: number
        - name: maxFeesTotal
          in: query
          description: Maximum total fees paid (in SOL)
          schema:
            type: number
        - name: minFeesTrading
          in: query
          description: Minimum trading fees paid (in SOL)
          schema:
            type: number
        - name: maxFeesTrading
          in: query
          description: Maximum trading fees paid (in SOL)
          schema:
            type: number
        - name: minFeesTips
          in: query
          description: Minimum priority fees/tips paid (in SOL)
          schema:
            type: number
        - name: maxFeesTips
          in: query
          description: Maximum priority fees/tips paid (in SOL)
          schema:
            type: number
      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
                    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
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
        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 for authentication

````