forex.com APIforex.com ↗
Access live forex prices, pivot points, client sentiment, economic calendar events, and rollover rates from FOREX.com via a single REST API.
curl -X GET 'https://api.parse.bot/scraper/f7008907-4ba2-4ad2-a866-43fa117143e4/get_currency_pair_price?pair=EUR+USD' \ -H 'X-API-Key: $PARSE_API_KEY'
Fetch the current indicative price (bid, offer, spread, direction) for a specific forex currency pair.
| Param | Type | Description |
|---|---|---|
| pair | string | Currency pair separated by space or slash (e.g. 'EUR USD', 'GBP/USD', 'USD JPY'). |
{
"type": "object",
"fields": {
"Bid": "string, current bid price",
"Offer": "string, current offer/ask price",
"Product": "string, formatted pair name (e.g. 'EUR/USD')",
"Direction": "string, price direction (e.g. 'UP', 'DOWN')",
"MedianSpread": "string, median spread in pips"
},
"sample": {
"data": {
"Bid": "1.17536",
"Offer": "1.17537",
"Product": "EUR/USD",
"Direction": "DOWN",
"MedianSpread": "0.1"
},
"status": "success"
}
}About the forex.com API
The FOREX.com API covers 7 endpoints that expose live currency pair prices, pivot point levels, client sentiment percentages, economic calendar events, and overnight rollover rates. The get_currency_pair_price endpoint returns bid, offer, spread, and price direction for any pair you query. Supporting endpoints cover popular pairs in bulk, instrument search across the FOREX.com US catalog, and daily/weekly/monthly pivot levels with S1–S3 and R1–R3 values.
Live Prices and Pair Lookup
The get_currency_pair_price endpoint accepts a pair parameter in flexible formats — space-separated (EUR USD), slash-delimited (GBP/USD), or fused — and returns four fields: Bid, Offer, Direction (UP or DOWN), and MedianSpread in pips. To pull prices for multiple major pairs at once without iterating, get_popular_currency_pairs returns the same four fields for each pair in a single response. For catalog discovery, search_instruments accepts any currency code (EUR, JPY, CHF, etc.) and returns matching instruments with title, description, url, pageType, and pageSubType, plus a total count.
Pivot Points and Technical Levels
get_pivot_points takes the same flexible pair input and returns a pivots array covering three periods: daily, weekly, and monthly. Each period object includes pivotPoint, high, low, close, lastUpdated, and all six support/resistance levels (S1, S2, S3, R1, R2, R3). The response also surfaces a decimals field indicating the precision for the pair, alongside the current bid and offer.
Sentiment, Calendar, and Rollover Rates
get_client_sentiment returns a rows array where each item holds underlying_name, long and short customer percentages (Long_Customer_PER, Short_Customer_PER), and long/short volume percentages (Long_VOL_PER, Short_VOL_PER) — useful for gauging positioning across major pairs. get_economic_calendar lists upcoming macro events with name, time, country, actual, consensus, previous, and volatility level. get_rollover_rates returns overnight swap rates as Bid and Offer per Product, covering major forex instruments.
Source and Coverage Notes
All endpoints reflect data from the FOREX.com US platform. Coverage is limited to forex instruments in that catalog; indices, commodities, and crypto listed elsewhere on FOREX.com are not included. The search_instruments endpoint works best with standard currency codes rather than full pair names.
- Display live bid/offer quotes and spread for a watchlist of forex pairs using
get_currency_pair_price. - Render a pivot point chart overlay with S1–S3 and R1–R3 levels from
get_pivot_pointsfor daily, weekly, and monthly timeframes. - Show a sentiment gauge widget using
Long_Customer_PERandShort_Customer_PERfromget_client_sentiment. - Build an economic event feed that surfaces
volatility,consensus, andactualvalues fromget_economic_calendar. - Display carry trade cost estimates using bid and offer rollover rates from
get_rollover_rates. - Populate a pair selector UI by searching available instruments via
search_instrumentswith currency codes. - Track spread changes across popular pairs over time using repeated calls to
get_popular_currency_pairs.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does FOREX.com have an official developer API?+
What does `get_client_sentiment` actually measure?+
get_client_sentiment returns the percentage of FOREX.com clients holding long versus short positions (Long_Customer_PER, Short_Customer_PER) and the corresponding volume-weighted percentages (Long_VOL_PER, Short_VOL_PER). It covers major forex pairs and reflects the platform's own client book — it is not aggregated from external sources.Does the economic calendar endpoint support date filtering or a specific time range?+
get_economic_calendar returns upcoming events without a date-range parameter — you get whatever events are currently listed on the FOREX.com calendar page. There is no from or to filter exposed. You can fork this API on Parse and revise it to add date-filtering logic or pagination over the calendar data.Are instruments outside forex covered — for example, indices or commodities listed on FOREX.com?+
How precise are the price values returned by `get_currency_pair_price`?+
Bid, Offer) at whatever precision FOREX.com publishes for the pair. The get_pivot_points endpoint separately returns a decimals integer that indicates the number of decimal places for that pair, which you can use to format price display consistently.