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

# Smart Money - Token List

> Returns tokens identified via smart money traders, segmented by trader style and risk appetite.

<Tabs>
  <Tab title="Usage Note">
    <p><strong>Token list ranked through smart-money wallet behavior.</strong></p>

    <ul>
      <li><code>interval</code> controls the observation window.</li>
      <li><code>trader\_style</code> narrows the wallet cohort driving the ranking.</li>
      <li><code>sort\_by</code> controls which smart-money dimension leads the ranking.</li>
      <li>Results are paginated with <code>offset</code> up to <code>10,000</code> and <code>limit</code> up to <code>20</code>.</li>
    </ul>
  </Tab>

  <Tab title="Accessibility">
    <ul>
      <li>Lite</li>
      <li>Starter</li>
      <li>Premium</li>
      <li>Business</li>
      <li>Enterprise</li>
    </ul>
  </Tab>

  <Tab title="Chain Supported">
    <p><strong>SVM ⛓️ ✨</strong></p>
    <p><strong>EVM ⛓️ ✨</strong></p>
  </Tab>
</Tabs>

<Accordion title="Compute Unit ⚙️" icon="fa-gauge-high">
  <ul>
    <li>This endpoint consumes <code>20 CU</code> per request.</li>
  </ul>
</Accordion>

<Accordion title="Use Cases 💡" icon="fa-lightbulb">
  <ul>
    <li>Discover tokens being accumulated or actively traded by stronger wallets.</li>
    <li>Build smart-money boards, alpha feeds, and conviction watchlists.</li>
    <li>Compare trader styles and risk appetite across token sets.</li>
  </ul>
</Accordion>

<Accordion title="How to Use 🛠️" icon="fa-book-open">
  <ul>
    <li>Set <code>x-chain</code> to a supported PnL-compatible network.</li>
    <li>Choose <code>interval</code>, <code>trader\_style</code>, and <code>sort\_by</code> for the signal you want.</li>
    <li>Page through the ranked token list with <code>offset</code> and <code>limit</code>.</li>
  </ul>
</Accordion>

<Accordion title="Best Practices ✅" icon="fa-check-circle">
  <ul>
    <li>Use this as a discovery layer first, then validate shortlisted tokens with price, market, holder, and security data.</li>
    <li>Keep interval and sort choice explicit in UI so users understand why a token ranks highly.</li>
  </ul>
</Accordion>

<br />


## OpenAPI

