---
title: "Get the radar desk's live readings"
method: GET
path: "/api/v1/grid/radar"
tags: ["Grid"]
---

# Get the radar desk's live readings

`GET /api/v1/grid/radar`

## Request

- Base URL: `https://askthegrid.com`
- URL: `https://askthegrid.com/api/v1/grid/radar`
- Auth: HTTP bearer

Every live figure the Radar cockpit draws for one market on a single call - prices, load, fuel mix, reserves, frequency, and the status each reading carries.

## Query parameters

- `iso` union
  - ''
  - string

## Response `200`

Success

- object
  - `stats` object, required
    - `load` number, nullable, required
    - `netLoad` number, nullable, required
    - `price` number, nullable, required
    - `priceCurrency` 'USD' | 'CAD' | 'MXN'
    - `priceLabel` string
    - `totalGen` number, nullable, required
    - `mainSource` string, nullable, required
    - `sourceAsOf` object, required
      - `load` string, nullable, required
      - `fuelMix` string, nullable, required
      - `price` string, nullable, required
    - `netLoadInputSkewMinutes` number, nullable, required
    - `asOf` string, nullable, required
    - `areaControlError` object, nullable
      - `mw` number, required
      - `asOf` string, nullable, required
  - `fuelMix` object, nullable, required
    - `fuels` object[], required
      - `key` string, required
      - `label` string, required
      - `mw` number, required
    - `totalGen` number, required
    - `asOf` string, nullable, required
  - `hubs` object[], required
    - `id` string, required
    - `name` string, required
    - `price` number, required
    - `asOf` string, nullable, required
    - `spark` number[]
  - `zones` object[], required
    - `id` string, required
    - `name` string, required
    - `price` number, required
    - `asOf` string, nullable, required
    - `spark` number[]
  - `constraints` object[], required
    - `name` string, required
    - `identityKey` string
    - `interconnect` string, nullable
    - `displayName` string
    - `contingency` string, nullable, required
    - `facility` string, nullable, required
    - `shadowPrice` number, required
    - `valueMw` number, nullable, required
    - `limitMw` number, nullable, required
    - `violationMw` number, nullable
    - `breached` boolean, nullable
    - `penaltyCurve` number[], nullable
    - `asOf` string, nullable, required
  - `dcTies` object[], required
    - `id` string, required
    - `name` string, required
    - `counterparty` string, required
    - `price` number, required
  - `dcTieFlow` object[], required
    - `marketRun` 'rt_5min' | 'da_hourly', required
    - `dcTieName` string, required
    - `direction` string, nullable, required
    - `mw` number, nullable, required
    - `shadowPrice` number, nullable, required
    - `asOf` string, nullable, required
    - `matchedEntityId` string, nullable, required
    - `candidateCount` number, required
  - `desks` object, nullable, required
    - `tvaOperations` object
      - `reservoirs` object[], required
        - `id` string, required
        - `name` string, required
        - `latitude` number, nullable, required
        - `longitude` number, nullable, required
        - `ownership` string, required
        - `damType` string, required
        - `river` string, required
        - `observation` object, nullable, required
          - `asOf` string, required
          - `elevationFt` number, nullable, required
          - `tailwaterFt` number, nullable, required
          - `dischargeCfs` number, nullable, required
          - `collectedAt` string, required
        - `hours` object[]
          - `ts` string, required
          - `elevationFt` number, nullable, required
          - `tailwaterFt` number, nullable, required
          - `dischargeCfs` number, nullable, required
        - `forecasts` object[], required
          - `day` string, required
          - `inflowCfs` number, nullable, required
          - `elevationFt` number, nullable, required
          - `outflowCfs` number, nullable, required
          - `collectedAt` string, required
        - `releases` object[], required
          - `day` string, required
          - `time` string, required
          - `generators` string, required
          - `collectedAt` string, required
        - `notice` object, nullable, required
          - `effectiveSince` string, required
          - `message` string, required
      - `reactors` object[], required
        - `unit` string, required
        - `powerPercent` number, required
        - `reportDay` string, required
        - `collectedAt` string, required
      - `queue` object[], required
        - `id` string, required
        - `requestType` string, required
        - `county` string, required
        - `state` string, required
        - `pointOfInterconnection` string, required
        - `service` string, nullable, required
        - `phase` string, required
        - `summerMw` number, nullable, required
        - `winterMw` number, nullable, required
        - `springFallMw` number, nullable, required
        - `queueDate` string, required
        - `forecastedIsd` string, nullable, required
        - `generatorType` string, required
        - `publication` string, required
        - `collectedAt` string, required
        - `sourceUrl` string, required
      - `outages` object[], required
        - `kind` 'line' | 'transformer', required
        - `id` string, required
        - `name` string, required
        - `startLabel` string, required
        - `stopLabel` string, required
        - `status` string, required
        - `notes` string, nullable, required
        - `collectedAt` string, required
        - `sourceUrl` string, required
    - `ancillary` object[], required
      - `type` string, required
      - `price` number, required
    - `storage` object, nullable, required
      - `charging` number, required
      - `discharging` number, required
      - `net` number, required
    - `outages` object, nullable, required
      - `total` number, required
      - `thermal` number, required
      - `iru` number, required
      - `components` object[]
        - `label` string, required
        - `mw` number, required
      - `asOf` string, nullable
    - `ruc` object, nullable, required
      - `total` number, required
      - `north` number, required
      - `south` number, required
      - `west` number, required
      - `houston` number, required
    - `wind` object, nullable, required
      - `actual` number, required
      - `forecast` number, required
      - `byZone` object[], required
        - `zone` string, required
        - `actual` number, required
    - `solar` object, nullable, required
      - `actual` number, required
      - `forecast` number, required
    - `weatherZones` object[], required
      - `zone` string, required
      - `temp` number, required
    - `systemCondition` object, nullable
      - `area` string, required
      - `condition` string, required
      - `action` string, nullable, required
      - `asOf` string, nullable, required
    - `zoneLoads` object[]
      - `id` string, required
      - `name` string, required
      - `actualMw` number, nullable, required
      - `forecastMw` number, nullable, required
      - `asOf` string, nullable, required
    - `externalInterfaces` object[]
      - `id` string, required
      - `name` string, required
      - `actualMw` number, nullable, required
      - `scheduledMw` number, nullable, required
      - `importLimitMw` number, nullable, required
      - `exportLimitMw` number, nullable, required
      - `importHeadroomMw` number, nullable, required
      - `exportHeadroomMw` number, nullable, required
      - `asOf` string, nullable, required
      - `publishedBy` string
      - `stepMinutes` number
      - `intertie` string
      - `seamPrice` object, nullable
        - `iso` string, required
        - `label` string, required
        - `price` number, nullable, required
        - `currency` 'USD' | 'CAD' | 'MXN', required
        - `asOf` string, nullable, required
    - `resourceAdequacy` object, nullable
      - `availableCapacityMw` number, required
      - `peakLoadMw` number, required
      - `surplusMw` number, required
      - `tenMinuteReserveMw` number, nullable, required
      - `thirtyMinuteReserveMw` number, nullable, required
      - `plannedOutageMw` number, nullable, required
      - `forcedOutageMw` number, nullable, required
      - `largestContingencyMw` number, nullable
      - `expectedOp4Actions` number, nullable
      - `asOf` string, nullable, required
    - `caisoSchedule` object, nullable
      - `generationMw` number, required
      - `importsMw` number, required
      - `exportsMw` number, required
      - `netSupplyMw` number, required
      - `asOf` string, nullable, required
    - `caisoMarketInputs` object, nullable
      - `gasPricePerMmbtu` number, nullable, required
      - `ghgAllowancePerTonne` number, nullable, required
      - `asOf` string, nullable, required
    - `caisoCurtailment` object, nullable
      - `publishedAt` string, required
      - `eventCount` number, required
      - `resourceCount` number, required
      - `curtailedMw` number, required
      - `plannedMw` number, required
      - `forcedMw` number, required
      - `reasons` object[], required
        - `label` string, required
        - `eventCount` number, required
        - `curtailedMw` number, required
    - `operatingMetrics` object, nullable
      - `areaControlErrorMw` number, nullable, required
      - `actualInterchangeMw` number, nullable, required
      - `scheduledInterchangeMw` number, nullable, required
      - `regionalTransferMw` number, nullable, required
      - `northSouthLimitMw` number, nullable, required
      - `southNorthLimitMw` number, nullable, required
      - `asOf` string, nullable, required
    - `systemFrequency` object, nullable
      - `frequencyHz` number, required
      - `deviationMhz` number, required
      - `inertiaMwS` number, nullable, required
      - `timeErrorSeconds` number, nullable, required
      - `baalExceedanceMinutes` number, nullable, required
      - `nominalHz` number, required
      - `controlBandHz` number, required
      - `asOf` string, nullable, required
      - `trace` object[], required
        - `ts` string, required
        - `hz` number, required
      - `inertiaTrace` object[], required
        - `ts` string, required
        - `hz` number, required
    - `reliabilityAdder` object, nullable
      - `rtrdpa` number, required
      - `asOf` string, nullable, required
    - `asCapability` object, nullable
      - `capabilities` object[], required
        - `type` string, required
        - `mw` number, required
      - `asOf` string, nullable, required
    - `sppInterchange` object, nullable, required
      - `scheduledMw` number, nullable, required
      - `actualMw` number, nullable, required
      - `asOf` string, nullable, required
      - `futureMw` number, nullable, required
      - `futureAsOf` string, nullable, required
    - `balancingReserves` object, nullable
      - `deployedMw` number, required
      - `incMaxMw` number, nullable, required
      - `decMaxMw` number, nullable, required
      - `eimStatus` number, nullable, required
      - `oversupplyState` number, nullable, required
      - `controlState` number, nullable, required
      - `history` object[], required
        - `ts` string, required
        - `value` number, required
      - `asOf` string, nullable, required
    - `hydroProjects` object[]
      - `id` string, required
      - `name` string, required
      - `outflowKcfs` number, nullable, required
      - `spillKcfs` number, nullable, required
      - `forebayFt` number, nullable, required
      - `outflowM3s` number, nullable
      - `turbinedM3s` number, nullable
      - `spillM3s` number, nullable
      - `asOf` string, nullable, required
    - `waterSupply` object, nullable
      - `forecast` object, nullable, required
        - `pointId` string, required
        - `pointName` string, required
        - `period` string, required
        - `waterYear` number, required
        - `issuedDate` string, required
        - `medianKaf` number, nullable, required
        - `medianPctAverage` number, nullable, required
        - `dryKaf` number, nullable, required
        - `wetKaf` number, nullable, required
      - `snowpack` object, nullable, required
        - `date` string, required
        - `stations` number, required
        - `pctMedian` number, nullable, required
  - `asOf` string, nullable, required

## Other responses

- `400`: The request did not match the contract.
- `401`: Missing or invalid credentials.
- `429`: Rate limit exceeded. Wait `Retry-After` seconds; `X-RateLimit-Limit`, `X-RateLimit-Remaining` and `X-RateLimit-Reset` report the budget. Signed-in sessions and API keys have larger budgets than anonymous callers.

---

[API](https://skmtc.dev/askthegrid/apis/ask-the-grid-api.md) · [All operations](https://skmtc.dev/askthegrid/apis/ask-the-grid-api/llms.txt) · [OpenAPI document](https://skmtc.dev/askthegrid/apis/ask-the-grid-api/revisions/9cd80115e395?raw)