ExchangeRebel Power Flags API

The Power Flags API from ExchangeRebel — 8 operation(s) for power flags.

GitHub OpenAPI

Operations 8

GET /toll/power/flags/dart ERCOT DA vs RT divergence flags for one hub #
GET /toll/power/flags/negative ERCOT negative-price windows: 24h/7d counts #
GET /toll/power/flags/congestion ERCOT hub-spread congestion spikes, ranked #
GET /toll/power/flags/battery ERCOT daily battery charge/discharge windows #
GET /toll/power/scan Ranked ERCOT multi-hub power-flag scan #
GET /toll/power/catalog Power Flags catalog: endpoints, prices, hubs #
GET /toll/power/schema Power Flags schema + flag semantics #
GET /toll/power/health Check the power flags service status #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/exchangerebel-com:exchangerebel-com-power-flags-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

exchangerebel-com-power-flags-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: ExchangeRebel — pay-per-call APIs for AI agents (x402 on…
  version: 1.0.0
  contact:
    name: 'ExchangeRebel (operator: Rebel Data)'
    url: https://exchangerebel.com
    email: sound.money.investing@gmail.com
  x-guidance: 'All paid operations use x402 on Solana: call without payment to get a 402 challenge (SOL recipient + USDC token account + fresh memo), pay with the memo attached via the Solana Memo program, then retry with header X-Payment-Tx: <signature> and ?toll_memo=<memo>. Challenges are dual-version: the PAYMENT-REQUIRED header carries the x402 v2 PaymentRequired object and the response body carries the same challenge in x402 v1 form for compatibility. Free operations (security: []) include each service''s /health catalog with full response shapes. Prices in x-payment-info are USD per call unless the summary says otherwise (RPC is per 1,000-request block; Telegram provisioning is per bot-month; transcription is per minute of audio).'
  description: '67 data and utility APIs behind x402 tolls, settled in SOL or USDC on Solana. Call a paid endpoint without payment to receive a 402 x402 challenge (recipient + fresh memo), pay with the memo attached via the Solana Memo program, then retry with the X-Payment-Tx header and toll_memo query parameter. Free catalog/health endpoints are marked without x-payment-info. Full catalogs: GET /toll/discovery and each service''s /health.'
servers:
- url: https://exchangerebel.com
tags:
- name: Power Flags
paths:
  /toll/power/flags/dart:
    get:
      tags:
      - Power Flags
      summary: ERCOT DA vs RT divergence flags for one hub
      responses:
        '200':
          description: Success. Response shape is documented in the service catalog (GET /health on the service).
          content:
            application/json:
              example:
                hub: HB_NORTH
                threshold_usd_mwh: 25
                window_hours: 48
                hours_compared: 49
                firing_count: 3
                max_abs_divergence: 60
                latest_firing:
                  hour_start: '2026-10-16T14:00:00.000Z'
                  hour_ct: 2026-10-16 09:00 CT
                  da: 30
                  rt_hourly_mean: 90
                  divergence: 60
                  abs_divergence: 60
                firings:
                - hour_start: '2026-10-16T13:00:00.000Z'
                  hour_ct: 2026-10-16 08:00 CT
                  da: 40
                  rt_hourly_mean: 100
                  divergence: 60
                  abs_divergence: 60
                - hour_start: '2026-10-16T14:00:00.000Z'
                  hour_ct: 2026-10-16 09:00 CT
                  da: 30
                  rt_hourly_mean: 90
                  divergence: 60
                  abs_divergence: 60
                - hour_start: '2026-10-16T11:00:00.000Z'
                  hour_ct: 2026-10-16 06:00 CT
                  da: 40
                  rt_hourly_mean: 10
                  divergence: -30
                  abs_divergence: 30
                verdict: 3 DA/RT divergence outlier hour(s) >= $25/MWh for HB_NORTH in the trailing 48h; max |divergence| $60/MWh.
                attribution: 'Source: ERCOT public market data'
                staleness:
                  present: true
                  generated_at: '2026-10-16T16:00:00.000Z'
                  dam_as_of: '2026-10-16T16:00:00.000Z'
                  rt_as_of: '2026-10-16T16:00:00.000Z'
                  dam_doc_id: '1286801847'
                  rt_doc_id: '1286855513'
                  dam_operating_day: '2026-10-16'
                  rt_age_seconds: 0
                  dam_age_seconds: 0
                  rt_stale: false
                  dam_stale: false
                  stale: false
                  status: fresh
                  quarantined_points: 2
                envelope:
                  v: 1
                  service: power-flags
                  as_of: '2026-10-16T16:00:00.000Z'
                  source: 'Source: ERCOT public market data (MIS public reports: DAM SPP report 12331; RT SPP report 12301), computed flags only'
                  grade: derived
                  max_age_seconds: 900
                  changes:
                    supported: false
        '402':
          description: 'Payment Required (x402). The PAYMENT-REQUIRED response header carries the x402 v2 PaymentRequired object (base64 JSON: scheme, CAIP-2 network, amount, asset, payTo, plus the bazaar discovery extension); the response body carries the same challenge in x402 v1 form for compatibility, naming the SOL recipient and USDC token account on Solana plus a fresh memo. To pay on this service''s rail: pay with the memo attached (Solana Memo program), then retry with header ''X-Payment-Tx: <transaction signature>'' and query parameter ''toll_memo=<memo>''.'
      parameters:
      - name: hub
        in: query
        required: true
        schema:
          type: string
        description: 'ERCOT hub: HB_NORTH | HB_HOUSTON | HB_SOUTH | HB_WEST | HB_PAN | HB_BUSAVG | HB_HUBAVG'
      - name: threshold
        in: query
        required: false
        schema:
          type: string
        description: Divergence threshold USD/MWh, 5..500, default 25
      - name: window_hours
        in: query
        required: false
        schema:
          type: string
        description: Trailing window in hours, 1..168, default 48
      x-payment-info:
        protocols:
        - x402
        price:
          mode: fixed
          currency: USD
          amount: '0.01'
      security:
      - x402Payment: []
      operationId: getTollPowerFlagsDart
      x-operation-id-source: derived
  /toll/power/flags/negative:
    get:
      tags:
      - Power Flags
      summary: 'ERCOT negative-price windows: 24h/7d counts'
      responses:
        '200':
          description: Success. Response shape is documented in the service catalog (GET /health on the service).
          content:
            application/json:
              example:
                per_hub:
                - hub: HB_NORTH
                  da_negative_hours_24h: 0
                  da_negative_hours_7d: 0
                  rt_negative_intervals_24h: 0
                  rt_negative_intervals_7d: 0
                  min_da_7d: null
                  min_rt_7d: null
                  active_window: false
                  recent_negative_points: []
                - hub: HB_HOUSTON
                  da_negative_hours_24h: 0
                  da_negative_hours_7d: 0
                  rt_negative_intervals_24h: 0
                  rt_negative_intervals_7d: 0
                  min_da_7d: null
                  min_rt_7d: null
                  active_window: false
                  recent_negative_points: []
                - hub: HB_SOUTH
                  da_negative_hours_24h: 0
                  da_negative_hours_7d: 0
                  rt_negative_intervals_24h: 0
                  rt_negative_intervals_7d: 0
                  min_da_7d: null
                  min_rt_7d: null
                  active_window: false
                  recent_negative_points: []
                - hub: HB_WEST
                  da_negative_hours_24h: 0
                  da_negative_hours_7d: 1
                  rt_negative_intervals_24h: 1
                  rt_negative_intervals_7d: 4
                  min_da_7d: -0.09
                  min_rt_7d: -12.5
                  active_window: true
                  recent_negative_points:
                  - kind: rt15
                    t: '2026-10-16T16:00:00.000Z'
                    hour_ct: 2026-10-16 11:00 CT
                    price: -5
                  - kind: rt15
                    t: '2026-10-15T14:30:00.000Z'
                    hour_ct: 2026-10-15 09:00 CT
                    price: -12.5
                  - kind: rt15
                    t: '2026-10-15T14:15:00.000Z'
                    hour_ct: 2026-10-15 09:00 CT
                    price: -12.5
                  - kind: rt15
                    t: '2026-10-15T14:00:00.000Z'
                    hour_ct: 2026-10-15 09:00 CT
                    price: -12.5
                  - kind: da_hour
                    t: '2026-10-15T10:00:00.000Z'
                    hour_ct: 2026-10-15 05:00 CT
                    price: -0.09
                - hub: HB_PAN
                  da_negative_hours_24h: 0
                  da_negative_hours_7d: 0
                  rt_negative_intervals_24h: 0
                  rt_negative_intervals_7d: 0
                  min_da_7d: null
                  min_rt_7d: null
                  active_window: false
                  recent_negative_points: []
                - hub: HB_BUSAVG
                  da_negative_hours_24h: 0
                  da_negative_hours_7d: 0
                  rt_negative_intervals_24h: 0
                  rt_negative_intervals_7d: 0
                  min_da_7d: null
                  min_rt_7d: null
                  active_window: false
                  recent_negative_points: []
                - hub: HB_HUBAVG
                  da_negative_hours_24h: 0
                  da_negative_hours_7d: 0
                  rt_negative_intervals_24h: 0
                  rt_negative_intervals_7d: 0
                  min_da_7d: null
                  min_rt_7d: null
                  active_window: false
                  recent_negative_points: []
                negative_points_24h_all_hubs: 1
                active_hubs:
                - HB_WEST
                verdict: 'Negative prices present: 1 negative point(s) in the trailing 24h across 7 hub(s); ACTIVE now at HB_WEST.'
                attribution: 'Source: ERCOT public market data'
                staleness:
                  present: true
                  generated_at: '2026-10-16T16:00:00.000Z'
                  dam_as_of: '2026-10-16T16:00:00.000Z'
                  rt_as_of: '2026-10-16T16:00:00.000Z'
                  dam_doc_id: '1286801847'
                  rt_doc_id: '1286855513'
                  dam_operating_day: '2026-10-16'
                  rt_age_seconds: 0
                  dam_age_seconds: 0
                  rt_stale: false
                  dam_stale: false
                  stale: false
                  status: fresh
                  quarantined_points: 2
                envelope:
                  v: 1
                  service: power-flags
                  as_of: '2026-10-16T16:00:00.000Z'
                  source: 'Source: ERCOT public market data (MIS public reports: DAM SPP report 12331; RT SPP report 12301), computed flags only'
                  grade: derived
                  max_age_seconds: 900
                  changes:
                    supported: false
        '402':
          description: 'Payment Required (x402). The PAYMENT-REQUIRED response header carries the x402 v2 PaymentRequired object (base64 JSON: scheme, CAIP-2 network, amount, asset, payTo, plus the bazaar discovery extension); the response body carries the same challenge in x402 v1 form for compatibility, naming the SOL recipient and USDC token account on Solana plus a fresh memo. To pay on this service''s rail: pay with the memo attached (Solana Memo program), then retry with header ''X-Payment-Tx: <transaction signature>'' and query parameter ''toll_memo=<memo>''.'
      parameters:
      - name: hub
        in: query
        required: false
        schema:
          type: string
        description: Optional ERCOT hub filter (HB_*); omit for all 7 hubs
      x-payment-info:
        protocols:
        - x402
        price:
          mode: fixed
          currency: USD
          amount: '0.01'
      security:
      - x402Payment: []
      operationId: getTollPowerFlagsNegative
      x-operation-id-source: derived
  /toll/power/flags/congestion:
    get:
      tags:
      - Power Flags
      summary: ERCOT hub-spread congestion spikes, ranked
      responses:
        '200':
          description: Success. Response shape is documented in the service catalog (GET /health on the service).
          content:
            application/json:
              example:
                basis: RT hourly mean SPP, max-min across hubs per hour
                threshold_usd_mwh: 25
                window_hours: 48
                hours_compared: 49
                spike_count: 4
                max_spread: 60
                top_pair: HB_NORTH vs HB_HOUSTON
                spikes:
                - hour_start: '2026-10-16T13:00:00.000Z'
                  hour_ct: 2026-10-16 08:00 CT
                  spread: 60
                  top_hub: HB_NORTH
                  top_price: 100
                  bottom_hub: HB_HOUSTON
                  bottom_price: 40
                  top_pair: HB_NORTH vs HB_HOUSTON
                - hour_start: '2026-10-16T14:00:00.000Z'
                  hour_ct: 2026-10-16 09:00 CT
                  spread: 50
                  top_hub: HB_NORTH
                  top_price: 90
                  bottom_hub: HB_HOUSTON
                  bottom_price: 40
                  top_pair: HB_NORTH vs HB_HOUSTON
                - hour_start: '2026-10-15T14:00:00.000Z'
                  hour_ct: 2026-10-15 09:00 CT
                  spread: 39.37
                  top_hub: HB_NORTH
                  top_price: 40
                  bottom_hub: HB_WEST
                  bottom_price: 0.63
                  top_pair: HB_NORTH vs HB_WEST
                - hour_start: '2026-10-16T11:00:00.000Z'
                  hour_ct: 2026-10-16 06:00 CT
                  spread: 30
                  top_hub: HB_HOUSTON
                  top_price: 40
                  bottom_hub: HB_NORTH
                  bottom_price: 10
                  top_pair: HB_HOUSTON vs HB_NORTH
                verdict: 4 congestion spike hour(s) >= $25/MWh in the trailing 48h; max spread $60/MWh (HB_NORTH vs HB_HOUSTON).
                attribution: 'Source: ERCOT public market data'
                staleness:
                  present: true
                  generated_at: '2026-10-16T16:00:00.000Z'
                  dam_as_of: '2026-10-16T16:00:00.000Z'
                  rt_as_of: '2026-10-16T16:00:00.000Z'
                  dam_doc_id: '1286801847'
                  rt_doc_id: '1286855513'
                  dam_operating_day: '2026-10-16'
                  rt_age_seconds: 0
                  dam_age_seconds: 0
                  rt_stale: false
                  dam_stale: false
                  stale: false
                  status: fresh
                  quarantined_points: 2
                envelope:
                  v: 1
                  service: power-flags
                  as_of: '2026-10-16T16:00:00.000Z'
                  source: 'Source: ERCOT public market data (MIS public reports: DAM SPP report 12331; RT SPP report 12301), computed flags only'
                  grade: derived
                  max_age_seconds: 900
                  changes:
                    supported: false
        '402':
          description: 'Payment Required (x402). The PAYMENT-REQUIRED response header carries the x402 v2 PaymentRequired object (base64 JSON: scheme, CAIP-2 network, amount, asset, payTo, plus the bazaar discovery extension); the response body carries the same challenge in x402 v1 form for compatibility, naming the SOL recipient and USDC token account on Solana plus a fresh memo. To pay on this service''s rail: pay with the memo attached (Solana Memo program), then retry with header ''X-Payment-Tx: <transaction signature>'' and query parameter ''toll_memo=<memo>''.'
      parameters:
      - name: threshold
        in: query
        required: false
        schema:
          type: string
        description: Spread threshold USD/MWh, 5..500, default 25
      - name: window_hours
        in: query
        required: false
        schema:
          type: string
        description: Trailing window in hours, 1..168, default 48
      x-payment-info:
        protocols:
        - x402
        price:
          mode: fixed
          currency: USD
          amount: '0.01'
      security:
      - x402Payment: []
      operationId: getTollPowerFlagsCongestion
      x-operation-id-source: derived
  /toll/power/flags/battery:
    get:
      tags:
      - Power Flags
      summary: ERCOT daily battery charge/discharge windows
      responses:
        '200':
          description: Success. Response shape is documented in the service catalog (GET /health on the service).
          content:
            application/json:
              example:
                per_hub:
                - hub: HB_NORTH
                  days:
                  - operating_day_ct: '2026-10-09'
                    partial: false
                    hours_observed: 24
                    rt_hourly_min: 40
                    rt_hourly_max: 40
                    spread: 0
                    charge_hour_ct: 2026-10-09 00:00 CT
                    discharge_hour_ct: 2026-10-09 00:00 CT
                    spread_ge_50: false
                  - operating_day_ct: '2026-10-10'
                    partial: false
                    hours_observed: 24
                    rt_hourly_min: 40
                    rt_hourly_max: 40
                    spread: 0
                    charge_hour_ct: 2026-10-10 00:00 CT
                    discharge_hour_ct: 2026-10-10 00:00 CT
                    spread_ge_50: false
                  - operating_day_ct: '2026-10-11'
                    partial: false
                    hours_observed: 24
                    rt_hourly_min: 10
                    rt_hourly_max: 110
                    spread: 100
                    charge_hour_ct: 2026-10-11 04:00 CT
                    discharge_hour_ct: 2026-10-11 18:00 CT
                    spread_ge_50: true
                  - operating_day_ct: '2026-10-12'
                    partial: false
                    hours_observed: 24
                    rt_hourly_min: 40
                    rt_hourly_max: 40
                    spread: 0
                    charge_hour_ct: 2026-10-12 00:00 CT
                    discharge_hour_ct: 2026-10-12 00:00 CT
                    spread_ge_50: false
                  - operating_day_ct: '2026-10-13'
                    partial: false
                    hours_observed: 24
                    rt_hourly_min: 40
                    rt_hourly_max: 40
                    spread: 0
                    charge_hour_ct: 2026-10-13 00:00 CT
                    discharge_hour_ct: 2026-10-13 00:00 CT
                    spread_ge_50: false
                  - operating_day_ct: '2026-10-14'
                    partial: false
                    hours_observed: 24
                    rt_hourly_min: 40
                    rt_hourly_max: 40
                    spread: 0
                    charge_hour_ct: 2026-10-14 00:00 CT
                    discharge_hour_ct: 2026-10-14 00:00 CT
                    spread_ge_50: false
                  - operating_day_ct: '2026-10-15'
                    partial: false
                    hours_observed: 24
                    rt_hourly_min: 40
                    rt_hourly_max: 40
                    spread: 0
                    charge_hour_ct: 2026-10-15 00:00 CT
                    discharge_hour_ct: 2026-10-15 00:00 CT
                    spread_ge_50: false
                  - operating_day_ct: '2026-10-16'
                    partial: true
                    hours_observed: 12
                    rt_hourly_min: 10
                    rt_hourly_max: 100
                    spread: 90
                    charge_hour_ct: 2026-10-16 06:00 CT
                    discharge_hour_ct: 2026-10-16 08:00 CT
                    spread_ge_50: true
                  latest_day:
                    operating_day_ct: '2026-10-16'
                    partial: true
                    hours_observed: 12
                    rt_hourly_min: 10
                    rt_hourly_max: 100
                    spread: 90
                    charge_hour_ct: 2026-10-16 06:00 CT
                    discharge_hour_ct: 2026-10-16 08:00 CT
                    spread_ge_50: true
                  latest_full_day:
                    operating_day_ct: '2026-10-15'
                    partial: false
                    hours_observed: 24
                    rt_hourly_min: 40
                    rt_hourly_max: 40
                    spread: 0
                    charge_hour_ct: 2026-10-15 00:00 CT
                    discharge_hour_ct: 2026-10-15 00:00 CT
                    spread_ge_50: false
                hubs_with_spread_ge_50_latest_day:
                - HB_NORTH
                verdict: 'Battery window >= $50/MWh on the latest observed day at: HB_NORTH.'
                attribution: 'Source: ERCOT public market data'
                staleness:
                  present: true
                  generated_at: '2026-10-16T16:00:00.000Z'
                  dam_as_of: '2026-10-16T16:00:00.000Z'
                  rt_as_of: '2026-10-16T16:00:00.000Z'
                  dam_doc_id: '1286801847'
                  rt_doc_id: '1286855513'
                  dam_operating_day: '2026-10-16'
                  rt_age_seconds: 0
                  dam_age_seconds: 0
                  rt_stale: false
                  dam_stale: false
                  stale: false
                  status: fresh
                  quarantined_points: 2
                envelope:
                  v: 1
                  service: power-flags
                  as_of: '2026-10-16T16:00:00.000Z'
                  source: 'Source: ERCOT public market data (MIS public reports: DAM SPP report 12331; RT SPP report 12301), computed flags only'
                  grade: derived
                  max_age_seconds: 900
                  changes:
                    supported: false
        '402':
          description: 'Payment Required (x402). The PAYMENT-REQUIRED response header carries the x402 v2 PaymentRequired object (base64 JSON: scheme, CAIP-2 network, amount, asset, payTo, plus the bazaar discovery extension); the response body carries the same challenge in x402 v1 form for compatibility, naming the SOL recipient and USDC token account on Solana plus a fresh memo. To pay on this service''s rail: pay with the memo attached (Solana Memo program), then retry with header ''X-Payment-Tx: <transaction signature>'' and query parameter ''toll_memo=<memo>''.'
      parameters:
      - name: hub
        in: query
        required: false
        schema:
          type: string
        description: Optional ERCOT hub filter (HB_*); omit for all 7 hubs
      x-payment-info:
        protocols:
        - x402
        price:
          mode: fixed
          currency: USD
          amount: '0.01'
      security:
      - x402Payment: []
      operationId: getTollPowerFlagsBattery
      x-operation-id-source: derived
  /toll/power/scan:
    get:
      tags:
      - Power Flags
      summary: Ranked ERCOT multi-hub power-flag scan
      responses:
        '200':
          description: Success. Response shape is documented in the service catalog (GET /health on the service).
          content:
            application/json:
              example:
                highlights:
                - family: battery
                  hub: HB_NORTH
                  score: 90
                  detail: HB_NORTH latest-day RT spread $90/MWh (charge 2026-10-16 06:00 CT, discharge 2026-10-16 08:00 CT)
                - family: dart
                  hub: HB_NORTH
                  score: 60
                  detail: 3 DA/RT divergence outlier hour(s) >= $25/MWh for HB_NORTH in the trailing 48h; max |divergence| $60/MWh.
                - family: congestion
                  hub: HB_NORTH vs HB_HOUSTON
                  score: 60
                  detail: 4 congestion spike hour(s) >= $25/MWh in the trailing 48h; max spread $60/MWh (HB_NORTH vs HB_HOUSTON).
                - family: dart
                  hub: HB_WEST
                  score: 40.09
                  detail: 2 DA/RT divergence outlier hour(s) >= $25/MWh for HB_WEST in the trailing 48h; max |divergence| $40.09/MWh.
                - family: negative
                  hub: HB_WEST
                  score: 1
                  detail: 1 negative point(s) in 24h at HB_WEST (ACTIVE)
                per_hub_summary:
                - hub: HB_NORTH
                  dart_firings_48h: 3
                  dart_max_abs_divergence: 60
                  negative_points_24h: 0
                  negative_active: false
                  battery_latest_day_spread: 90
                  battery_spread_ge_50: true
                - hub: HB_HOUSTON
                  dart_firings_48h: 0
                  dart_max_abs_divergence: 0
                  negative_points_24h: 0
                  negative_active: false
                  battery_latest_day_spread: 0
                  battery_spread_ge_50: false
                - hub: HB_SOUTH
                  dart_firings_48h: 0
                  dart_max_abs_divergence: 0
                  negative_points_24h: 0
                  negative_active: false
                  battery_latest_day_spread: 0
                  battery_spread_ge_50: false
                - hub: HB_WEST
                  dart_firings_48h: 2
                  dart_max_abs_divergence: 40.09
                  negative_points_24h: 1
                  negative_active: true
                  battery_latest_day_spread: 11.25
                  battery_spread_ge_50: false
                - hub: HB_PAN
                  dart_firings_48h: 0
                  dart_max_abs_divergence: 0
                  negative_points_24h: 0
                  negative_active: false
                  battery_latest_day_spread: 0
                  battery_spread_ge_50: false
                - hub: HB_BUSAVG
                  dart_firings_48h: 0
                  dart_max_abs_divergence: 0
                  negative_points_24h: 0
                  negative_active: false
                  battery_latest_day_spread: 0
                  battery_spread_ge_50: false
                - hub: HB_HUBAVG
                  dart_firings_48h: 0
                  dart_max_abs_divergence: 0
                  negative_points_24h: 0
                  negative_active: false
                  battery_latest_day_spread: 0
                  battery_spread_ge_50: false
                congestion:
                  spike_count: 4
                  max_spread: 60
                  top_pair: HB_NORTH vs HB_HOUSTON
                verdict: '5 flag highlight(s) across the 7 ERCOT hubs; top: battery at HB_NORTH (score 90).'
                attribution: 'Source: ERCOT public market data'
                staleness:
                  present: true
                  generated_at: '2026-10-16T16:00:00.000Z'
                  dam_as_of: '2026-10-16T16:00:00.000Z'
                  rt_as_of: '2026-10-16T16:00:00.000Z'
                  dam_doc_id: '1286801847'
                  rt_doc_id: '1286855513'
                  dam_operating_day: '2026-10-16'
                  rt_age_seconds: 0
                  dam_age_seconds: 0
                  rt_stale: false
                  dam_stale: false
                  stale: false
                  status: fresh
                  quarantined_points: 2
                envelope:
                  v: 1
                  service: power-flags
                  as_of: '2026-10-16T16:00:00.000Z'
                  source: 'Source: ERCOT public market data (MIS public reports: DAM SPP report 12331; RT SPP report 12301), computed flags only'
                  grade: derived
                  max_age_seconds: 900
                  changes:
                    supported: false
        '402':
          description: 'Payment Required (x402). The PAYMENT-REQUIRED response header carries the x402 v2 PaymentRequired object (base64 JSON: scheme, CAIP-2 network, amount, asset, payTo, plus the bazaar discovery extension); the response body carries the same challenge in x402 v1 form for compatibility, naming the SOL recipient and USDC token account on Solana plus a fresh memo. To pay on this service''s rail: pay with the memo attached (Solana Memo program), then retry with header ''X-Payment-Tx: <transaction signature>'' and query parameter ''toll_memo=<memo>''.'
      x-payment-info:
        protocols:
        - x402
        price:
          mode: fixed
          currency: USD
          amount: '0.05'
      security:
      - x402Payment: []
      operationId: getTollPowerScan
      x-operation-id-source: derived
  /toll/power/catalog:
    get:
      tags:
      - Power Flags
      summary: 'Power Flags catalog: endpoints, prices, hubs'
      responses:
        '200':
          description: Success. Response shape is documented in the service catalog (GET /health on the service).
      security: []
      operationId: getTollPowerCatalog
      x-operation-id-source: derived
  /toll/power/schema:
    get:
      tags:
      - Power Flags
      summary: Power Flags schema + flag semantics
      responses:
        '200':
          description: Success. Response shape is documented in the service catalog (GET /health on the service).
      security: []
      operationId: getTollPowerSchema
      x-operation-id-source: derived
  /toll/power/health:
    get:
      tags:
      - Power Flags
      summary: Check the power flags service status
      responses:
        '200':
          description: Success. Response shape is documented in the service catalog (GET /health on the service).
      security: []
      operationId: getTollPowerHealth
      x-operation-id-source: derived
components:
  securitySchemes:
    x402Payment:
      type: apiKey
      in: header
      name: X-Payment-Tx
      description: 'x402 toll payment proof: the Solana transaction signature of a payment carrying the memo from the 402 challenge; send together with ?toll_memo=<memo>. Payment itself is made on-chain in SOL or USDC to the recipient named in the challenge.'