LoneStar Oracle Gridpulse API

US electricity grid intelligence — real-time demand, generation mix (% renewable/gas/nuclear), day-ahead forecasts, and grid stress signals for 7 major US regions. $0.03/report via x402 USDC on Base. | Also from LoneStarOracle: CrownBlock (crownblock.lonestaroracle.xyz) for oil/gas prices | MacroPulse (macro.lonestaroracle.xyz) for macro indicators | Full catalog: lonestaroracle.xyz

GitHub OpenAPI

Operations 3

GET /grid/report US Power Grid Demand & Mix #
GET /grid/preview Preview #
GET /grid/region/{code} Region #

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/lonestaroracle-xyz:lonestaroracle-xyz-gridpulse-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. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.

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

OpenAPI Specification

lonestaroracle-xyz-gridpulse-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: LoneStarOracle — full catalog Gridpulse API
  version: 1.20261117.1
  description: Every LoneStarOracle pay-per-call data service in one document. Call each endpoint at its own host (x-direct-url on each operation; `url` in catalog.json). That direct URL is the resource the 402 challenge names, so x402 clients pay and retry cleanly. Gateway paths https://lonestaroracle.xyz/api// (gateway_url) only 307-redirect to the direct URL; never pay at the proxy. Paid endpoints return HTTP 402 with x402 payment requirements (USDC on Base or Solana); pay and retry. No API keys, no accounts. Price per call is in x-payment-info.
  contact:
    email: info@lonestaroracle.xyz
  x-guidance: 'Agents: fetch this one document; do not crawl per-service hosts. Base URL https://lonestaroracle.xyz/api/<service>/<path> forwards to each service (x-direct-url on each operation is the same endpoint on its own host; both work). Every operation carries x-payment-info: authMode ''free'' needs no payment; authMode ''payment'' returns HTTP 402 with the requirements in the base64 ''payment-required'' response header (x402 v2; a v1 body is also sent for legacy clients). Pay USDC on Base (eip155:8453) or Solana and retry with the payment header; settlement happens only on a successful (2xx) response, so a 4xx such as an unknown category or a missing parameter is never charged. Query-parameter names are in each operation; common synonyms are accepted (e.g. ticker/symbol, country/location). Prices are fixed per call and listed in x-payment-info.price.amount (USD). info.version changes whenever any path, parameter, price or schema changes (x-content-hash is the sha256 of paths+components), so re-pull only when it moves. Flat list: https://lonestaroracle.xyz/catalog.json. Payment manifest: https://lonestaroracle.xyz/.well-known/x402. Feedback (free, no payment, no key): POST any JSON to https://lonestaroracle.xyz/feedback (what you wanted, what was missing, what you would pay); GET it for the suggested fields. Trialability (added 2026-10-05): each operation carries x-example (a real worked request/response), x-edge-cases (how empty, partial, bad-input and error results are represented), x-provenance (data freshness) and x-service-version (pin it; it changes only when that service''s paths, parameters or schema change). Contact: jay@lonestaroracle.xyz.'
  x-content-hash: a415b2385083d038b66621b6e2914e1146ffe53354e39e473f6493078f509f72
  x-changed-at: '2026-11-17T06:40:26Z'
servers:
- url: https://lonestaroracle.xyz/api
tags:
- name: gridpulse
  x-displayName: GridPulse
  x-service-slug: grid
  description: 'US electricity grid intelligence — real-time demand, generation mix (% renewable/gas/nuclear), day-ahead forecasts, and grid stress signals for 7 major US regions. $0.03/report via x402 USDC on Base. | Also from LoneStarOracle: CrownBlock (crownblock.lonestaroracle.xyz) for oil/gas prices | MacroPulse (macro.lonestaroracle.xyz) for macro indicators | Full catalog: lonestaroracle.xyz'
  x-direct-host: https://grid.lonestaroracle.xyz
  x-service-version: de128fd171e9
  x-provenance:
    sources:
    - official and public market data
    freshness: live reads at request time; not stale-cached
