Coverage
What you get
| Item | Detail |
|---|---|
| Product code | FX-LATEST |
| Coverage | Major, minor and exotic currency pairs, in our EURUSD format |
| Granularity | Latest quote per pair, millisecond timestamps |
| History | None, this is latest-only. For history see historical exchange rates |
| Delivery | REST on every plan; WebSocket stream from Pro |
| Update speed | Hourly on Free, real time from Starter |
What you're really choosing between rate APIs is update speed. Free ones refresh hourly, which is fine for an invoice and useless for a trading screen. Ours gives you hourly mid rates for free and real-time bid and ask from $29, with is_delayed on every record so your code knows which one it got.
Schema
Schema
| Field | Type | Required | Description |
|---|---|---|---|
symbol |
string | yes | Pair in our format, e.g. EURUSD |
base_currency |
string | yes | ISO 4217 code of the first currency, e.g. EUR |
quote_currency |
string | yes | ISO 4217 code of the second currency, e.g. USD |
timestamp |
string | yes | Time of the quote, ISO 8601 UTC, millisecond precision |
bid |
number | yes | Best bid |
ask |
number | yes | Best ask |
mid |
number | yes | (bid + ask) / 2; the "rate" most apps show |
spread |
number | optional | ask minus bid |
day_open |
number | optional | First mid of the trading day |
day_high |
number | optional | Highest mid of the day |
day_low |
number | optional | Lowest mid of the day |
change |
number | optional | mid minus previous day close |
change_pct |
number | optional | change as a percent of previous close |
is_delayed |
boolean | optional | true when the plan gets delayed data |
The convert call returns the same record plus amount (the amount you sent) and converted_amount (amount times mid).
Example record:
{
"symbol": "EURUSD",
"base_currency": "EUR",
"quote_currency": "USD",
"timestamp": "2026-11-19T14:32:07.412Z",
"bid": 1.09712,
"ask": 1.09718,
"mid": 1.09715,
"spread": 0.00006,
"day_open": 1.09668,
"day_high": 1.09802,
"day_low": 1.09597,
"change": 0.00035,
"change_pct": 0.032,
"is_delayed": false
}
Sample data
Sample data
The live feed isn't public yet, but you can download real daily reference rates now. This sample has 60 business days of European Central Bank euro rates against USD, GBP, JPY, CHF, AUD, CAD, CNY and INR: 480 rows. First 10:
date |
base |
quote |
pair |
rate |
|---|---|---|---|---|
| 2026-11-18 | EUR | USD | EURUSD | 1.0968 |
| 2026-11-18 | EUR | GBP | EURGBP | 0.8329 |
| 2026-11-18 | EUR | JPY | EURJPY | 174.85 |
| 2026-11-18 | EUR | CHF | EURCHF | 0.9243 |
| 2026-11-18 | EUR | AUD | EURAUD | 1.6294 |
| 2026-11-18 | EUR | CAD | EURCAD | 1.569 |
| 2026-11-18 | EUR | CNY | EURCNY | 7.3126 |
| 2026-11-18 | EUR | INR | EURINR | 102.4905 |
| 2026-11-17 | EUR | USD | EURUSD | 1.0989 |
| 2026-11-17 | EUR | GBP | EURGBP | 0.83305 |
Source: European Central Bank
These are once-a-day official fixings, the same values the free tier of the daily product serves. They show our field style; the live API adds bid, ask, mid and a UTC timestamp.
Use cases
Use cases
Multi-currency checkout. Call convert with the cart total and the shopper's currency, show converted_amount, and store timestamp with the order so you can prove which rate you used.
Trading dashboards. bid, ask and spread per pair let you see when liquidity thins, for example around the daily rollover at 17:00 New York time, when spreads on most pairs widen for a few minutes.
Portfolio valuation. Pull mid for every currency you hold positions in and revalue the book in your home currency on each refresh.
Rate alerts. Poll a handful of pairs and fire when change_pct crosses a threshold. On Pro, subscribe to the WebSocket stream instead of polling.
Code
Code examples
Example: latest EUR/USD quote.
curl "https://api.marketdata.co/v1/forex/latest?symbols=EURUSD" \
-H "Authorization: Bearer $MARKETDATA_API_KEY"
Example: convert 250 EUR to USD in Python, then load several pairs into pandas.
import os
import requests
import pandas as pd
headers = {"Authorization": f"Bearer {os.environ['MARKETDATA_API_KEY']}"}
conv = requests.get(
"https://api.marketdata.co/v1/forex/convert",
params={"from": "EUR", "to": "USD", "amount": 250},
headers=headers,
).json()
print(conv["converted_amount"], conv["mid"], conv["timestamp"])
rates = requests.get(
"https://api.marketdata.co/v1/forex/latest",
params={"symbols": "EURUSD,GBPUSD,USDJPY,USDCHF,AUDUSD,USDCAD"},
headers=headers,
).json()["results"]
print(pd.DataFrame(rates)[["symbol", "bid", "ask", "mid", "is_delayed"]])
Pricing
Pricing
| Plan | Forex rates |
|---|---|
| Free, $0 | Hourly mid rates for all pairs, 1,000 calls a day |
| Starter, $29/mo | Real-time bid, ask and mid by REST, convert, 60 calls a minute |
| Pro, $79/mo | Adds the WebSocket stream |
| Business, $249/mo | Commercial internal use |
Public display and redistribution are Enterprise. Latest rates aren't sold as a dataset. Prices are early access and may change.
Across the 17 rate providers we studied, many have a free tier. Paid plans run from $12 to $450 a month, median $30, and one forex specialist starts at £149 a month.
Side by side
How we compare
17 of the 50 providers we studied sell latest FX rates, more than any other forex product. The cheap rate APIs charge extra for bid and ask and refresh every few minutes at best; the market-data vendors are real time but rarely do conversion. We do both at $29, show the price on this page, and use the same pair symbol as our tick, bar and daily FX data.
FAQ
Frequently asked questions
How fresh is a "real-time" rate?
On Starter and above, each record carries the timestamp of the quote to the millisecond, so you can see exactly how old it is. Free plan rates are refreshed hourly.
Which pairs do you cover?
Majors and minors, plus the exotic currencies our source feed carries; the full list will be in the docs at launch. Pairs are written as six letters with no separator: EURUSD, USDJPY, GBPCHF.
Is the mid rate the same as the bank rate?
No. Our mid is halfway between the market bid and ask. Banks and card networks add their own margin, so your statement rate will differ.
Do rates update at weekends?
Spot FX trades from Sunday evening to Friday evening New York time. Over the weekend the last Friday quote stands and timestamp stays put.
Can I show the rates on my website?
Public display needs an Enterprise licence. Internal commercial use, such as pricing your own invoices, starts at Business.
What format does the API return?
JSON by default, with CSV available on request. Prices are numbers, not strings.
Keep reading
Related
- Asset hub: Forex
- Pairs: EUR/USD, GBP/USD, USD/JPY, USD/CHF, AUD/USD, USD/CAD
- Docs: API reference: forex
- Learn: Forex sessions and spreads