# DataNexusAI Energy Datasets Catalog

> DataNexusAI Energy Datasets Catalog is a paid API for AI agents from api.datanexusai.org, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-11).

Lists available Eurostat energy datasets (with metadata like row counts, geographic coverage, and time range) optionally filtered by dataset ID prefix

## Facts

- Endpoint: GET https://api.datanexusai.org/api/v1/energy/datasets?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/datanexusai-energy-datasets-catalog-cfa8a6ef
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_tYoCZxDjDfXLe5--GKORT

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 datanexusai-energy-datasets-catalog-cfa8a6ef
```

Example prompt: Show me all available Eurostat energy datasets on DataNexusAI that start with the prefix 'nrg_ind', and limit the results to 50.

## When to prefer this

Use this endpoint when you need to discover what Eurostat energy datasets are available before fetching actual data — ideal for building dataset pickers, checking coverage, or identifying dataset IDs to pass to downstream data query endpoints. Prefer this over general Eurostat APIs when you need quick filtered catalog access with per-call micropayment pricing and no subscription required.

## Known failure modes

- Invalid or non-matching prefix filter returns empty dataset array with count 0
- Missing or invalid x402 USDC micropayment returns 402 Payment Required
- Limit parameter out of range may return error or be clamped to default
- Network timeout if Eurostat upstream is slow or unavailable

## How this service works

Public data API for SEBRA payments, PTP road accidents, EU agri-food prices, Eurostat energy (+ ETS), and trade/market analytics. Paid data endpoints use x402 (USDC micropayments). HTML docs at `/api/` are free and are intentionally omitted from this OpenAPI document so discovery scanners do not probe them as paid resources.

Machine-readable discovery: `https://api.datanexusai.org/openapi.json`, `https://api.datanexusai.org/llms.txt`, `https://api.datanexusai.org/.well-known/x402`.

Human docs: `/docs` and `/api/`.

## Output

A JSON object containing a count of matching datasets and an array of dataset metadata objects, each with dataset_id, row_count, series_count, geo_count (number of geographies), period_min, and period_max (year range of coverage), plus an endpoint label.

## 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"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "q": {
       "type": "string",
       "example": "nrg_ind",
       "description": "Prefix filter on dataset_id (e.g. nrg_ind)."
      },
      "limit": {
       "type": "integer",
       "example": 50,
       "description": "Max datasets (default 100)."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 1,
  "datasets": [
   {
    "geo_count": 41,
    "row_count": 12000,
    "dataset_id": "nrg_ind_ei",
    "period_max": "2024",
    "period_min": "2006",
    "series_count": 800
   }
  ],
  "endpoint": "energy_datasets"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/datanexusai-energy-datasets-catalog-cfa8a6ef/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.datanexusai.org](https://www.zero.xyz/host/api.datanexusai.org/llms.txt)