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

# All Time Trades (Multiple)

> Get all time trades or follow duration transactions for multiple tokens. Max to 20 tokens

<Tabs>
  <Tab title="Usage Note">
    <p><strong>Long-range trading activity for many tokens in one request.</strong></p>

    <ul>
      <li>Maximum batch size is <code>20</code> token addresses.</li>
      <li>Use the same <code>time\_frame</code> across the whole batch so tokens remain comparable.</li>
      <li><code>ui\_amount\_mode=scaled</code> applies Solana Token-2022 scaled UI amount when supported.</li>
    </ul>
  </Tab>

  <Tab title="Accessibility">
    <ul>
      <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(10 \* count^0.8)</code>.</li>
  </ul>
</Accordion>

<Accordion title="Use Cases 💡" icon="fa-lightbulb">
  <ul>
    <li>Rank many tokens by long-range trading activity in one request.</li>
    <li>Build comparison tables, scanners, and portfolio research boards.</li>
    <li>Feed token screening logic with consistent all-time or duration-bounded trade metrics.</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>Send up to <code>20</code> token addresses in the request body.</li>
    <li>Choose one shared <code>time\_frame</code> for the batch.</li>
  </ul>
</Accordion>

<Accordion title="Best Practices ✅" icon="fa-check-circle">
  <ul>
    <li>Deduplicate token addresses before sending the batch.</li>
    <li>Keep the batch focused on tokens you truly want to compare under the same horizon.</li>
    <li>Use the single endpoint when one token needs deeper explanation or page-level detail.</li>
  </ul>
</Accordion>

<br />


## OpenAPI

````yaml openapi/data/openapi_docs.json POST /defi/v3/all-time/trades/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/all-time/trades/multiple:
    post:
      tags:
        - Alltime & History
      summary: All Time Trades (Multiple)
      description: >-
        Get all time trades or follow duration transactions for multiple tokens.
        Max to 20 tokens
      operationId: post-defi-v3-all-time-trades-multiple
      parameters:
        - $ref: '#/components/parameters/xChainParam'
        - $ref: '#/components/parameters/timeframeDurationAlltimeTrades'
        - $ref: '#/components/parameters/listAddressParam'
        - $ref: '#/components/parameters/uiAmountModeParam'
      responses:
        '200':
          $ref: '#/components/responses/AlltimeTradesResponse'
          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:
    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
    timeframeDurationAlltimeTrades:
      name: time_frame
      description: 'Time interval (Example: ''24h'')'
      in: query
      required: true
      schema:
        type: string
        enum:
          - 1m
          - 5m
          - 30m
          - 1h
          - 2h
          - 4h
          - 8h
          - 24h
          - 3d
          - 7d
          - 14d
          - 30d
          - 90d
          - 180d
          - 1y
          - alltime
        default: 24h
    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
    AlltimeTradesResponse:
      description: All time trading statistics by token address
      content:
        application/json:
          schema:
            type: object
            properties:
              data:
                type: array
                description: All-time trading metrics grouped by token address.
                items:
                  type: object
                  properties:
                    address:
                      type: string
                      description: Token address.
                      example: So11111111111111111111111111111111111111112
                    total_volume:
                      type: number
                      description: Total traded volume in token units.
                      example: 158766463.26959822
                    total_volume_usd:
                      type: number
                      description: Total traded volume in USD.
                      example: 20188521260.405678
                    volume_buy_usd:
                      type: number
                      description: Total buy volume in USD.
                      example: 20188521260.405678
                    volume_sell_usd:
                      type: number
                      description: Total sell volume in USD.
                      example: 20188521260.405678
                    volume_buy:
                      type: number
                      description: Total buy volume in token units.
                      example: 78227859.16098201
                    volume_sell:
                      type: number
                      description: Total sell volume in token units.
                      example: 80538604.1086162
                    total_trade:
                      type: number
                      description: Total trade count.
                      example: 258522892
                    buy:
                      type: number
                      description: Total buy trade count.
                      example: 87829497
                    sell:
                      type: number
                      description: Total sell trade count.
                      example: 170693395
              success:
                type: boolean
                description: Whether the request completed successfully.
                example: true
  schemas:
    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

````