Api Endpoint

energy-electricity

US electricity data from the EIA grid monitor and retail survey: generation mix by fuel type with percentage breakdown (latest hour), demand by region, and average retail price by state/sector (monthly).

Open interactive test console

Offering

Provider
payai.agentstools.dev
Method
GET
Offering type
Api Endpoint
Transport type
http
Category
Financial Analysis
Delivery
Not provided
Pricing model
Not provided
x402 version
2

Endpoint context

URL
https://payai.agentstools.dev/energy/electricity
MIME type
application/json
First seen
2026-10-16T02:00:30.940Z
Last seen
Tags
energy, electricity, power, grid, generation, demand, retail-price, eia, fuel-mix

Payment pricing

x402 payment terms are the authoritative price for calling this endpoint.

Payment option 1
0.008 USDC
Atomic price: 8000 · Network: eip155:8453 · Asset: USDC · Scheme: exact
Payment option 2
0.008 USDC
Atomic price: 8000 · Network: solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp · Asset: USDC · Scheme: exact
Raw x402 terms
[
  {
    "scheme": "exact",
    "network": "eip155:8453",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "8000",
    "payTo": "0xF22e558a00D91Ee12A1F50C52186FecB8dDFf493"
  },
  {
    "scheme": "exact",
    "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
    "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
    "amount": "8000",
    "payTo": "AytHnvc6bZx1ALTy7b5Px7hcavoSYszG9aeKvDcZ8R1u"
  }
]

Observed health

Status
Healthy
Latest latency
1365 ms
Average latency
1135 ms
HTTP status
402
Last checked
Reachability
100% over 10 checks

Latency is measured to the first response headers. A reachable result does not verify response accuracy or merchant identity.

Input schema

{
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "const": "http"
    },
    "method": {
      "type": "string",
      "enum": [
        "GET",
        "HEAD",
        "DELETE"
      ]
    },
    "queryParams": {
      "type": "object",
      "properties": {
        "metric": {
          "type": "string",
          "enum": [
            "generation_mix",
            "demand",
            "retail_price"
          ],
          "description": "Which electricity series (default generation_mix)"
        },
        "region": {
          "type": "string",
          "enum": [
            "us",
            "california",
            "carolinas",
            "central",
            "florida",
            "mid_atlantic",
            "midwest",
            "new_england",
            "new_york",
            "northwest",
            "southeast",
            "southwest",
            "tennessee",
            "texas"
          ],
          "description": "Grid region for generation_mix/demand (default us)"
        },
        "state": {
          "type": "string",
          "description": "Two-letter state code or US for retail_price (default US)"
        },
        "history": {
          "type": "integer",
          "minimum": 1,
          "maximum": 120,
          "description": "Recent data points for demand/retail_price"
        }
      }
    }
  },
  "required": [
    "type",
    "method"
  ],
  "additionalProperties": false
}

Output schema

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "input"
  ],
  "properties": {
    "input": {
      "type": "object",
      "required": [
        "type",
        "method"
      ],
      "properties": {
        "type": {
          "type": "string",
          "const": "http"
        },
        "method": {
          "enum": [
            "GET",
            "HEAD",
            "DELETE"
          ],
          "type": "string"
        },
        "queryParams": {
          "type": "object",
          "properties": {
            "state": {
              "type": "string",
              "description": "Two-letter state code or US for retail_price (default US)"
            },
            "metric": {
              "enum": [
                "generation_mix",
                "demand",
                "retail_price"
              ],
              "type": "string",
              "description": "Which electricity series (default generation_mix)"
            },
            "region": {
              "enum": [
                "us",
                "california",
                "carolinas",
                "central",
                "florida",
                "mid_atlantic",
                "midwest",
                "new_england",
                "new_york",
                "northwest",
                "southeast",
                "southwest",
                "tennessee",
                "texas"
              ],
              "type": "string",
              "description": "Grid region for generation_mix/demand (default us)"
            },
            "history": {
              "type": "integer",
              "maximum": 120,
              "minimum": 1,
              "description": "Recent data points for demand/retail_price"
            }
          }
        }
      },
      "additionalProperties": false
    },
    "output": {
      "type": "object",
      "required": [
        "type"
      ],
      "properties": {
        "type": {
          "type": "string"
        },
        "example": {
          "type": "object"
        }
      }
    }
  }
}