energy-electricity
GET api.agentstools.dev/energy/electricity
Why an agent can trust this route.
Sonar evidence is advisory. Paid delivery is shown as verified only when paid probes are available; otherwise route estimates use the unpaid handshake as a clearly labeled proxy.
Observed outcomes
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).
Resource: api.agentstools.dev/energy/electricity
Network: eip155:8453 · Asset: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 · Pay to: 0xF22e558a00D91Ee12A1F50C52186FecB8dDFf493
Payment methods: — · Last validation: 2026-10-15 11:28:54.492+00
{
"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"
}
}
},
"paymentRequirements": [
{
"raw": {
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"extra": {
"name": "USD Coin",
"version": "2"
},
"payTo": "0xF22e558a00D91Ee12A1F50C52186FecB8dDFf493",
"amount": "8000",
"scheme": "exact",
"network": "eip155:8453",
"maxTimeoutSeconds": 300
},
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"payTo": "0xF22e558a00D91Ee12A1F50C52186FecB8dDFf493",
"scheme": "exact",
"network": "eip155:8453",
"amountAtomic": "8000"
}
]
}Source catalog records are retained separately from live endpoint observations. Sonar score, uptime, and latency are advisory metrics. CDP indexing is not inferred from validation.