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

# Liquidity Latest - Token

> Retrieve the latest total, exit, and stable liquidity with the latest price for Solana token addresses. Lite packages can request one address. Starter and higher packages can request up to 100 addresses.

<Tabs>
  <Tab title="Usage Note">
    <p><strong>Latest liquidity snapshot for one or many Solana tokens.</strong></p>

    <ul>
      <li>Send token mints in the POST body under <code>addresses</code>.</li>
      <li>The request accepts <code>1</code> to <code>100</code> addresses after deduplication.</li>
      <li>Lite plans can request only one address; multi-address requests require Starter or higher.</li>
      <li>This endpoint returns the latest total, exit, and stable liquidity together with the latest price context.</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>Solana</strong></p>
  </Tab>
</Tabs>

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

<Accordion title="Use Cases 💡" icon="fa-lightbulb">
  <ul>
    <li>Fetch the newest liquidity snapshot for one or many tokens before ranking or screening them.</li>
    <li>Power token tables that need current liquidity alongside current price.</li>
    <li>Detect sudden drops in exit liquidity or stable liquidity before they show up in slower dashboards.</li>
    <li>Pre-check market depth quality before routing further analysis or trading actions.</li>
  </ul>
</Accordion>

<Accordion title="How to Use 🛠️" icon="fa-book-open">
  <ul>
    <li>Set <code>x-chain=solana</code>.</li>
    <li>Send <code>addresses</code> in the POST body.</li>
    <li>Keep the body at <code>100</code> addresses or fewer, and expect Lite plans to work only with a single address.</li>
    <li>Use liquidity history or liquidity OHLC endpoints when you need a time series instead of the latest snapshot.</li>
  </ul>
</Accordion>

<Accordion title="Best Practices ✅" icon="fa-check-circle">
  <ul>
    <li>Deduplicate token mints before sending the batch so you do not waste request capacity.</li>
    <li>Use this endpoint as a cheap liquidity prefilter before more expensive historical analysis.</li>
    <li>Surface total liquidity and exit liquidity separately in UI because they answer different risk questions.</li>
  </ul>
</Accordion>

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

<br />


## OpenAPI

````yaml openapi/data/openapi_docs.json POST /defi/v3/liquidity/latest/token
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/liquidity/latest/token:
    post:
      tags:
        - Price & OHLCV
      summary: Liquidity Latest - Token
      description: >-
        Retrieve the latest total, exit, and stable liquidity with the latest
        price for Solana token addresses. Lite packages can request one address.
        Starter and higher packages can request up to 100 addresses.
      operationId: post-defi-v3-liquidity-latest-token
      parameters:
        - $ref: '#/components/parameters/xSolanaChainParam'
      requestBody:
        $ref: '#/components/requestBodies/latestTokenLiquidity'
      responses:
        '200':
          $ref: '#/components/responses/DefiLatestTokenLiquidity'
        '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:
    xSolanaChainParam:
      name: x-chain
      description: Solana network only.
      in: header
      required: false
      schema:
        type: string
        enum:
          - solana
        default: solana
  requestBodies:
    latestTokenLiquidity:
      required: true
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/LatestTokenLiquidityBody'
          examples:
            solana:
              value:
                addresses:
                  - 2RaLR1kY37bbNfqWTK49AiCbPtdF27497jZ6DatKpump
  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
    DefiLatestTokenLiquidity:
      description: JSON object containing latest liquidity data of tokens
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/DefiLatestTokenLiquidityResponse'
          examples:
            Solana:
              value:
                success: true
                data:
                  items:
                    - token: 2RaLR1kY37bbNfqWTK49AiCbPtdF27497jZ6DatKpump
                      liquidity_usd: 0.431778300255171
                      exit_liquidity_usd: 0.143926100085057
                      stable_liquidity_usd: 0.287852200170114
                      price: 0.00002468
  schemas:
    LatestTokenLiquidityBody:
      required:
        - addresses
      type: object
      properties:
        addresses:
          type: array
          minItems: 1
          maxItems: 100
          description: >-
            Lite packages can request one address. Starter and higher packages
            can request up to 100 addresses.
          items:
            type: string
          example:
            - 2RaLR1kY37bbNfqWTK49AiCbPtdF27497jZ6DatKpump
    DefiLatestTokenLiquidityResponse:
      type: object
      required:
        - success
        - data
      properties:
        success:
          type: boolean
          description: Whether the request completed successfully.
        data:
          type: object
          description: Latest liquidity snapshots for the requested tokens.
          required:
            - items
          properties:
            items:
              type: array
              description: Latest liquidity items for each requested token.
              items:
                type: object
                required:
                  - token
                  - liquidity_usd
                  - exit_liquidity_usd
                  - stable_liquidity_usd
                  - price
                properties:
                  token:
                    type: string
                    description: Token address for this liquidity snapshot.
                  liquidity_usd:
                    type: number
                    description: Current token liquidity in USD.
                  exit_liquidity_usd:
                    type: number
                    description: Current estimated exit liquidity in USD.
                  stable_liquidity_usd:
                    type: number
                    description: >-
                      Current liquidity in USD across pools paired with top
                      coins, counting both sides of each pool.
                  price:
                    type: number
                    nullable: true
                    description: >-
                      Latest token price used alongside the liquidity snapshot
                      when available.
    ErrorResponse:
      type: object
      properties:
        success:
          type: boolean
        message:
          type: string
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: X-API-KEY
      description: API key for authentication

````