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

# Token - Liquidity (Multiple)

> Provides multiple tokens' liquidity value based on USD, native tokens, and other high-liquidity assets to confirm on-chain pools have real liquidity prior to user trades. Maximum 50 addresses.

<Tabs>
  <Tab title="Usage Note">
    <p><strong>Batch exit-liquidity estimate for Base tokens.</strong></p>

    <ul>
      <li>Pass token addresses as a comma-separated list in <code>list\_address</code>.</li>
      <li>Maximum batch size is 50 token addresses per request.</li>
      <li>Returns exit-liquidity data for indexed Base tokens.</li>
      <li>Use this endpoint when screening or monitoring many Base tokens together.</li>
    </ul>
  </Tab>

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

  <Tab title="Chain Supported">
    <p><strong>Base</strong></p>
  </Tab>
</Tabs>

<Accordion title="Compute Unit ⚙️" icon="fa-gauge-high">
  <ul>
    <li>Batch CU is calculated as <code>ceil(15 \* token\_count^0.8)</code>.</li>
  </ul>
</Accordion>

<Accordion title="Use Cases 💡" icon="fa-lightbulb">
  <ul>
    <li>Screen many Base tokens for usable exit liquidity in one request.</li>
    <li>Add liquidity-risk flags to token tables, discovery feeds, and watchlists.</li>
    <li>Compare liquidity quality across a selected token set.</li>
    <li>Feed batch liquidity checks into alerts, risk dashboards, and listing review workflows.</li>
  </ul>
</Accordion>

<Accordion title="How to Use 🛠️" icon="fa-book-open">
  <ul>
    <li>Set <code>x-chain=base</code>.</li>
    <li>Pass <code>list\_address</code> as comma-separated Base token contract addresses.</li>
    <li>Use the single endpoint when a user opens one token detail page.</li>
  </ul>
</Accordion>

<Accordion title="Best Practices ✅" icon="fa-check-circle">
  <ul>
    <li>Use batch exit liquidity for screeners where every token needs a liquidity-quality score.</li>
    <li>Deduplicate token addresses before requesting batch liquidity.</li>
    <li>Combine with market-data multiple to rank tokens by both valuation and practical liquidity.</li>
  </ul>
</Accordion>

<Accordion title="Limitations ⚠️" icon="fa-exclamation-triangle">
  <ul>
    <li>Base only.</li>
  </ul>
</Accordion>

<br />


## OpenAPI

