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

# Price - Multiple

> Retrieve the latest price information for multiple tokens. Maximum 100 tokens

<Tabs>
  <Tab title="Usage Note">
    <p><strong>Batch spot pricing with query-string input.</strong></p>

    <ul>
      <li>Always use checksum contract addresses on EVM chains and canonical token mint addresses on Solana-like chains.</li>
      <li>Pass token addresses as a comma-separated list in <code>list\_address</code>.</li>
      <li>Maximum batch size is <code>100</code> token addresses per request.</li>
      <li><code>include\_liquidity=true</code> requests price plus liquidity context for each token when available.</li>
      <li>Individual entries may be <code>null</code> or partial if a token is unknown, unsupported, or not indexed on the selected chain.</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>All chains ⛓️ ✨</strong></p>
  </Tab>
</Tabs>

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

<Accordion title="Use Cases 💡" icon="fa-lightbulb">
  <ul>
    <li>Price entire watchlists, portfolio holdings, or leaderboard rows in one request.</li>
    <li>Feed token tables, mobile market boards, and scanner results without per-row price calls.</li>
    <li>Pair batch prices with batch market, liquidity, or metadata endpoints for dense dashboards.</li>
    <li>Reduce request fan-out for bots or backends that track many assets at once.</li>
  </ul>
</Accordion>

<Accordion title="How to Use 🛠️" icon="fa-book-open">
  <ul>
    <li>Set <code>x-chain</code> for the target network.</li>
    <li>Pass <code>list\_address</code> as a comma-separated token-address string.</li>
    <li>Keep the request under <code>100</code> addresses.</li>
    <li>Switch to the POST variant when your token list is easier to send in a request body.</li>
  </ul>
</Accordion>

<Accordion title="Best Practices ✅" icon="fa-check-circle">
  <ul>
    <li>Deduplicate token addresses before calling so CU and payload size stay predictable.</li>
    <li>Cache the batch result briefly and reuse it across cards, tables, and widgets rendered in the same cycle.</li>
    <li>If only a few rows need live updates, refresh those rows separately instead of reloading a full batch every time.</li>
  </ul>
</Accordion>

<br />


## OpenAPI

