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/historicalAvailable on: freedeveloperunlimited
Parameters
| Parameter | Required | Description |
|---|---|---|
| date | required | The date, YYYY-MM-DD. Must fall inside your plan's history window. |
| base | optional | Base currency (default USD). |
| symbols | optional | Comma-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
timeserieswhich 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).