> ## 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 published forward curve history

> Past published forward curves: one row per curve each time its marks were published, oldest first. Full / Enterprise only.
Each row is the whole curve as Ornn offered it after a marks update: `name` is the GPU type, `capturedAt` the publish time, and `marks` the five tenors with `label`, `months`, `price`, and `has_mark`. An unmarked tenor has a null `price` and `has_mark: false`, never 0. Rows are published curves only: model reconstructions are not served. Covers the eight published curves (H100 SXM, H200, A100 SXM4, B200, RTX PRO 6000 WS, B300, GB200, GB300); omit `gpu` for all eight. Both dates are optional and inclusive: a date-only `endDate` covers that whole UTC day. History begins when publish capture started; there is no earlier backfill. A Premium or Trial key returns `403`. For the current curve with provenance, use `GET /api/forward`.


## Overview

Past published GPU forward curves, for a Full / Enterprise plan. Each row is one curve as Ornn offered it after a marks update: `name` is the GPU type, `capturedAt` is when it was published, and `marks` holds the five tenors (1M, 6M, 1Y, 3Y, 5Y) with `label`, `months`, `price`, and `has_mark`. Rows come oldest first. An unmarked tenor has a null `price` and `has_mark: false`. It is never reported as 0, and nothing is interpolated or carried forward.

Only published curves are served. Model reconstructions of earlier dates are not part of this response. History starts when Ornn began recording each publish. There is no earlier backfill.

Pass `gpu` for one curve (H100 SXM, H200, A100 SXM4, B200, RTX PRO 6000 WS, B300, GB200, or GB300), or omit it for all eight. `startDate` and `endDate` are optional and inclusive. A date-only `endDate` covers that whole UTC day. A Premium or Trial key returns `403`.

Each `price` is a term mark on the same basis as [the current curve](https://data.ornn.com/docs/api-reference/forward/get-the-forward-curve.md): the flat reserved-contract rate of that tenor. How the marks are built is on [Forward Curves](https://data.ornn.com/docs/forward-curves.md). On MCP, the same data is the `get_forward_curve_history` tool.


## OpenAPI

````yaml openapi.yaml GET /api/forward/history
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: Forward Curves
  - name: Token Volume
  - name: Model Frontier
  - name: Compute Buyers
  - name: Power Markets
  - name: Neo-Cloud Sites
  - name: Reference
paths:
  /api/forward/history:
    get:
      tags:
        - Forward Curves
      summary: Get the published forward curve history
      description: >
        Past published forward curves: one row per curve each time its marks
        were published, oldest first. Full / Enterprise only.

        Each row is the whole curve as Ornn offered it after a marks update:
        `name` is the GPU type, `capturedAt` the publish time, and `marks` the
        five tenors with `label`, `months`, `price`, and `has_mark`. An unmarked
        tenor has a null `price` and `has_mark: false`, never 0. Rows are
        published curves only: model reconstructions are not served. Covers the
        eight published curves (H100 SXM, H200, A100 SXM4, B200, RTX PRO 6000
        WS, B300, GB200, GB300); omit `gpu` for all eight. Both dates are
        optional and inclusive: a date-only `endDate` covers that whole UTC day.
        History begins when publish capture started; there is no earlier
        backfill. A Premium or Trial key returns `403`. For the current curve
        with provenance, use `GET /api/forward`.
      parameters:
        - name: gpu
          in: query
          description: One curve. Omit for all eight.
          schema:
            type: string
            enum:
              - H100 SXM
              - H200
              - A100 SXM4
              - B200
              - RTX PRO 6000 WS
              - B300
              - GB200
              - GB300
            example: H100 SXM
        - name: startDate
          in: query
          description: Inclusive start, YYYY-MM-DD or ISO 8601.
          schema:
            type: string
            example: '2026-10-01'
        - name: endDate
          in: query
          description: >-
            Inclusive end, YYYY-MM-DD or ISO 8601. A date-only value covers the
            whole UTC day.
          schema:
            type: string
            example: '2026-10-31'
      responses:
        '200':
          description: Published curves in capture order, oldest first.
          content:
            application/json:
              example:
                success: true
                data:
                  - name: H100 SXM
                    capturedAt: '2026-10-03T21:00:00.000Z'
                    marks:
                      - label: 1M
                        months: 1
                        price: 2.41
                        has_mark: true
                      - label: 6M
                        months: 6
                        price: 2.35
                        has_mark: true
                      - label: 1Y
                        months: 12
                        price: 2.28
                        has_mark: true
                      - label: 3Y
                        months: 36
                        price: null
                        has_mark: false
                      - label: 5Y
                        months: 60
                        price: null
                        has_mark: false
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          description: >-
            Forward curve history is Full / Enterprise only (a Premium or Trial
            key).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                error: Forbidden
                message: Forward curve history is available on Full / Enterprise.
      x-codeSamples:
        - lang: bash
          label: cURL
          source: >
            curl
            "https://api.ornnai.com/api/forward/history?gpu=H100%20SXM&startDate=2026-10-01&endDate=2026-10-31"
            \
              -H "Authorization: Bearer YOUR_API_KEY"
        - lang: python
          label: Python
          source: |
            import requests

            captures = requests.get(
                "https://api.ornnai.com/api/forward/history",
                params={"gpu": "H100 SXM", "startDate": "2026-10-01", "endDate": "2026-10-31"},
                headers={"Authorization": "Bearer YOUR_API_KEY"},
            ).json()["data"]
            for capture in captures:
                for mark in capture["marks"]:
                    print(capture["name"], capture["capturedAt"], mark["label"], mark["price"])
        - lang: javascript
          label: JavaScript
          source: |
            const res = await fetch(
              "https://api.ornnai.com/api/forward/history?gpu=H100%20SXM&startDate=2026-10-01&endDate=2026-10-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/forward/history?gpu=H100%20SXM&startDate=2026-10-01&endDate=2026-10-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/forward/history?gpu=H100%20SXM&startDate=2026-10-01&endDate=2026-10-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/forward/history?gpu=H100%20SXM&startDate=2026-10-01&endDate=2026-10-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/forward/history?gpu=H100%20SXM&startDate=2026-10-01&endDate=2026-10-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, B200, RTX PRO
            6000 WS
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: API key passed as a Bearer token. Create one in the dashboard.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.