Time series

Returns daily rates for every trading day in a range, keyed by date — drop it straight into a chart library or a dataframe.

GET /api/v1/timeseries

Available on: freedeveloperunlimited

Parameters

Parameter	Required	Description
start_date	required	Range start, YYYY-MM-DD.
end_date	required	Range end, YYYY-MM-DD (inclusive).
base	optional	Base currency (default USD).
symbols	optional	Comma-separated filter. Required for ranges over 366 days.

Range limits

• Developer: up to 366 days per request, within your 1-year window.
• Unlimited: up to 3,660 days (10 years) per request.
• For multi-year ranges, pass an explicit symbols list.

Example

Requestbash

curl "https://forex-feed.com/api/v1/timeseries?base=USD&symbols=CAD,EUR&start_date=2026-07-01&end_date=2026-07-08" \
  -H "Authorization: Bearer ff_live_YOUR_KEY"

Responsejson

{
  "success": true,
  "data": {
    "base": "USD",
    "start_date": "2026-07-01",
    "end_date": "2026-07-08",
    "rates": {
      "2026-07-01": { "CAD": 1.4212, "EUR": 0.8779 },
      "2026-07-02": { "CAD": 1.4198, "EUR": 0.8771 },
      "2026-07-07": { "CAD": 1.4205, "EUR": 0.8768 },
      "2026-07-08": { "CAD": 1.4169, "EUR": 0.8756 }
    }
  },
  "meta": { "days": 4, "plan": "developer" }
}

Notes

• Non-trading days are absent from rates — carry the last value forward client-side if your chart needs a continuous line.
• meta.days is the number of trading days returned.
• For a single pair with OHLC candles, pair-history is more efficient.