````yaml openapi/data/openapi_docs.json GET /smart-money/v1/token/list
openapi: 3.1.0
info:
  version: 1.1.0
  title: Birdeye Data API
  description: >-
    Birdeye Data API is a full-spectrum blockchain and DEX data platform for
    teams that need production-grade crypto market intelligence across tokens,
    pairs, wallets, traders, protocols, and chains.


    From real-time prices, OHLCV, liquidity, and transaction flow to holder
    analytics, token and pair overviews, wallet portfolio and PnL, smart money,
    discovery, security, and blockchain-level utilities, Birdeye gives you a
    unified data layer for building serious crypto products at scale.


    Use it to power exchange interfaces, trading terminals, bots, market-making
    systems, quant research, alpha screeners, portfolio apps, wallet
    intelligence tools, alerting systems, analytics dashboards, and back-office
    data pipelines. Whether your users are retail traders, pro desks, analysts,
    or infrastructure teams, Birdeye helps you ship faster with broad market
    coverage and API surfaces that support both lightweight integrations and
    data-heavy workflows.


    To start, create an account at [bds.birdeye.so](https://bds.birdeye.so),
    generate an API key from the `Security` tab, and send it in the `X-API-KEY`
    header on every request.
servers:
  - url: https://public-api.birdeye.so
security:
  - apiKeyAuth: []
tags:
  - name: Price & OHLCV
  - name: Stats
  - name: Token/Market List
  - name: Transactions
  - name: Wallet, Networth & PnL
  - name: Balance & Transfer
  - name: Holder
  - name: Alltime & History
  - name: Blockchain
  - name: Account
  - name: Token
  - name: Transaction
  - name: Creation & Trending
  - name: Meme
  - name: Security
  - name: Search & Utils
  - name: Smart Money
  - name: Global Fees Paid
  - name: DEX & Protocol
  - name: Wallet Identity
paths:
  /smart-money/v1/token/list:
    get:
      tags:
        - Smart Money
      summary: Smart Money - Token List
      description: >-
        Returns tokens identified via smart money traders, segmented by trader
        style and risk appetite.
      operationId: get-smart-money-v1-token-list
      parameters:
        - $ref: '#/components/parameters/xPNLChainParam'
        - $ref: '#/components/parameters/smartMoneyTokenIntervalParam'
        - $ref: '#/components/parameters/smartMoneyTokenTraderStyleParam'
        - $ref: '#/components/parameters/smartMoneyTokenSortByParam'
        - $ref: '#/components/parameters/sortTypeDescParam'
        - $ref: '#/components/parameters/offset10kParam'
        - $ref: '#/components/parameters/limit20Default20Param'
      responses:
        '200':
          $ref: '#/components/responses/SmartMoneyTokenResponse'
        '400':
          $ref: '#/components/responses/400'
        '401':
          $ref: '#/components/responses/401'
        '403':
          $ref: '#/components/responses/403'
        '429':
          $ref: '#/components/responses/429'
        '500':
          $ref: '#/components/responses/500'
components:
  parameters:
    xPNLChainParam:
      name: x-chain
      description: The chain support PNL data.
      in: header
      required: false
      schema:
        type: string
        enum:
          - solana
          - ethereum
          - arbitrum
          - avalanche
          - bsc
          - optimism
          - polygon
          - base
          - zksync
          - monad
          - hyperevm
          - mantle
          - megaeth
          - robinhood
        default: solana
    smartMoneyTokenIntervalParam:
      name: interval
      in: query
      schema:
        type: string
        enum:
          - 1d
          - 7d
          - 30d
        default: 1d
    smartMoneyTokenTraderStyleParam:
      name: trader_style
      in: query
      schema:
        type: string
        enum:
          - all
          - risk_averse
          - risk_balancers
          - trenchers
        default: all
    smartMoneyTokenSortByParam:
      name: sort_by
      in: query
      schema:
        type: string
        enum:
          - net_flow
          - smart_traders_no
          - market_cap
        default: smart_traders_no
    sortTypeDescParam:
      name: sort_type
      description: Specify the sort order.
      in: query
      schema:
        type: string
        enum:
          - desc
          - asc
        default: desc
    offset10kParam:
      name: offset
      description: Pagination start position. offset + limit <= 10000
      in: query
      required: false
      schema:
        type: integer
        default: 0
        minimum: 0
        maximum: 10000
    limit20Default20Param:
      name: limit
      in: query
      required: false
      schema:
        type: integer
        default: 20
        minimum: 1
        maximum: 20
  responses:
    '400':
      description: Bad Request
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          example:
            success: false
            message: Bad request
    '401':
      description: Unauthorized. API key is missing or invalid
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          example:
            success: false
            message: Unauthorized
    '403':
      description: Forbidden. Request is blacklisted or not whitelisted
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          example:
            success: false
            message: Access Denied
    '429':
      description: Too Many Requests. Rate limit reached
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          example:
            success: false
            message: Too many requests
    '500':
      description: Internal Server Error
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          example:
            success: false
            message: Internal Server Error
    SmartMoneyTokenResponse:
      description: JSON object containing a total transfer
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/SmartMoneyTokenListResponse'
          examples:
            Solana:
              value:
                success: true
                data:
                  - token: C6HB4R62NeXacwT4CAfohnCTJiaLhYfuQZNsbsqypump
                    price: 0.00001883295471804635
                    liquidity: 14375.686217934
                    market_cap: 18588.443206268883
                    net_flow: 52810.052897156216
                    smart_traders_no: 308
                    trader_style: trenchers
                    volume_usd: 13862029.460908774
                    volume_buy_usd: 6957419.756902965
                    volume_sell_usd: 6904609.704005809
                    symbol: Nazijak
                    name: Nazi Wojak
                    logo_uri: >-
                      https://wsrv.nl/?w=128&h=128&default=1&url=https://ipfs.io/ipfs/bafkreiecr4nqikoow756ahfgjj7fhqga5nepbqyi3hqisw7ehk2p6uzm4y
                    price_change_percent: 43.032329448293844
  schemas:
    SmartMoneyTokenListResponse:
      type: object
      required:
        - success
        - data
      properties:
        success:
          type: boolean
          description: Whether the request succeeded.
        data:
          type: array
          description: >-
            Ranked smart-money token list for the requested chain and filter
            set.
          items:
            $ref: '#/components/schemas/SmartMoneyTokenItem'
    ErrorResponse:
      type: object
      properties:
        success:
          type: boolean
        message:
          type: string
    SmartMoneyTokenItem:
      type: object
      additionalProperties: true
      properties:
        token:
          type: string
          description: Token mint or contract address.
        price:
          type: number
          description: Latest token price in USD.
        liquidity:
          type: number
          description: Current token liquidity in USD.
        market_cap:
          type: number
          description: Current token market capitalization in USD.
        net_flow:
          type: number
          description: Net smart-money flow for the selected time window and cohort.
        smart_traders_no:
          type: integer
          description: Number of smart-trader wallets contributing to the signal.
        trader_style:
          type: string
          description: Smart-money cohort or trader-style label used for the ranking.
        volume_usd:
          type: number
          description: Total USD trading volume associated with the smart-money activity.
        volume_buy_usd:
          type: number
          description: Buy-side USD volume attributed to smart-money wallets.
        volume_sell_usd:
          type: number
          description: Sell-side USD volume attributed to smart-money wallets.
        symbol:
          type: string
          description: Token symbol.
        name:
          type: string
          description: Token display name.
        logo_uri:
          type: string
          description: Token logo URL.
        price_change_percent:
          type: number
          description: Price change percentage over the requested ranking window.
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: X-API-KEY
      description: API key for authentication

````