Brazil ONS (Grid)

Methods (6)

• getSystemLoad

  read

  Live national (SIN) electricity load curve (MW), intraday series + latest point.

  Input schema

  {
    "type": "object",
    "properties": {},
    "additionalProperties": false
  }

  No args. hourIndex is intraday hour offset, not a timestamp.

• getGenerationMix

  read

  Live national generation by source (hydro/thermal/wind/solar/nuclear), MW.

  Input schema

  {
    "type": "object",
    "properties": {},
    "additionalProperties": false
  }

  No args. Per-source intraday series + latest, plus latestTotalMw.

• getMarginalCost

  read

  Marginal operating cost (CMO) by submarket (R$/MWh), half-hourly day-ahead.

  Input schema

  {
    "type": "object",
    "properties": {
      "submarket": {
        "type": "string",
        "examples": [
          "SE"
        ]
      }
    },
    "additionalProperties": false
  }

  submarket: SE|S|N|NE (default SE).

• getEnergyBalance

  read

  Per-submarket generation/load/import/export + international ties + interchange (MW).

  Input schema

  {
    "type": "object",
    "properties": {},
    "additionalProperties": false
  }

  No args. Single timestamped snapshot (SE-CO/S/NE/N).

• getReservoirLevels

  read

  Stored hydro energy (EAR) by reservoir/basin/subsystem + SIN total.

  Input schema

  {
    "type": "object",
    "properties": {
      "subsystem": {
        "type": "string",
        "examples": [
          "sudeste"
        ]
      },
      "limit": {
        "type": "number"
      }
    },
    "additionalProperties": false
  }

  subsystem substring filter: Norte|Nordeste|Sul|Sudeste. limit ≤1000. Daily.

• getServiceInfo

  read

  Describe the key catalog, submarkets, sources, and probe reachability.

  Input schema

  {
    "type": "object",
    "properties": {},
    "additionalProperties": false
  }

  No args. 24h cached service metadata.