> ## Documentation Index
> Fetch the complete documentation index at: https://staging-docs.orderly.network/llms.txt
> Use this file to discover all available pages before exploring further.

# Get historical conversion volume

> Returns historical daily asset conversion volume for a builder or for all of Orderly when `broker_id` is omitted. There is no maximum query date-range limit.

Asset conversion transactions are initiated by Orderly trading services. This volume excludes spot swaps, which are on-chain swaps executed directly between a wallet and a swap service.

This is a public endpoint with no API key or signature required. Only Mainnet / Production data is available.

`start_date` and `end_date` are optional UTC dates. Omit both to retrieve all available history, from July 15, 2025 through yesterday, using pagination. Setting `size=1000` requests up to 1,000 records per page.




## OpenAPI

````yaml orderly.openapi get /orderly/api/v1/data/convert_volume/historical
openapi: 3.0.1
info:
  title: EVM
  description: ''
  version: 1.0.0
servers:
  - url: https://api.orderly.org
    description: Mainnet
  - url: https://testnet-api.orderly.org
    description: Testnet
security: []
tags:
  - name: public
  - name: private
paths:
  /orderly/api/v1/data/convert_volume/historical:
    get:
      tags:
        - public
      summary: Get historical conversion volume
      description: >
        Returns historical daily asset conversion volume for a builder or for
        all of Orderly when `broker_id` is omitted. There is no maximum query
        date-range limit.


        Asset conversion transactions are initiated by Orderly trading services.
        This volume excludes spot swaps, which are on-chain swaps executed
        directly between a wallet and a swap service.


        This is a public endpoint with no API key or signature required. Only
        Mainnet / Production data is available.


        `start_date` and `end_date` are optional UTC dates. Omit both to
        retrieve all available history, from July 15, 2025 through yesterday,
        using pagination. Setting `size=1000` requests up to 1,000 records per
        page.
      parameters:
        - name: start_date
          in: query
          required: false
          description: >-
            Start date in UTC, formatted as YYYY-MM-DD. Omit both date filters
            for all available history from July 15, 2025 through yesterday.
          schema:
            type: string
            format: date
        - name: end_date
          in: query
          required: false
          description: >-
            End date in UTC, formatted as YYYY-MM-DD. No maximum date-range
            limit applies.
          schema:
            type: string
            format: date
        - $ref: '#/components/parameters/convert_volume_broker_id'
        - $ref: '#/components/parameters/convert_volume_page'
        - name: size
          in: query
          required: false
          description: Records per page, up to 1,000.
          schema:
            type: integer
            default: 100
            maximum: 1000
          example: 1000
      responses:
        '200':
          description: Historical daily conversion volume and pagination metadata.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConvertVolumeResponse'
              example:
                success: true
                data:
                  rows:
                    - date: '2026-09-27'
                      convert_volume: 2952.852671
                  snapshot_time: 1790565932225
                  meta:
                    records_per_page: 1
                    current_page: 1
                    total: 437
                timestamp: 1790565932225
      security: []
      servers:
        - url: https://data-api.orderly.network
          description: Mainnet / Production
components:
  parameters:
    convert_volume_broker_id:
      name: broker_id
      in: query
      required: false
      description: >-
        Filter to one builder by broker ID. Omit to retrieve conversion volume
        for all of Orderly.
      schema:
        type: string
      example: woofi_pro
    convert_volume_page:
      name: page
      in: query
      required: false
      description: Page number, starting from 1.
      schema:
        type: integer
        minimum: 1
        default: 1
  schemas:
    ConvertVolumeResponse:
      type: object
      properties:
        success:
          type: boolean
          description: Whether the request succeeded.
          example: true
        timestamp:
          type: integer
          format: int64
          description: Response timestamp in Unix milliseconds.
        data:
          type: object
          properties:
            rows:
              type: array
              description: Daily conversion volume records for the requested scope.
              items:
                type: object
                properties:
                  date:
                    type: string
                    format: date
                    description: UTC date of the conversion volume.
                    example: '2026-09-24'
                  convert_volume:
                    type: number
                    description: >-
                      Asset conversion volume for the date and requested builder
                      or platform scope. Covers conversions initiated by Orderly
                      trading services; excludes on-chain spot swaps executed
                      directly between a wallet and a swap service.
                    example: 736.390842
            snapshot_time:
              type: integer
              format: int64
              description: Data snapshot timestamp in Unix milliseconds.
            meta:
              type: object
              properties:
                records_per_page:
                  type: integer
                  description: Requested number of records per page.
                current_page:
                  type: integer
                  description: Current page number, starting from 1.
                total:
                  type: integer
                  description: Total number of records matching the query.

````