GET /forex/cot-reports - MarketDataset

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

curl "https://api.marketdataset.ai/forex/cot-reports?pair=EURUSD&limit=5" \
  -H "X-API-KEY: sk_your_key"

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())

Example response

{
  "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