paths:
  /grid/report:
    get:
      summary: US Power Grid Demand & Mix
      operationId: grid_report_report_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
              example:
                generated_at: '2026-09-15T23:58:55.763475+00:00'
                regions: '{...}'
                narrative: '# US Grid Conditions Brief


                  California (CAISO) and Southwest Power Pool (SPP) are operating with the cleanest and most cost-effective energy supplies, both exceeding 57% renewable generation with low stress levels. Conversely, PJM faces HIGH stress with the nation''s largest demand (117.3 GW) paired with low renewable penetration (11.2%), while New York, Texas, and New England all report MEDIUM stress despite varying fuel mixes. Industrial operators and EV fleet managers should prioritize demand scheduling in CAISO and SPP regions to minimize costs and environmental impact, while deferring non-critical loads in PJM and other MEDIUM/HIGH stress areas to avoid peak pricing and grid strain.'
                note: 'Demand in megawatthours (MWh). Data source: EIA Form EIA-930.'
        '402':
          description: Payment Required
      x-payment-info:
        authMode: payment
        price:
          mode: fixed
          currency: USD
          amount: '0.030000'
        security:
        - x402: {}
      description: US electricity grid demand, generation mix and stress signal.
      tags:
      - gridpulse
      x-direct-url: https://grid.lonestaroracle.xyz/report
      x-service-version: de128fd171e9
      x-provenance:
        sources:
        - official and public market data
        freshness: live reads at request time; not stale-cached
      x-example:
        request: {}
        response:
          generated_at: '2026-09-15T23:58:55.763475+00:00'
          regions: '{...}'
          narrative: '# US Grid Conditions Brief


            California (CAISO) and Southwest Power Pool (SPP) are operating with the cleanest and most cost-effective energy supplies, both exceeding 57% renewable generation with low stress levels. Conversely, PJM faces HIGH stress with the nation''s largest demand (117.3 GW) paired with low renewable penetration (11.2%), while New York, Texas, and New England all report MEDIUM stress despite varying fuel mixes. Industrial operators and EV fleet managers should prioritize demand scheduling in CAISO and SPP regions to minimize costs and environmental impact, while deferring non-critical loads in PJM and other MEDIUM/HIGH stress areas to avoid peak pricing and grid strain.'
          note: 'Demand in megawatthours (MWh). Data source: EIA Form EIA-930.'
      x-edge-cases:
        behavior: No params to misuse. Fields not yet released upstream return null (never estimated); a warming cache returns 503 'retry', not stale data.
        bad_input: Null/empty fields, never a fabricated result.
        partial_data: Unsourced fields are null, never guessed.
        on_error: A 5xx settles nothing under x402 - you are not charged for a failed call.
      x-latency:
        p50_ms: null
        p95_ms: null
        samples: null
        measured: 1 live call, 2026-09-16 (single sample)
  /grid/preview:
    get:
      summary: Preview
      operationId: grid_preview_preview_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
      x-payment-info:
        authMode: free
      tags:
      - gridpulse
      x-direct-url: https://grid.lonestaroracle.xyz/preview
      x-service-version: de128fd171e9
      x-provenance:
        sources:
        - official and public market data
        freshness: live reads at request time; not stale-cached
      x-edge-cases:
        behavior: 'Not yet documented for this endpoint. Fleet rule: payment settles only on a 2xx response, so a 4xx (unknown symbol/category, missing parameter) or 5xx (upstream down) is never charged.'
  /grid/region/{code}:
    get:
      summary: Region
      description: Single region detail.
      operationId: grid_region_region__code__get
      parameters:
      - name: code
        in: path
        required: true
        schema:
          type: string
          title: Code
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/grid__HTTPValidationError'
      x-payment-info:
        authMode: payment
        price:
          mode: fixed
          currency: USD
          amount: '0.030000'
        security:
        - x402: {}
      tags:
      - gridpulse
      x-direct-url: https://grid.lonestaroracle.xyz/region/{code}
      x-service-version: de128fd171e9
      x-provenance:
        sources:
        - official and public market data
        freshness: live reads at request time; not stale-cached
      x-edge-cases:
        behavior: 'Not yet documented for this endpoint. Fleet rule: payment settles only on a 2xx response, so a 4xx (unknown symbol/category, missing parameter) or 5xx (upstream down) is never charged.'
components:
  schemas:
    grid__ValidationError:
      properties:
        loc:
          items:
            anyOf:
            - type: string
            - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
      - loc
      - msg
      - type
      title: ValidationError
    grid__HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/grid__ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
externalDocs:
  url: https://docs.lonestaroracle.xyz