public-market-data

CFTC Commitments of Traders positioning for a reference

Keyless weekly CFTC Commitments of Traders positioning (legacy report, futures only) for a catalog ticker with a listed US futures equivalent: gold, silver, platinum, palladium, WTI and Brent crude, EUR/USD, GBP/USD, and the S&P 500 and Nasdaq-100 e-mini futures for SPY and QQQ. Up to 12 reports, newest first.

Positions are as of each Tuesday (reportDate) and published the following Friday. Values are in contracts; net is long minus short. Non-commercial traders are mostly speculators, commercial traders hedge a business exposure. Week-over-week changes are CFTC's own and null when not published. Other catalog tickers answer 200 with coverage: not_applicable. status is fresh within 12 hours of CoinRithm's last read, stale up to 8 days, then unavailable with no reports; an upstream failure still answers 200. A ticker outside the catalog returns 404.

get/api/market/references/{ticker}/positioning

Request

  • Base URL: https://api.coinrithm.com
  • URL: https://api.coinrithm.com/api/market/references/{ticker}/positioning
  • Auth: none required

Path parameters

tickerstring required

Catalog ticker, case-insensitive (XAU, SPY).

Response

Contract, weekly reports, freshness and attribution

tickerstring required
coverage'available' | 'not_applicable' required
status'fresh' | 'stale' | 'unavailable' required

Freshness of an upstream dataset CoinRithm re-reads on a schedule. stale data is still served inside its documented maximum age; unavailable means no usable copy, never zero or empty truth.

asOfstring date-time nullable required

When CoinRithm last read the report from CFTC.

Changes

No recorded changes to this operation across all 1 revision of this API.