````yaml openapi/data/openapi_docs.json GET /defi/multi_price
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/multi_price:
    get:
      tags:
        - Price & OHLCV
      summary: Price - Multiple
      description: >-
        Retrieve the latest price information for multiple tokens. Maximum 100
        tokens
      operationId: get-defi-multi_price
      parameters:
        - $ref: '#/components/parameters/xChainParam'
        - $ref: '#/components/parameters/checkLiquidityParam'
        - $ref: '#/components/parameters/includeLiquidityParam'
        - $ref: '#/components/parameters/listAddressParam'
        - $ref: '#/components/parameters/uiAmountModeParam'
      responses:
        '200':
          $ref: '#/components/responses/DefiMultiPrice'
        '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:
    xChainParam:
      name: x-chain
      description: A chain name listed in supported networks.
      in: header
      required: false
      schema:
        type: string
        enum:
          - solana
          - ethereum
          - bsc
          - base
          - robinhood
          - sui
          - mantle
          - hyperevm
          - arbitrum
          - avalanche
          - optimism
          - polygon
          - zksync
          - monad
          - aptos
          - fogo
          - megaeth
        default: solana
    checkLiquidityParam:
      name: check_liquidity
      description: Specify the liquidity value to check.
      in: query
      required: false
      schema:
        type: number
      example: 100
    includeLiquidityParam:
      name: include_liquidity
      description: Specify whether to include liquidity in the response.
      in: query
      required: false
      schema:
        type: boolean
        enum:
          - true
          - false
    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
    uiAmountModeParam:
      name: ui_amount_mode
      description: >-
        Indicate whether to use the scaled amount for scaled ui amount tokens.
        Only support solana
      in: query
      required: false
      schema:
        type: string
        enum:
          - raw
          - scaled
          - both
        default: raw
  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
    DefiMultiPrice:
      description: JSON object containing price values and update time of multiple tokens
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/DefiMultiPriceResponse'
          examples:
            Solana:
              value:
                success: true
                data:
                  So11111111111111111111111111111111111111112:
                    isScaledUiToken: false
                    value: 127.32916175338693
                    updateUnixTime: 1726673192
                    updateHumanTime: '2024-09-18T15:26:32'
                    priceInNative: 1
                    priceChange24h: -5.833510393308625
                    liquidity: 7026264396
                  DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263:
                    isScaledUiToken: false
                    value: 0.00001598090539282
                    updateUnixTime: 1726673185
                    updateHumanTime: '2024-09-18T15:26:25'
                    priceInNative: 1.2583e-7
                    priceChange24h: -4.766925300538944
                    liquidity: 1234414
            EVM:
              value:
                success: true
                data:
                  '0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2':
                    value: 2600
                    updateUnixTime: 1726673192
                    updateHumanTime: '2024-09-18T15:26:32'
                    priceChange24h: -5.833510393308625
                    liquidity: 7026264396
                  '0x6982508145454Ce325dDbE47a25d4ec3d2311933':
                    value: 9.58e-7
                    updateUnixTime: 1726673185
                    updateHumanTime: '2024-09-18T15:26:25'
                    priceChange24h: -4.766925300538944
                    liquidity: 1431513
            SolanaScaledUIAmount:
              value:
                data:
                  XsP7xzNPvEHS1m6qfanPUGjNmdnmsLKEoNAnHjdxxyZ:
                    isScaledUiToken: true
                    value: 404.21180826549516
                    updateUnixTime: 1751369725
                    updateHumanTime: '2025-07-01T11:35:25'
                    priceInNative: 2.71366223488443
                    priceChange24h: 4.268112150090328
                    scaledValue: 404.21180826549516
                    multiplier: 1
                    scaledPriceInNative: 2.71366223488443
                  DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263:
                    isScaledUiToken: false
                    value: 0.000013874375132396532
                    updateUnixTime: 1751369771
                    updateHumanTime: '2025-07-01T11:36:11'
                    priceInNative: 9.314514583570637e-8
                    priceChange24h: -4.55999840357565
                success: true
            MissingMultiPrice:
              value:
                success: true
                data:
                  So11111111111111111111111111111111111111112: null
                  DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263: null
  schemas:
    DefiMultiPriceResponse:
      type: object
      required:
        - success
        - data
      properties:
        success:
          type: boolean
          description: Whether the request completed successfully.
        data:
          type: object
          description: >-
            Map keyed by token address. Each value is the latest price object
            for that token, or `null` when price data is unavailable.
          additionalProperties:
            $ref: '#/components/schemas/DefiPriceObject'
          maxProperties: 10
    ErrorResponse:
      type: object
      properties:
        success:
          type: boolean
        message:
          type: string
    DefiPriceObject:
      type: object
      required:
        - value
        - updateUnixTime
        - updateHumanTime
        - priceChange24h
      properties:
        value:
          type: number
          description: Latest token price in the requested quote currency, typically USD.
        updateUnixTime:
          type: integer
          description: Unix timestamp in seconds when this price point was last updated.
        updateHumanTime:
          type: string
          description: Human-readable timestamp of the latest price update.
        priceChange24h:
          type: number
          description: Percentage price change over the last 24 hours.
        priceInNative:
          type: number
          description: >-
            Latest token price quoted in the chain's native asset when
            available.
        liquidity:
          type: number
          description: >-
            Current token liquidity in USD when liquidity lookup is enabled and
            available.
        isScaledUiToken:
          type: boolean
          description: True when the token uses Solana Token-2022 scaled UI amounts.
        scaledValue:
          type: number
          description: >-
            Latest price adjusted by the token's scaled UI multiplier. Present
            for scaled UI tokens.
        multiplier:
          type: number
          description: >-
            Scaled UI multiplier applied to raw token-denominated values for
            Token-2022 assets.
        scaledPriceInNative:
          type: number
          description: >-
            Latest native-asset price adjusted by the scaled UI multiplier.
            Present for scaled UI tokens.
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: X-API-KEY
      description: API key for authentication

````