---
title: "Futures Positioning History"
method: GET
path: "/futures-positioning"
tags: ["Futures Positioning"]
---

# Futures Positioning History

`GET /futures-positioning`

## Request

- Base URL: `https://api.dataporium.io`
- URL: `https://api.dataporium.io/futures-positioning`
- Auth: API key in query parameter `apikey`

Weekly futures positions by type of trader for one US futures market, from official public data: the net position (long minus short contracts) of every trader group, its weekly change and its share of open interest, as of each Tuesday since 1986. Futures only; options are not included.

The answer is {market, report, categories, view, filters, total, limit, offset, order, rows, as_of, about}. Before the first data load the answer has note: "Data is being prepared" and no rows.

## Query parameters

- `market` string, required
- `report` string
- `category` string
- `view` string
- `from` string
- `to` string
- `order` string
- `with_predecessor` boolean
- `limit` integer
- `offset` integer

## Response `200`

Successful response (JSON).

- object

## Other responses

- `401`: No API key in the request.
- `403`: The API key is not valid or has expired.

---

[API](https://skmtc.dev/dataporium/apis/dataporium-data-api.md) · [All operations](https://skmtc.dev/dataporium/apis/dataporium-data-api/llms.txt) · [OpenAPI document](https://skmtc.dev/dataporium/apis/dataporium-data-api/revisions/8bc593179dc8?raw)