> ## Documentation Index
> Fetch the complete documentation index at: https://docs.marketdataset.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# GET /forex/cot-reports

> CFTC Commitments of Traders reports for forex instruments

## Endpoint

```
GET https://api.marketdataset.ai/forex/cot-reports
```

The COT report is released every Friday by the CFTC and shows speculative positioning from institutional (non-commercial) traders. It's a widely-used sentiment indicator in forex markets.

## Parameters

| Name         | Type    | Required | Description                                                              |
| ------------ | ------- | -------- | ------------------------------------------------------------------------ |
| `pair`       | string  | No       | Forex pair to filter, e.g. `EURUSD`. Returns all instruments if omitted. |
| `start_date` | string  | No       | Start date in ISO 8601 format                                            |
| `end_date`   | string  | No       | End date in ISO 8601 format                                              |
| `limit`      | integer | No       | Number of records (default: `100`, max: `500`)                           |
| `cursor`     | string  | No       | Pagination cursor                                                        |

## Credit cost

**\$0.020** per request

## Example request

<CodeGroup>
  ```bash cURL theme={null}
  curl "https://api.marketdataset.ai/forex/cot-reports?pair=EURUSD&limit=5" \
    -H "X-API-KEY: sk_your_key"
  ```

  ```python Python theme={null}
  import requests

  response = requests.get(
      "https://api.marketdataset.ai/forex/cot-reports",
      params={"pair": "EURUSD", "limit": 5},
      headers={"X-API-KEY": "sk_your_key"},
  )
  print(response.json())
  ```
</CodeGroup>

## Example response

```json theme={null}
{
  "cot_reports": [
    {
      "instrument": "EURUSD",
      "date": "2024-10-29",
      "long_positions": 198432,
      "short_positions": 112847,
      "net_positions": 85585,
      "open_interest": 687234,
      "change_long": 12341,
      "change_short": -4523
    }
  ],
  "next_page_url": null,
  "meta": {
    "request_id": "req_abc123",
    "credits_used": 0.02,
    "credits_remaining": 49.98
  }
}
```

## Fields

| Field             | Description                                   |
| ----------------- | --------------------------------------------- |
| `instrument`      | Standardised pair symbol                      |
| `date`            | Report date (always a Tuesday reference date) |
| `long_positions`  | Total non-commercial long contracts           |
| `short_positions` | Total non-commercial short contracts          |
| `net_positions`   | Net positioning (long − short)                |
| `open_interest`   | Total open contracts                          |
| `change_long`     | Week-over-week change in long positions       |
| `change_short`    | Week-over-week change in short positions      |