Coverage
What you get
| Item | Detail |
|---|---|
| Product code | FX-SENTIMENT |
| Coverage | Major and minor pairs, as far as a partner broker's client book covers them |
| Granularity | Snapshots, planned every few minutes |
| History | Depends on what the partner has kept; no seller we studied publishes its depth |
| Delivery | REST snapshots |
| Update speed | Per snapshot interval |
Spot FX has no central exchange and no public volume or open interest. Futures traders get the CFTC's weekly Commitments of Traders report. Spot traders get nothing official. The nearest thing is a broker telling you how its own clients are positioned. That's one broker's clients, not the market, and it's worth remembering every time you read a number like 62% long.
Schema
Schema
| Field | Type | Required | Description |
|---|---|---|---|
symbol |
string | yes | Pair, e.g. EURUSD |
timestamp |
string | yes | Snapshot time, ISO 8601 UTC |
source |
string | yes | Broker or venue the positions come from |
long_pct |
number | yes | Percent of positions long |
short_pct |
number | yes | Percent of positions short |
price |
number | optional | Price at snapshot time |
buckets |
array | optional | Price-bucket breakdown: price, long_pct, short_pct |
Example record:
{
"symbol": "EURUSD",
"timestamp": "2026-11-19T14:30:00Z",
"source": "broker_a",
"long_pct": 62.4,
"short_pct": 37.6,
"price": 1.09715,
"buckets": [
{ "price": 1.0970, "long_pct": 0.84, "short_pct": 0.31 },
{ "price": 1.0975, "long_pct": 0.22, "short_pct": 0.57 }
]
}
Every number here is an example, including the exchange rate. source names the broker the snapshot came from; broker_a is a placeholder.
Sample data
Sample data
There's no sample, free or paid, because there's no source yet. Leave your pairs and preferred snapshot interval on the request form and we'll use it when we talk to brokers.
Use cases
Use cases
Contrarian filter. A common retail-sentiment rule is to lean against the crowd when long_pct goes above 70 or below 30. Test it on your own pairs before trusting it; it works in ranges and fails in trends.
Stop clusters. The buckets array shows how positions spread across price. Heavy long_pct in buckets just above the current price means many longs are underwater there, and their stops likely sit not far below.
Change in positioning. A single reading tells you little. The change in long_pct over a day, compared with how far price moved, shows whether retail traders are chasing or fading the move.
Session effects. Compare snapshots at the London open (08:00 UTC in winter) with the New York close to see how positioning shifts across a trading day.
Code
Code examples
Example: the latest EURUSD snapshot with curl.
curl "https://api.marketdata.co/v1/forex/sentiment?symbol=EURUSD" \
-H "Authorization: Bearer $MARKETDATA_API_KEY"
Example: Python, daily change in long percentage next to price.
import os
import requests
import pandas as pd
resp = requests.get(
"https://api.marketdata.co/v1/forex/sentiment",
params={"symbol": "EURUSD", "start": "2026-10-01", "end": "2026-11-19"},
headers={"Authorization": f"Bearer {os.environ['MARKETDATA_API_KEY']}"},
)
resp.raise_for_status()
s = pd.DataFrame(resp.json()["results"])
s["timestamp"] = pd.to_datetime(s["timestamp"])
daily = s.set_index("timestamp")[["long_pct", "price"]].resample("1D").last()
daily["long_pct_change"] = daily["long_pct"].diff()
daily["price_change_pips"] = daily["price"].diff() * 10000
print(daily.dropna().tail(10))
Pricing
Pricing
Forex sentiment is not offered at launch and has no price yet. If a broker partner shares positioning data, we plan to include it in Pro at $79/mo. It won't be sold as a dataset.
No vendor we studied sells this at a self-serve price. It's either a free widget on a broker's website or available by quote.
Side by side
How we compare
3 of the 50 providers we studied offer forex positioning or sentiment, and all of them are brokers or broker-linked, publishing data about their own clients. None sells it with a price on the page. If we add it, the source field will always name where the numbers came from, history will be downloadable, and the schema will match our other forex data.
FAQ
Frequently asked questions
Is this the whole FX market's positioning?
No. It reflects the clients of whichever broker supplies it. Treat it as a sample of retail traders, not the market.
Why isn't it available now?
Because we don't have a source. Brokers own this data, and we'll only list it once one agrees to share.
What time zone are snapshots in?
UTC. Spot FX trades from Sunday evening to Friday evening, and snapshots would follow that week.
Is it real-time?
It would be near real time, as snapshots every few minutes. No tick-by-tick sentiment feed exists.
How is it different from the COT report?
The COT report covers currency futures on US exchanges and comes out weekly. Broker sentiment covers spot positions at one broker and updates within the day.
What formats would it come in?
JSON snapshots from the REST API. Bulk files would follow if there's enough history.
Keep reading
Related
- Asset hub: Forex
- Forex: EUR/USD, GBP/USD, USD/JPY, USD/CHF, AUD/USD, USD/CAD
- Docs: API reference: forex
- Learn: Forex sessions and spreads, COT report explained