Skip to main content

​
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

NameTypeRequiredDescription
pairstringNoForex pair to filter, e.g. EURUSD. Returns all instruments if omitted.
start_datestringNoStart date in ISO 8601 format
end_datestringNoEnd date in ISO 8601 format
limitintegerNoNumber of records (default: 100, max: 500)
cursorstringNoPagination 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"

​
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

FieldDescription
instrumentStandardised pair symbol
dateReport date (always a Tuesday reference date)
long_positionsTotal non-commercial long contracts
short_positionsTotal non-commercial short contracts
net_positionsNet positioning (long − short)
open_interestTotal open contracts
change_longWeek-over-week change in long positions
change_shortWeek-over-week change in short positions