# Gloom Power Dataset Coverage

> Gloom Power Dataset Coverage is a paid API for AI agents from api.gloom.sh, paid per call via x402, $0.12/call, status unknown (last checked 2026-11-01).

Returns coverage metadata for available power grid datasets, including region, status, record count, and observation timestamps.

## Facts

- Endpoint: GET https://api.gloom.sh/v1/datasets/power/coverage?utm_source=zero.xyz
- Price: $0.12/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-01
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/gloom-power-dataset-coverage-a35b73e8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_X06Utcwxllfa3Qrca5puI

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 gloom-power-dataset-coverage-a35b73e8
```

Example prompt: Can you pull up the Gloom power dataset coverage list so I can see which grid regions like CAISO have current data available?

## When to prefer this

Use this endpoint when you need to discover which power grid regions and electricity market datasets are available and current within the Gloom platform before fetching actual power data. Ideal for pre-flight checks, building dataset selectors, or auditing coverage gaps across ISO/RTO regions.

## Known failure modes

- Invalid properties filter returns empty or error response
- Dataset coverage may return null asOf fields for datasets with no recent observation
- Service may return 402 if payment is not supplied via x402 protocol
- Stale coverage data if upstream grid operators have not updated recently

## How this service works

Gloom is a free, open-source finance terminal for desktop and TUI with charts, news, filings, portfolios, alerts, and plugins.

## Output

Returns a JSON array of dataset coverage objects, each containing a dataset ID (e.g. 'us-caiso'), region name, country code, dataset kind (e.g. 'queue'), role (e.g. 'direct'), current status (e.g. 'current'), record count, and last observed timestamp.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": [
   {
    "id": "us-caiso",
    "asOf": null,
    "kind": "queue",
    "role": "direct",
    "reason": null,
    "region": "CAISO",
    "status": "current",
    "country": "US",
    "records": 5,
    "observedAt": "2026-10-04T01:00:00.000Z"
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/gloom-power-dataset-coverage-a35b73e8/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.gloom.sh](https://www.zero.xyz/host/api.gloom.sh/llms.txt)