````yaml openapi/data/openapi_docs.json GET /defi/v3/token/exit-liquidity/multiple
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:
  /defi/v3/token/exit-liquidity/multiple:
    get:
      tags:
        - Stats
      summary: Token - Liquidity (Multiple)
      description: >-
        Provides multiple tokens' liquidity value based on USD, native tokens,
        and other high-liquidity assets to confirm on-chain pools have real
        liquidity prior to user trades. Maximum 50 addresses.
      operationId: get-defi-v3-token-exit-liquidity-multiple
      parameters:
        - $ref: '#/components/parameters/xBaseChainParam'
        - $ref: '#/components/parameters/listAddressParam'
      responses:
        '200':
          $ref: '#/components/responses/DefiTokenExitLiquidityMultiple'
          description: OK
        '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:
    xBaseChainParam:
      name: x-chain
      description: Base network only.
      in: header
      required: false
      schema:
        type: string
        enum:
          - base
        default: base
    listAddressParam:
      name: list_address
      description: A list of token addresses in string separated by commas (,)
      in: query
      required: true
      schema:
        type: string
      examples:
        solana:
          value: >-
            So11111111111111111111111111111111111111112,mSoLzYCxHdYgdzU16g5QSh3i5K3z3KZK7ytfqcJm7So,EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
        ethereum:
          value: >-
            0x95ad61b0a150d79219dcf64e1e6cc01f0b64c4ce,0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48
        solana_scaled_ui:
          value: >-
            Xsc9qvGR1efVDFGLrVsmkzv3qi45LTBjeUKSPmx9qEh,Xs3eBt7uRfJX8QUs4suhyU8p2M6DoUDrJyWBa8LLZsg,XsbEhLAtcf6HdfpFZ5xEMdqW8nfAvcsP5bdudRLJzJp
  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
    DefiTokenExitLiquidityMultiple:
      description: JSON object containing exit liquidity data of multiple tokens
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/DefiTokenExitLiquidityMultipleResponse'
          examples:
            TokenMarketDataMultiple:
              value:
                data:
                  items:
                    - token: '0x60a3E35Cc302bFA44Cb288Bc5a4F316Fdb1adb42'
                      exit_liquidity: 6719817.16468568
                      liquidity: 10277766.97799163
                      price:
                        value: 1.1516170107394188
                        update_unix_time: 1750385591
                        update_human_time: '2025-06-20T02:13:11'
                        update_in_slot: 31798122
                      currency: USD
                      address: '0x60a3E35Cc302bFA44Cb288Bc5a4F316Fdb1adb42'
                      name: EURC
                      symbol: EURC
                      decimals: 6
                      extensions:
                        twitter: https://twitter.com/circlepay
                        website: https://www.circle.com
                        telegram: null
                      logo_uri: >-
                        https://coin-images.coingecko.com/coins/images/26045/small/euro.png?1696525125
                    - token: '0xD7eA1d4d2528fc6Ff010006694C3489f386e2532'
                      exit_liquidity: 162397.14079820755
                      liquidity: 324794.2815964151
                      price:
                        value: 0.0016673684083016622
                        update_unix_time: 1750385591
                        update_human_time: '2025-06-20T02:13:11'
                        update_in_slot: 31798122
                      currency: USD
                      address: '0xD7eA1d4d2528fc6Ff010006694C3489f386e2532'
                      name: JPmorgan Dollar
                      symbol: JPMD
                      decimals: 18
                      extensions:
                        twitter: null
                        website: null
                        telegram: null
                      logo_uri: >-
                        https://dd.dexscreener.com/ds-data/tokens/base/0xd7ea1d4d2528fc6ff010006694c3489f386e2532.png?size=xl
                success: true
  schemas:
    DefiTokenExitLiquidityMultipleResponse:
      type: object
      required:
        - success
        - data
      properties:
        success:
          type: boolean
          description: Whether the request completed successfully.
        data:
          type: object
          description: Batch exit-liquidity payload.
          required:
            - items
          properties:
            items:
              description: A list of objects containing token exit liquidity data
              type: array
              items:
                $ref: '#/components/schemas/DefiTokenExitLiquidityObject'
    ErrorResponse:
      type: object
      properties:
        success:
          type: boolean
        message:
          type: string
    DefiTokenExitLiquidityObject:
      type: object
      required:
        - token
        - exit_liquidity
        - liquidity
        - price
        - currency
        - address
        - name
        - symbol
        - decimals
        - extensions
        - logo_uri
      properties:
        token:
          type: string
          description: >-
            Token mint or contract address used for the exit-liquidity
            calculation.
        exit_liquidity:
          type: number
          description: >-
            Estimated USD liquidity available for exiting the configured
            position size under the endpoint's exit-liquidity model.
        liquidity:
          type: number
          description: Current token liquidity in USD.
        price:
          type: object
          description: Latest price snapshot used for the exit-liquidity calculation.
          required:
            - value
            - update_unix_time
            - update_human_time
            - update_in_slot
          properties:
            value:
              type: number
              description: Latest token price in the requested quote currency.
            update_unix_time:
              type: integer
              description: >-
                Unix timestamp in seconds when the price snapshot was last
                updated.
            update_human_time:
              type: string
              description: >-
                Human-readable timestamp when the price snapshot was last
                updated.
            update_in_slot:
              type: integer
              description: >-
                Blockchain slot or block-equivalent associated with the price
                update when available.
        currency:
          type: string
          description: Quote currency used for price and exit-liquidity values.
        address:
          type: string
          description: Canonical token mint or contract address for this token.
        name:
          type: string
          description: Display name of the token.
        symbol:
          type: string
          description: Ticker symbol for the token.
        decimals:
          type: string
          description: Number of decimal places used by the token.
        extensions:
          type: object
          description: Optional token metadata links and external identifiers.
        logo_uri:
          type: string
          description: Logo image URL for the token.
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: X-API-KEY
      description: API key for authentication

````