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

# Blockchain Market Metrics

> Retrieves market metrics for the specified blockchain, aggregated by the specified time frame. The response includes trading metrics (trading volume, trade count, and active trading tokens) aggregated over each time frame, and snapshot metric (stablecoin market capitalization) representing values at the end of each time frame.

<Tabs>
  <Tab title="Usage Notes">
    <p><strong>Data Availability</strong></p>

    <ul>
      <li>Trading volume, Trade count, and Active trading tokens: From 2022-01-01 00:00 UTC (unix timestamp: 1640995200)</li>
      <li>Stablecoin market capitalization: From 2025-05-22 00:00 UTC (unix timestamp: 1747872000)</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>This endpoint consumes <code>40 CU</code> per request.</li>
  </ul>
</Accordion>

<Accordion title="Use Cases 💡" icon="fa-lightbulb">
  <ul>
    <li>Track historical blockchain activity through trading volume, transaction count, active trading tokens, and stablecoin market capitalization.</li>
    <li>Build dashboards to monitor market activity and stablecoin growth over time.</li>
  </ul>
</Accordion>

<Accordion title="How to Use 🛠️" icon="fa-book-open">
  <ul>
    <li>Specify the target <code>chain</code> and the desired <code>time\_frame</code> for data aggregation.</li>
    <li>Provide a reference <code>time</code> and a <code>direction</code> (<code>backward</code> or <code>forward</code>) to retrieve historical time frames relative to that timestamp.</li>
    <li>Each record represents a single time frame. <code>unix\_time</code> is the UTC timestamp of the beginning of the time frame. Trading metrics are aggregated over the time frame, while <code>stable\_coin\_market\_cap</code> represents the value at the end of the time frame.</li>
  </ul>
</Accordion>

<Accordion title="Best Practices ✅" icon="fa-check-circle">
  <ul>
    <li>Analyze <code>volume\_usd</code>, <code>trade\_count</code>, and <code>active\_trading\_tokens</code> together to distinguish increased trading activity from broader market participation.</li>
    <li>Compare trading activity with <code>stable\_coin\_market\_cap</code> to understand how changes in on-chain stablecoin supply relate to market activity.</li>
  </ul>
</Accordion>

<Accordion title="Notes 📝" icon="fa-circle-info">
  <ul>
    <li><code>volume\_usd</code>, <code>trade\_count</code>, and <code>active\_trading\_tokens</code> are aggregated over each time frame.</li>
    <li><code>stable\_coin\_market\_cap</code> represents the market capitalization as of the end of each time frame.</li>
    <li><code>time</code> is used only to determine the starting time frame. If it does not align with the specified <code>time\_frame</code>, it is mapped to the corresponding time frame.</li>
    <li><code>unix\_time</code> always represents the start of the corresponding time frame in UTC.</li>
  </ul>
</Accordion>

<br />


## OpenAPI

````yaml openapi/data/openapi_docs.json GET /market/v1/blockchain-metrics
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:
  /market/v1/blockchain-metrics:
    get:
      tags:
        - DEX & Protocol
      summary: Blockchain Market Metrics
      description: >-
        Retrieves market metrics for the specified blockchain, aggregated by the
        specified time frame. The response includes trading metrics (trading
        volume, trade count, and active trading tokens) aggregated over each
        time frame, and snapshot metric (stablecoin market capitalization)
        representing values at the end of each time frame.
      operationId: get-market-v1-blockchain-metrics
      parameters:
        - $ref: '#/components/parameters/xSolanaChainParam'
        - $ref: '#/components/parameters/marketHistoryTimeFrameParam'
        - $ref: '#/components/parameters/referenceTimestampParam'
        - $ref: '#/components/parameters/timeDirectionParam'
        - $ref: '#/components/parameters/countLimit10Param'
      responses:
        '200':
          $ref: '#/components/responses/marketHistoryResponse'
        '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
    marketHistoryTimeFrameParam:
      name: time_frame
      description: The aggregation interval for the returned data.
      in: query
      required: false
      schema:
        type: string
        enum:
          - 1D
        default: 1D
    referenceTimestampParam:
      name: time
      description: >-
        The reference unix timestamp in seconds to start retrieving data.
        Defaults to the current time.
      in: query
      required: false
      schema:
        type: integer
        minimum: 0
        maximum: 10000000000
      example: 1750950840
    timeDirectionParam:
      name: direction
      description: The retrieval direction relative to the reference time.
      in: query
      required: false
      schema:
        type: string
        enum:
          - backward
          - forward
        default: backward
    countLimit10Param:
      name: count
      description: Limit the number of data records returned.
      in: query
      required: false
      schema:
        type: integer
        default: 10
        minimum: 1
        maximum: 10
  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
    marketHistoryResponse:
      description: JSON object containing market metrics of a specified chain.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/MarketHistoryResponseType'
          examples:
            Solana:
              value:
                success: true
                data:
                  items:
                    - unix_time: 1784505600
                      volume_usd: 6830233087.9298725
                      trade_count: 28959937
                      active_trading_tokens: 70410
                      stable_coin_market_cap: 14836981086.24842
                    - unix_time: 1784505600
                      volume_usd: 843958590.8503149
                      trade_count: 3335919
                      active_trading_tokens: 13823
                      stable_coin_market_cap: 14760991987.594704
                  has_more: true
  schemas:
    MarketHistoryResponseType:
      type: object
      required:
        - success
        - data
      properties:
        success:
          type: boolean
        data:
          type: object
          properties:
            items:
              type: array
              items:
                type: object
                properties:
                  unix_time:
                    type: integer
                    description: >-
                      The Unix timestamp in seconds (UTC timezone) of the
                      beginning of the aggregated time frame.
                  volume_usd:
                    type: number
                    description: >-
                      The total trading volume in USD for the corresponding time
                      frame.
                  trade_count:
                    type: number
                    description: >-
                      The total number of trades during the corresponding time
                      frame.
                  active_trading_tokens:
                    type: number
                    description: >-
                      The number of unique tokens with at least one trade during
                      the corresponding time frame.
                  stable_coin_market_cap:
                    type: number
                    description: >-
                      The total market capitalization (USD) of all stablecoins
                      on the selected blockchain at the end of the corresponding
                      time frame.
            has_more:
              type: boolean
              description: >-
                Indicates whether there are more data points available beyond
                the current response.
    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

````