Historical rates

Returns all rates for a single date. Data covers roughly ten years of daily closes back to July 2016; how far back you can query depends on your plan: 30 days (Free), 1 year (Developer), or the full range (Unlimited).

GET /api/v1/historical

Available on: freedeveloperunlimited

Parameters

ParameterRequiredDescription
daterequiredThe date, YYYY-MM-DD. Must fall inside your plan's history window.
baseoptionalBase currency (default USD).
symbolsoptionalComma-separated filter, e.g. symbols=CAD,EUR.

Example

Requestbash
curl "https://forex-feed.com/api/v1/historical?date=2016-07-07&symbols=CAD,EUR" \
  -H "Authorization: Bearer ff_live_YOUR_KEY"
Responsejson
{
  "success": true,
  "data": {
    "date": "2016-07-07",
    "base": "USD",
    "rates": { "CAD": 1.300204, "EUR": 0.90403 }
  },
  "meta": { "plan": "unlimited" }
}

Notes

  • • Weekends and market holidays have no rows — request the prior trading day, or use timeseries which simply skips missing days.
  • • Dates outside your plan window return date_out_of_plan_range (403) with the earliest date you can access.
  • • Dates with no stored data return no_data (404).