Forex Factory Market & Broker Spreads

Clean, structured quotes from Forex Factory — the live bid/ask every broker publishes for a pair, in one record per broker. Compare spreads across 100+ brokers, or snapshot the market for any currency or crypto pair. Pure HTTP: no browser, no login, no proxy.

What you get

One record per broker per pair:

Field	Meaning
instrument	The pair, e.g. EUR/USD
broker	The broker's code on Forex Factory, e.g. ADM, CMC, IC Markets
bid / ask	The broker's latest published prices
spread	ask - bid in the pair's native units (0.00003 = 0.3 pips on EURUSD)
timestamp	When that quote was published (ISO 8601, UTC)
ageMinutes	How old the quote is — brokers that stopped reporting keep their last price, so this tells you who is live

Records are sorted by spread, tightest first.

How to use

Currency pairs — put pairs into Currency pairs, one per line: EURUSD, GBPUSD, USDJPY, exotics like USDTRY or USDZAR, crypto BTCUSD / ETHUSD. Forex majors and exotics carry ~100-160 brokers each; crypto pairs ~30-40.

Only quotes newer than (hours) — set e.g. 24 for a daily snapshot that keeps only brokers actually reporting in the last day. Leave 0 to keep everything, including stale quotes.

Leave every input empty for a default EURUSD sample.

Example output

{
  "type": "quote",
  "instrument": "EUR/USD",
  "broker": "ADM",
  "bid": 1.12046,
  "ask": 1.12046,
  "spread": 0.0,
  "timestamp": "2026-10-12T07:29:24+00:00",
  "ageMinutes": 2
}

Typical runs

• Broker spread comparison — one pair, maxAgeHours 24, run daily to see which brokers are tightest today.
• Market snapshot — all majors at once for a pricing reference.
• Broker monitoring — a watchlist of pairs, tracking which brokers report and which go stale.

Notes

• Indices and commodities (US30, XAUUSD) are not available on Forex Factory's market pages — currency and crypto pairs only.
• Quotes come from the same page Forex Factory's own spread comparison uses; values are passed through unchanged.
• Runs are one request per pair, throttled and parallelised — a handful of pairs takes seconds.

Local development

pip install -r requirements.txt
python3 -m src --pairs EURUSD,GBPUSD --max-age 24
python3 -m src --pairs BTCUSD --json