Pair history

One pair, over time, as an ordered array of points — the exact shape chart libraries want. USD-base pairs can include daily OHLC candles and day-over-day change.

GET /api/v1/pair-history

Available on: freedeveloperunlimited

Parameters

Parameter	Required	Description
from	required	Base side of the pair, e.g. USD.
to	required	Quote side of the pair, e.g. CAD.
start_date	required	Range start, YYYY-MM-DD.
end_date	required	Range end, YYYY-MM-DD (inclusive).
ohlc	optional	Set to 1 to include open/high/low and change_pct. USD-base pairs only.

Example — OHLC candles

Requestbash

curl "https://forex-feed.com/api/v1/pair-history?from=USD&to=CAD&start_date=2016-07-07&end_date=2016-07-08&ohlc=1" \
  -H "Authorization: Bearer ff_live_YOUR_KEY"

Responsejson

{
  "success": true,
  "data": {
    "from": "USD",
    "to": "CAD",
    "start_date": "2016-07-07",
    "end_date": "2016-07-08",
    "points": [
      { "date": "2016-07-07", "rate": 1.300204, "open": 1.296664,
        "high": 1.301999, "low": 1.287797, "change_pct": null },
      { "date": "2016-07-08", "rate": 1.304087, "open": 1.300238,
        "high": 1.308986, "low": 1.298887, "change_pct": 0.002986 }
    ]
  },
  "meta": { "count": 2, "plan": "unlimited" }
}

Notes

• Without ohlc, points are { date, rate } and any pair works — cross rates (e.g. EUR→CAD) are derived per date.
• ohlc=1 requires from=USD: a cross pair's true intraday high/low can't be derived from two separate series, so we refuse to fake it.
• change_pct is fractional (0.0123 = +1.23%) vs the previous stored close.
• A full 10-year request returns ~2,600 points on the Unlimited plan.