API quickstart

Five-minute version of the docs. Full Mintlify-driven reference lands in v1.1.

1. Get a key

Sign in, go to Settings → API keys, create one. Keys start with ff_live_ for production or ff_test_ for test.

2. Call the API

curl https://data.gridcertainty.com/v1/datasets/lmp/data \
  -H "Authorization: Bearer ff_live_..." \
  -G \
  -d "settlement_point=HB_HOUSTON" \
  -d "start=2026-05-08T00:00:00Z" \
  -d "end=2026-05-09T00:00:00Z"

3. Stream as Parquet

curl https://data.gridcertainty.com/v1/datasets/lmp/data \
  -H "Authorization: Bearer ff_live_..." \
  -H "Accept: application/x-parquet" \
  -G \
  -d "start=..." -d "end=..." \
  -o lmp.parquet

4. Read the freshness header

Every time-series response carries an x-gcd-freshness header with the JSON { asOf, expectedCadenceSeconds, isStale }. Treat any isStale: true as a soft warning to the user — do not silently render stale data.