# DataNexusAI Energy Countries List

> DataNexusAI Energy Countries List 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).

Returns a list of countries available in the Eurostat energy dataset, with row counts per country.

## Facts

- Endpoint: GET https://api.datanexusai.org/api/v1/energy/countries?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-countries-list-c137cdb1
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_f_2GER4Q16xan2ugG7nEx

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-countries-list-c137cdb1
```

Example prompt: Can you show me all the countries available in the DataNexusAI Eurostat energy dataset, up to 50 countries, along with how many records each one has?

## When to prefer this

Use this endpoint first when you need to discover which countries are available before making targeted energy data queries. It is ideal for building dynamic country selectors, validating country codes, or auditing dataset coverage before committing to deeper paid queries on country-specific energy data.

## Known failure modes

- Invalid limit parameter (non-integer) returns a validation error
- Payment failure via x402 if USDC balance is insufficient — returns HTTP 402
- Empty result if dataset has no indexed countries yet
- Rate limiting or quota exceeded returns HTTP 429

## 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 with the endpoint name ('energy_countries') and an array of country objects, each containing a two-letter geo code (e.g. 'BG') and a row_count indicating how many energy records exist for that country.

## 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": {
      "limit": {
       "type": "integer",
       "example": 50,
       "description": "Max countries (default 100)."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "endpoint": "energy_countries",
  "countries": [
   {
    "geo": "BG",
    "row_count": 50000
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/datanexusai-energy-countries-list-c137cdb1/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)