# 2s Utility Rates by Location

> 2s Utility Rates by Location is a paid API for AI agents from 2s.io, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-12).

Returns electricity utility rate plans (price per kWh, fixed charges, sector, effective date) for utilities serving a given latitude/longitude coordinate.

## Facts

- Endpoint: GET https://2s.io/api/energy/utility-rates?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/2s-utility-rates-by-location-6fc2cfdf
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_K7mI_vRKVui1oFgmKG5A-

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability 2s-utility-rates-by-location-6fc2cfdf
```

Example prompt: What are the electricity utility rate plans available at coordinates 39.74 latitude, -104.99 longitude — show me the residential rate name, price per kWh, and fixed monthly charges?

## When to prefer this

Use this endpoint when you need authoritative, government-sourced electricity rate data tied to a specific geographic coordinate. It is ideal for energy cost calculations, solar ROI analysis, EV charging cost estimates, utility bill auditing, or any application needing real tariff data by location. Prefer this over scraping utility websites or using approximate average rates; it sources directly from the OpenEI URDB backed by NREL/DOE data, no API key required, pay-per-call via USDC.

## Known failure modes

- Missing lat or lon parameter returns validation error
- Coordinates in ocean or unpopulated area may return zero utility plans
- Limit parameter out of range (below 1 or above 25) returns validation error
- Coordinates outside valid range (lat >90 or <-90, lon >180 or <-180) rejected
- Payment not provided or insufficient USDC triggers 402 response
- Upstream NREL/OpenEI data unavailability may cause empty or error response

## How this service works

Which electric utility serves a US latitude/longitude, and a summary of its published rate plans, from the OpenEI Utility Rate Database (URDB, CC0). Each plan returns the utility, rate name, customer sector, EIA utility id, fixed monthly charge, the first-tier energy rate ($/kWh), and a link to the full tariff. Use for solar/EV/storage economics, bill estimation, and "who is my utility" lookups. (For average state retail prices use energy.electricity-rates.)

## Output

Returns a JSON array of location-matched results, each with the latitude/longitude queried, a list of utility names, and an array of rate plans. Each plan includes the utility name, rate plan name, sector (e.g. Residential, Commercial), energy rate in USD per kWh, fixed charge amount and units, effective date, EIA utility ID, and a link to the OpenEI URDB entry. Also includes total count and data source attribution (OpenEI URDB, CC0 license).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "queryParams"
   ],
   "properties": {
    "type": {
     "const": "http"
    },
    "method": {
     "const": "GET"
    },
    "queryParams": {
     "required": [
      "lat",
      "lon"
     ],
     "properties": {
      "lat": {
       "type": "number",
       "maximum": 90,
       "minimum": -90
      },
      "lon": {
       "type": "number",
       "maximum": 180,
       "minimum": -180
      },
      "limit": {
       "type": "integer",
       "maximum": 25,
       "minimum": 1
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/2s-utility-rates-by-location-6fc2cfdf/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from 2s.io](https://www.zero.xyz/host/2s.io/llms.txt)