Historical

GET /historical - Fetch historical OHLC bars

Dated contracts always return their own prices. Ready ROOT1! aliases stitch contract eras before aggregation. adjustment=none (the compatibility default) preserves roll gaps. adjustment=backward-difference adds cumulative daily close differences to older contracts; the current contract and volumes stay unchanged. The adjustment is applied before aggregating candles that cross a roll. Missing adjustment references return CONTINUOUS_ADJUSTMENT_UNAVAILABLE rather than unadjusted prices. Discover supported modes and the recommended defaultAdjustment at /md/continuous. Adjusted responses include signed priceAdjustments and rollAdjustments; prices and offsets use fixed-point 1e9. Include adjustment in client cache identities and verify the echoed mode. Compare resolvedSymbol and seriesRevision against that metadata before attaching a raw live stream. Unknown/unready aliases return explicit error codes. Custom alias intervals are positive multiples of 15 seconds up to one week (e.g. 7m, 90m, 2h), using the same session anchors. Fine history has shorter retention than hourly history; historyAvailability reports the source tier and returned range. A bucket overlapping start can begin before start. History before the first verified era is never invented.

Fetches historical OHLC bars from the platform’s bar store.

Parameters

symbol (required): Full contract symbol like “ESH6”, “NQH6”
data_type (optional): “ohlc” (default: “ohlc”)
interval (optional): For OHLC - ”15s”, ”30s”, “1m”, “2m”, “3m”, “5m”, “15m”, “30m”, “1h”, “4h”, “1d”, “1w” (default: “1m”)
limit (optional): Max records to return (default: 5000, max: 10000)
days_back (optional): How many days of history (default: 30, max: 365)

Price Format

Prices are raw fixed-point integer values. Divide by 1,000,000,000 for display:

6010250000000 → $6010.25

GET

historical

GET /historical - Fetch historical OHLC bars

curl --request GET \
  --url https://api.hyperprop.com/md/historical

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.hyperprop.com/md/historical",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.hyperprop.com/md/historical"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.hyperprop.com/md/historical")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "bars": [
    {
      "close": 29530250000000,
      "high": 29534750000000,
      "low": 29521000000000,
      "open": 29528500000000,
      "timestamp": 1786046400,
      "volume": 412
    },
    {
      "close": 29533000000000,
      "high": 29534750000000,
      "low": 29521000000000,
      "open": 29530250000000,
      "timestamp": 1786046460,
      "volume": 412
    }
  ],
  "count": 2,
  "end": "2026-08-08T13:32:00Z",
  "interval": "1m",
  "start": "2026-08-08T13:30:00Z",
  "success": true,
  "symbol": "NQU6"
}

{
  "code": "<string>",
  "error": "<string>",
  "success": true
}

{
  "code": "<string>",
  "error": "<string>",
  "success": true
}

{
  "code": "<string>",
  "error": "<string>",
  "success": true
}

{
  "code": "<string>",
  "error": "<string>",
  "success": true
}

Query Parameters

symbol

string

required

Dated contract (own history) or a ready continuous alias, e.g. MNQ1!.

data_type

string

Data type: "ohlc" (default: "ohlc")

interval

string

OHLC interval: "15s", "30s", "1m", "2m", "3m", "5m", "15m", "30m", "1h", "4h", "1d", "1w" (default: "1m")

adjustment

string | null

Continuous aliases only: none (default) or backward-difference.

limit

integer

Limit number of records (default: 5000, max: 25000)

Required range: x >= 0

days_back

integer<int32>

Days back (default 30): raw max 365, continuous max 730; source retention applies.

Required range: x >= 0

start

string | null

Start time (ISO 8601 format, e.g., "2026-01-20T16:00:00Z")

end

string | null

End time (ISO 8601 format, defaults to now)

Response

Historical OHLC data

Response for historical OHLC data

bars

object[]

required

Show child attributes

count

integer

required

Required range: x >= 0

end

string

required

interval

string

required

start

string

required

success

boolean

required

symbol

string

required

adjustment

string | null

Alias only: none or backward-difference, matching the request.

historyAvailability

object | null

Show child attributes

historyStart

integer<int64> | null

Alias only: earliest verified ledger history in Unix seconds.

Required range: x >= 0

priceAdjustments

object[] | null

Adjusted aliases only: cumulative offsets by historical era.

Show child attributes

resolvedSymbol

string | null

Alias only: current dated contract for the raw WebSocket subscription.

rollAdjustments

object[] | null

Adjusted aliases only: reference closes used for each rollover difference.

Show child attributes

rollPolicy

string | null

Alias only: always cme-session-roll. Original era provenance is preserved.

seriesRevision

string | null

Alias only: compare with /md/continuous revision to discard stale responses.

⌘I

GET /historical - Fetch historical OHLC bars

curl --request GET \
  --url https://api.hyperprop.com/md/historical

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.hyperprop.com/md/historical",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.hyperprop.com/md/historical"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.hyperprop.com/md/historical")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "bars": [
    {
      "close": 29530250000000,
      "high": 29534750000000,
      "low": 29521000000000,
      "open": 29528500000000,
      "timestamp": 1786046400,
      "volume": 412
    },
    {
      "close": 29533000000000,
      "high": 29534750000000,
      "low": 29521000000000,
      "open": 29530250000000,
      "timestamp": 1786046460,
      "volume": 412
    }
  ],
  "count": 2,
  "end": "2026-08-08T13:32:00Z",
  "interval": "1m",
  "start": "2026-08-08T13:30:00Z",
  "success": true,
  "symbol": "NQU6"
}

{
  "code": "<string>",
  "error": "<string>",
  "success": true
}

{
  "code": "<string>",
  "error": "<string>",
  "success": true
}

{
  "code": "<string>",
  "error": "<string>",
  "success": true
}

{
  "code": "<string>",
  "error": "<string>",
  "success": true
}

Platform API

Trade API

Market Data API

GET /historical - Fetch historical OHLC bars

Parameters

Price Format

Query Parameters

Response