GET /api/v1/markets/{market_id}/funding-samples

Funding premium-index samples

Funding premium-index samples.

operationId: fetchFundingSamplesV1

Declared server differs from the callable one. This path declares its own servers base of https://exchange.nexus.xyz, without the /api/exchange mount the document default carries. Measured 2026-09-02, the override is not routed — https://exchange.nexus.xyz/api/v1/markets/{market_id}/funding-samples returns 404 while the gateway form in the sample below is routed. A client generated from this contract will aim at the override; pin the gateway base until the per-network hosts are live. See Networks.

Authentication: none — this operation is public.

Dense per-tick premium-index samples (60s cadence, up to 480 points = 8h). Public — no authentication required.

Parameters

Name	In	Type	Required	Default	Description
market_id	path	string	Yes	—	Market identifier (e.g. BTC-USDX-PERP, ETH-USDX-PERP). Uppercase ASCII alphanumeric segments joined by single hyphens, at most 64 characters. A value outside that set is rejected with 400 (INVALID_MARKET_ID) before any store is read — it cannot name a market, so an empty result would assert that nothing traded rather than that the question was malformed. A well-formed identifier that names no listed market is a 404, not a 400.
limit	query	integer	No	480	Maximum samples to return (capped at 480).

Responses

Status	Body	Meaning
200	array of FundingPremiumSample	Premium-index samples, oldest first.
400	— (no schema declared)	—

Example

cURL

curl -X GET 'https://exchange.nexus.xyz/api/exchange/api/v1/markets/BTC-USDX-PERP/funding-samples'

Python

import requests


response = requests.get("https://exchange.nexus.xyz/api/exchange/api/v1/markets/BTC-USDX-PERP/funding-samples")
response.raise_for_status()
print(response.json())

TypeScript

const response = await fetch("https://exchange.nexus.xyz/api/exchange/api/v1/markets/BTC-USDX-PERP/funding-samples", {
  method: "GET",
});
if (!response.ok) throw new Error(`${response.status} ${await response.text()}`);
console.log(await response.json());

---

_{Generated from eng/apps/exchange/api/openapi.json (spec 0.9.36). Do not edit by hand — regenerate with python3 product/docs/tools/api-reference/generate.py. Hand-authored context lives in the Guides pages.}