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

# Get the Token Volume Index by day

> The Token Volume Index: settled daily token volume for the closed frontier labs (`anthropic`, `openai`, `google`), with each lab indexed to 100 at its first settled day (`growthIndex`), its share of the closed-lab daily total (`share`), and the combined total indexed to 100 (`totalGrowthIndex`). The index is fixed-base: baselines anchor to each lab's first settled day ever, not to the first day of the requested window, so overlapping windows return identical values for the same date. A lab absent for a day is left out of that day's `labs` array rather than carried as a zero. Daily grain only. Requires an API key - like the Workload Cost Index there is no free tier.


## Overview

The Token Volume Index: settled daily token volume for the closed frontier labs (`anthropic`, `openai`, `google`). Each lab carries its volume indexed to 100 at its first settled day (`growthIndex`) and its share of the closed-lab daily total (`share`); the combined total rides alongside as `totalGrowthIndex`. Both `startDate` and `endDate` are required - the series is read over an explicit window. The window selects which days come back; baselines stay anchored to each lab's first settled day in the full history, so overlapping windows return identical values for the same date. A lab that settled no volume on a day is left out of that day's `labs` array rather than reported as zero. Daily grain only. Requires an API key - like the Workload Cost Index, no part of this dataset has a free tier.


## OpenAPI

````yaml openapi.yaml GET /api/token-volume
openapi: 3.1.0
info:
  title: Ornn Data API
  version: 1.0.0
  description: >
    Read-only REST API for GPU and memory market data. The price index is the
    going rate of compute in USD per GPU-hour, a weighted average of all
    verified compute transactions across the market.
servers:
  - url: https://api.ornnai.com
security:
  - bearerAuth: []
tags:
  - name: Current Prices
  - name: Historical Prices
  - name: Analytics
  - name: Memory
  - name: Token Prices
  - name: Workload Cost
  - name: LLM Coding
  - name: Token Volume
  - name: Model Frontier
  - name: Compute Buyers
  - name: Neo-Cloud Sites
  - name: Reference
