FPRates API

GET /api/rates/<region>

Returns the current 48 half-hourly slots for the specified region, ordered most recent first.

Example: /api/rates/G

[
  {
    "slot_time_utc": "2026-06-13T22:00:00Z",
    "fp_rate": 0.6699,
    "cost_price": 0.6699,
    "period_class": "table-warning",
    "source": "edf"
  },
  ...
]

GET /api/rates/<region>/best

Returns the cheapest N slots of the day, sorted by price ascending. Free (0p) slots always appear first. Ideal for scheduling battery charging.

Parameter: slots — number of half-hour slots to return (default: 8 = 4 hours)

Example: /api/rates/G/best?slots=8

[
  {
    "slot_time_utc": "2026-06-13T11:00:00Z",
    "fp_rate": 0.0,
    "cost_price": 0.0,
    "period_class": "table-warning",
    "source": "edf"
  },
  ...
]

GET /api/rates/<region>/history

Returns all stored half-hourly slots for a specific date, ordered chronologically.

Parameter: date — date in YYYY-MM-DD format (required)

Example: /api/rates/G/history?date=2026-06-12

[
  {
    "slot_time_utc": "2026-06-12T00:00:00Z",
    "fp_rate": 7.53,
    "cost_price": 7.53,
    "period_class": "table-success",
    "source": "edf"
  },
  ...
]

GET /api/rates/<region>/download

Downloads a CSV file of all stored half-hourly slots for a specific date.

Parameter: date — date in YYYY-MM-DD format (required)

Example: /api/rates/G/download?date=2026-06-12