/v1/positioning
Four-group TFF breakdown for one financial future
Try it live
10 free calls per day — no sign-up, no API key. Goes through the oanor gateway.
It works. Grab an API key and use it in your project.
Get an API keyCode snippets
curl "https://api.oanor.com/tffpositioning-api/v1/positioning" \ -H "x-oanor-key: oanor_test_..."
await fetch("https://api.oanor.com/tffpositioning-api/v1/positioning", {
headers: { "x-oanor-key": "oanor_test_..." }
});
$ch = curl_init("https://api.oanor.com/tffpositioning-api/v1/positioning");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-oanor-key: oanor_test_..."]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$out = curl_exec($ch);
import requests
requests.get(
"https://api.oanor.com/tffpositioning-api/v1/positioning",
headers={"x-oanor-key": "oanor_test_..."}
)
Example response
A real response from this endpoint, captured by the latest health check.
{
"data": {
"name": "UST 10-Year Note",
"note": "CFTC Traders in Financial Futures (TFF), latest weekly report. net = long - short contracts; net_pct_oi = net as a share of open interest. Leveraged Funds = hedge funds / CTAs (fast speculative money); Asset Managers = pension/mutual funds and insurers (real-money long-term side); Dealers = sell-side intermediaries. net_change_week is the week-over-week change in net. Updated Fridays.",
"class": "rate",
"market": "ust10y",
"source": "CFTC Traders in Financial Futures (futures-only)",
"dealers": {
"net": -417784,
"long": 159245,
"short": 577029,
"net_pct_oi": -6.45,
"net_change_week": 57410
},
"report_date": "2026-06-02",
"open_interest": 6478701,
"asset_managers": {
"net": 2311379,
"bias": "crowded net long",
"long": 3240635,
"short": 929256,
"net_pct_oi": 35.68,
"long_pct_oi": 50,
"short_pct_oi": 14.3,
"net_change_week": 260401
},
"leveraged_funds": {
"net": -1896875,
"bias": "crowded net short",
"long": 379854,
"short": 2276729,
"net_pct_oi": -29.28,
"long_pct_oi": 5.9,
"short_pct_oi": 35.1,
"traders_long": 53,
"traders_short": 90,
"net_change_week": 17885
},
"other_reportables": {
"net": -1620,
"long": 233571,
"short": 235191,
"net_pct_oi": -0.03,
"net_change_week": -43877
}
},
"meta": {
"timestamp": "2026-06-12T10:34:48.830Z",
"request_id": "7d60d823-926c-4033-a05f-cc8f5814288a"
},
"status": "ok",
"message": "TFF positioning retrieved successfully",
"success": true
}