paths:
  /api/token-volume:
    get:
      tags:
        - Token Volume
      summary: Get the Token Volume Index by day
      description: >
        The Token Volume Index: settled daily token volume for the closed
        frontier labs (`anthropic`, `openai`, `google`), with each lab indexed
        to 100 at its first settled day (`growthIndex`), its share of the
        closed-lab daily total (`share`), and the combined total indexed to 100
        (`totalGrowthIndex`). The index is fixed-base: baselines anchor to each
        lab's first settled day ever, not to the first day of the requested
        window, so overlapping windows return identical values for the same
        date. A lab absent for a day is left out of that day's `labs` array
        rather than carried as a zero. Daily grain only. Requires an API key -
        like the Workload Cost Index there is no free tier.
      parameters:
        - name: startDate
          in: query
          required: true
          description: Inclusive start of the settlement-date window in YYYY-MM-DD.
          schema:
            type: string
            example: '2026-07-01'
        - name: endDate
          in: query
          required: true
          description: Inclusive end of the settlement-date window in YYYY-MM-DD.
          schema:
            type: string
            example: '2026-07-31'
      responses:
        '200':
          description: >-
            One row per settlement day, each carrying the labs that settled
            volume that day.
          content:
            application/json:
              example:
                success: true
                startDate: '2026-07-01'
                endDate: '2026-07-31'
                granularity: daily
                access: premium
                labs:
                  - anthropic
                  - openai
                  - google
                baselines:
                  - lab: anthropic
                    date: '2026-06-04'
                    totalTokens: 181000000
                  - lab: openai
                    date: '2026-06-04'
                    totalTokens: 262000000
                  - lab: google
                    date: '2026-06-04'
                    totalTokens: 199000000
                totalBaseline:
                  date: '2026-06-04'
                  totalTokens: 642000000
                count: 31
                data:
                  - date: '2026-07-01'
                    totalTokens: 703000000
                    totalGrowthIndex: 109.5
                    labs:
                      - lab: anthropic
                        totalTokens: 201000000
                        growthIndex: 111
                        share: 0.286
                      - lab: openai
                        totalTokens: 287000000
                        growthIndex: 109.5
                        share: 0.408
                      - lab: google
                        totalTokens: 215000000
                        growthIndex: 108
                        share: 0.306
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
      x-codeSamples:
        - lang: bash
          label: cURL
          source: >
            curl
            "https://api.ornnai.com/api/token-volume?startDate=2026-07-01&endDate=2026-07-31"
            \
              -H "Authorization: Bearer YOUR_API_KEY"
        - lang: python
          label: Python
          source: |
            import requests

            days = requests.get(
                "https://api.ornnai.com/api/token-volume",
                params={"startDate": "2026-07-01", "endDate": "2026-07-31"},
                headers={"Authorization": "Bearer YOUR_API_KEY"},
            ).json()["data"]
            for day in days:
                for lab in day["labs"]:
                    print(day["date"], lab["lab"], lab["growthIndex"], lab["share"])
        - lang: javascript
          label: JavaScript
          source: |
            const res = await fetch(
              "https://api.ornnai.com/api/token-volume?startDate=2026-07-01&endDate=2026-07-31",
              { headers: { Authorization: "Bearer YOUR_API_KEY" } },
            );
            const { data } = await res.json();
        - lang: php
          label: PHP
          source: >
            <?php

            $ch =
            curl_init("https://api.ornnai.com/api/token-volume?startDate=2026-07-01&endDate=2026-07-31");

            curl_setopt_array($ch, [
                CURLOPT_RETURNTRANSFER => true,
                CURLOPT_HTTPHEADER => ["Authorization: Bearer YOUR_API_KEY"],
            ]);

            $data = json_decode(curl_exec($ch), true);
        - lang: go
          label: Go
          source: "package main\n\nimport (\n\t\"io\"\n\t\"net/http\"\n)\n\nfunc main() {\n\tendpoint := \"https://api.ornnai.com/api/token-volume?startDate=2026-07-01&endDate=2026-07-31\"\n\treq, _ := http.NewRequest(\"GET\", endpoint, nil)\n\treq.Header.Set(\"Authorization\", \"Bearer YOUR_API_KEY\")\n\tresp, _ := http.DefaultClient.Do(req)\n\tdefer resp.Body.Close()\n\tbody, _ := io.ReadAll(resp.Body)\n\t_ = body\n}\n"
        - lang: java
          label: Java
          source: >
            import java.net.URI;

            import java.net.http.HttpClient;

            import java.net.http.HttpRequest;

            import java.net.http.HttpResponse;


            HttpClient client = HttpClient.newHttpClient();

            HttpRequest request = HttpRequest.newBuilder(
                    URI.create("https://api.ornnai.com/api/token-volume?startDate=2026-07-01&endDate=2026-07-31"))
                .header("Authorization", "Bearer YOUR_API_KEY")
                .build();
            HttpResponse<String> response = client.send(request,
            HttpResponse.BodyHandlers.ofString());
        - lang: ruby
          label: Ruby
          source: >
            require "net/http"

            require "json"


            uri =
            URI("https://api.ornnai.com/api/token-volume?startDate=2026-07-01&endDate=2026-07-31")

            req = Net::HTTP::Get.new(uri)

            req["Authorization"] = "Bearer YOUR_API_KEY"

            res = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) {
            |http| http.request(req) }

            data = JSON.parse(res.body)
components:
  responses:
    BadRequest:
      description: A required parameter is missing or invalid.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    Unauthorized:
      description: Missing, invalid, or revoked API key.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error: Unauthorized
            message: 'API key required. Use Authorization: Bearer YOUR_API_KEY'
  schemas:
    Error:
      type: object
      properties:
        error:
          type: string
          example: Bad request
        message:
          type: string
          example: >-
            Invalid GPU type. Allowed: H100 SXM, H200, A100 SXM4, RTX 5090,
            B200, RTX PRO 6000 WS
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: API key passed as a Bearer token. Create one in the dashboard.

````