# Managed Money Positioning API
> Where the hedge funds are positioned in commodity futures, read live from the CFTC Disaggregated Commitments-of-Traders report — no key. The legacy COT report lumps every speculator into one "non-commercial" bucket; the Disaggregated report, introduced in 2009 precisely because that was too crude, splits the market into four real groups — Managed Money (the trend-following hedge funds and CTAs, the speculative flow everyone watches), Producer/Merchant (the physical hedgers who make and use the commodity), Swap Dealers (the banks intermediating index and OTC exposure) and Other Reportables. The positioning endpoint returns, for a commodity, the full four-group breakdown — each group's long, short and net contracts, its share of open interest, the number of traders and the week-over-week change — with a managed-money bias read: Managed Money net long in gold of +112,179 contracts (34% of open interest, 74 funds long) tells you the funds are crowded long. The screener endpoint ranks a curated set of 20 metals, energy, grain, soft and livestock futures by where Managed Money is positioned (net as a share of open interest), surfacing the most crowded long and short hedge-fund bets. This is the disaggregated hedge-fund-positioning cut — distinct from the legacy raw COT-report feed, the normalised COT-Index, and the price and open-interest APIs. It is who the smart speculative money is, by the report traders actually read.

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/managedmoney-api/..."
```

## Pricing
- **Free** (Free) — 720 calls/Mo, 2 req/s
- **Starter** ($13/Mo) — 15,800 calls/Mo, 6 req/s
- **Pro** ($40/Mo) — 86,000 calls/Mo, 16 req/s
- **Mega** ($87/Mo) — 478,000 calls/Mo, 40 req/s

## Endpoints

### Positioning

#### `GET /v1/positioning` — Four-group disaggregated breakdown for one commodity

**Parameters:**
- `market` (query, required, string) — Commodity key (gold, wti, corn, sugar, ...) Example: `gold`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/managedmoney-api/v1/positioning?market=gold"
```

### Screener

#### `GET /v1/screener` — Rank commodities by Managed Money net positioning

**Parameters:**
- `sort` (query, optional, string) — net_pct (net as % of OI), net (contracts) or change Example: `net_pct`
- `class` (query, optional, string) — metal, energy, grain, soft, livestock or all Example: `all`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/managedmoney-api/v1/screener?sort=net_pct&class=all"
```

### Markets

#### `GET /v1/markets` — Supported commodity futures and CFTC codes

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/managedmoney-api/v1/markets"
```

### Meta

#### `GET /v1/meta` — Service metadata

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/managedmoney-api/v1/meta"
```


---
Marketplace page: https://www.oanor.com/api/managedmoney-api
OpenAPI spec: https://www.oanor.com/api/managedmoney-api/openapi.json