Market bundle

GET

market

bundle

Price, open interest and funding in one call

curl --request GET \
  --url https://api.example.com/market/bundle \
  --header 'X-API-Key: <api-key>'

const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};

fetch('https://api.example.com/market/bundle', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.example.com/market/bundle",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-API-Key: <api-key>"
  ],
]);

$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.example.com/market/bundle"

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

	req.Header.Add("X-API-Key", "<api-key>")

	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.example.com/market/bundle")

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

request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'

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

{
  "success": false,
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Invalid API key"
  },
  "meta": {
    "version": "2.0",
    "timestamp": "2026-04-29T12:00:00Z"
  }
}

{
  "success": false,
  "error": {
    "code": "NOT_FOUND",
    "message": "No data for BTCUSDT"
  },
  "meta": {
    "version": "2.0",
    "timestamp": "2026-04-29T12:00:00Z"
  }
}

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid request parameters",
    "details": {
      "errors": []
    }
  },
  "meta": {
    "version": "2.0",
    "timestamp": "2026-04-29T12:00:00Z"
  }
}

{
  "success": false,
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "Rate limit exceeded. Try again later."
  },
  "meta": {
    "version": "2.0",
    "timestamp": "2026-04-29T12:00:00Z"
  }
}

Candles, open interest and funding for one symbol over one window, in a single request. Six series in one request: candles, open interest, funding, CVD on both the perpetual and spot aggregates, and liquidations. Use this instead of calling the individual endpoints. It is one round trip rather than six, and measured about 3x faster than making those calls separately. Pick a subset with series= when you do not need all six.

One shared time axis

Every series shares the response’s single timestamps array. Index i of any series corresponds to timestamps[i], so you can zip them positionally without joining on time. This matters more than it sounds. The series come from different tables and do not all carry every bucket. Measured over a year at 1d: candles 372, funding 364, liquidations 367, across the same first and last timestamp. Returned unaligned, a positional zip would pair one day’s open interest with another day’s price and every number would still look plausible. A bucket a series does not have is null at that position, never carried forward from the previous one. Filling it would invent a print that did not happen and bias any average computed over the column. meta.extra.coverage reports how many buckets each series actually filled, so sparsity is visible without counting nulls:

{
  "data": {
    "timestamps": [1756080000000, 1756166400000, 1756252800000],
    "candles":    { "close": [80332.7, 80383.1, 80401.2] },
    "funding":    { "rate_open": [0.0001, null, 0.0003] }
  },
  "meta": {
    "extra": {
      "coverage": { "candles": 3, "funding": 2 },
      "aligned": true
    }
  }
}

The individual endpoints still return their own timestamps. Only the bundle reindexes onto a shared axis, because doing that join is the reason it exists.

Quota is charged per series, not per request. Three series cost three units, exactly as three separate calls would, and the count is reported in meta.extra.quota_units_charged.The bundle saves you round trips and alignment work, never allowance. Ask only for the series you need.

Partial results

A series that cannot be served comes back as null, with its reason under meta.extra.errors. The rest of the bundle is unaffected. This is deliberate: one cold or unavailable series should not cost you the two that were ready.

{
  "data": { "candles": { }, "open_interest": { }, "funding": null },
  "meta": {
    "extra": {
      "series": ["candles", "open_interest", "funding"],
      "quota_units_charged": 3,
      "errors": { "funding": "No funding data for SOLUSDT" }
    }
  }
}

Windows and cost

Long windows are read from continuous aggregates rather than raw one-minute rows, so a year at 1d is no more expensive than a day at 1m. The source actually used is reported in meta.extra.sources. Windows are capped at one year, matching retention. Your plan’s historical window applies on top of that: see history_depth and your_plan in /v2/meta.

Candles

Rate limits

Authorizations

X-API-Key

string

header

required

Your BackQuant API key (same key as v1)

Headers

X-API-Key

string | null

Query Parameters

symbol

enum<string>

default:BTCUSDT

Trading symbol: BTCUSDT, ETHUSDT, SOLUSDT, or HYPEUSDT.

Available options:

BTCUSDT,

ETHUSDT,

SOLUSDT,

HYPEUSDT

interval

enum<string>

default:1h

Interval for the gridded series.

Available options:

1m,

5m,

15m,

30m,

1h,

4h,

1d

hours

integer

default:168

Lookback window in hours, applied to every series.

Required range: 1 <= x <= 8760

series

string | null

Comma-separated subset of candles, open_interest, funding, cvd_perp, cvd_spot, liquidations. Defaults to all six. Ask only for what you need - each one costs a quota unit.

Response

Successful Response

Price, open interest and funding in one call

curl --request GET \
  --url https://api.example.com/market/bundle \
  --header 'X-API-Key: <api-key>'

const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};

fetch('https://api.example.com/market/bundle', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.example.com/market/bundle",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-API-Key: <api-key>"
  ],
]);

$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.example.com/market/bundle"

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

	req.Header.Add("X-API-Key", "<api-key>")

	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.example.com/market/bundle")

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

request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'

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

{
  "success": false,
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Invalid API key"
  },
  "meta": {
    "version": "2.0",
    "timestamp": "2026-04-29T12:00:00Z"
  }
}

{
  "success": false,
  "error": {
    "code": "NOT_FOUND",
    "message": "No data for BTCUSDT"
  },
  "meta": {
    "version": "2.0",
    "timestamp": "2026-04-29T12:00:00Z"
  }
}

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid request parameters",
    "details": {
      "errors": []
    }
  },
  "meta": {
    "version": "2.0",
    "timestamp": "2026-04-29T12:00:00Z"
  }
}

{
  "success": false,
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "Rate limit exceeded. Try again later."
  },
  "meta": {
    "version": "2.0",
    "timestamp": "2026-04-29T12:00:00Z"
  }
}

Get Started

Concepts

Code examples

API: Discovery & Meta

API: GEX

API: Options chain & OPEX

API: IV analytics

API: Probability density

API: Greeks

API: Open interest & flow

API: Futures & liquidation

API: Multi-symbol

API: Tape & WebSocket

API: Market data

API: ETF flows

One shared time axis

Partial results

Windows and cost

See also

Candles

Rate limits

Authorizations

Headers

Query Parameters

Response

​One shared time axis

​Partial results

​Windows and cost

​See also

Candles

Rate limits

Authorizations

Headers

Query Parameters

Response

One shared time axis

Partial results

Windows and cost

See also