CFTC futures positioning: long, short and net by trader classification
get_positioningUse this when the question is how index futures positioning is distributed across trader classifications: dealers and intermediaries, asset managers, leveraged funds, other reportables and nonreportables, with long, short, spreading and net contracts and the week history. Omit the contract to list the published pages. Coverage: the CFTC Traders in Financial Futures futures-only report for the index futures SquawkFlow publishes a page for. Weekly US government data, not a market feed. Not for: options positioning or dealer gamma (get_gex_levels); commodity futures, which this server does not publish; any reading of the session in progress. Limits: positions are held as of the stated Tuesday and published the following Friday afternoon, so this is a weekly picture that is three days old by construction. Net is long minus short in contracts, an arithmetic difference between two published counts, not a sentiment reading. Contract markets with different index multipliers are never added together.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "get_positioning"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| weeks | No | Weekly readings of history to return, 1 to 52, oldest first. | |
| contract | No | A published page slug, for example sp500 or nasdaq100. Omit to list the pages. An unknown slug returns the list, never a similar page. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| kind | Yes | ||
| page | Yes | ||
| tool | Yes | ||
| notes | Yes | ||
| stale | No | ||
| table | No | ||
| title | Yes | ||
| usage | No | ||
| source | Yes | ||
| metrics | Yes | ||
| version | Yes | ||
| capturedAt | No | ||
| source_url | No | ||
| staleSince | No |