# Clink Forge Electricity Retail Series

> Clink Forge Electricity Retail Series is a paid API for AI agents from api.clinkforge.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-15).

Returns time-series electricity retail price data sourced from U.S. government datasets, with cryptographic provenance and attestation, paid per-call via x402/USDC.

## Facts

- Endpoint: GET https://api.clinkforge.com/v1/p/electricity-retail-series
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/clink-forge-electricity-retail-series-709ed31f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_hoh2q8GreE8fqgFX0Jpj7

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 clink-forge-electricity-retail-series-709ed31f
```

Example prompt: Pull the electricity retail price series for entity code '3201' from January 2023 through December 2023 — I need the data with its cryptographic provenance so I can verify it came from a government source.

## When to prefer this

Choose this endpoint when you need U.S. electricity retail price time-series data with cryptographic proof of origin — ideal for compliance, audit trails, or any workflow where data authenticity must be verifiable. Prefer over generic energy data APIs when provenance and attestation are required, or when you want to pay per-call without an API key or account setup.

## Known failure modes

- Invalid or unrecognized entity code returns empty data or error
- Date range out of bounds for available government data returns no rows
- Payment failure via x402 results in 402 response and no data
- Malformed date strings (non-ISO, length > 10) rejected by schema validation
- Network timeout on government source ingestion may delay response

## How this service works

Pay per call over x402. USDC on Base, no account, no API key. 28 government-sourced data products at $0.001–$0.05 per call, every response signed and provenance-chained.

## Output

Returns an array of electricity retail price data rows with record IDs, a provenance chain including source URL, authority name, hash, and observation timestamp, a cryptographic attestation with signature and result digest, and a payment receipt confirming the USDC transaction. Includes product name, version, and row count.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "properties": {
  "input": {
   "type": "object",
   "properties": {
    "type": {
     "const": "http"
    },
    "method": {
     "const": "GET"
    },
    "queryParams": {
     "type": "object",
     "required": [],
     "properties": {
      "end": {
       "type": "string",
       "maxLength": 10
      },
      "start": {
       "type": "string",
       "maxLength": 10
      },
      "entity": {
       "type": "string",
       "maxLength": 4
      }
     },
     "additionalProperties": false
    }
   }
  },
  "output": {
   "type": "object"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": [
   {
    "field": "value",
    "_record_id": "R-100"
   }
  ],
  "product": "example-product",
  "row_count": 1,
  "provenance": [
   {
    "hash": "sha256...",
    "authority": "AGENCY",
    "source_url": "https://agency.gov/data",
    "observed_at": "2026-08-25T00:00:00Z"
   }
  ],
  "attestation": {
   "signature": "base64...",
   "result_digest": "sha256...",
   "signing_key_id": "forge-signing-1"
  },
  "payment_receipt": {
   "amount_usd": 0.01,
   "settlement_ref": "0xtx..."
  },
  "product_version": 1
 },
 "description": "data rows + provenance chain + attestation"
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/clink-forge-electricity-retail-series-709ed31f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.clinkforge.com](https://www.zero.xyz/host/api.clinkforge.com/llms.txt)