Skip to content
GET /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.

Custom headers (optional)
api.oanor.com/tffpositioning-api

It works. Grab an API key and use it in your project.

Get an API key

Code 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
}