# DataNexusAI Energy Profile by Country

> DataNexusAI Energy Profile by Country 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-10).

Returns an energy profile for a given EU/World country, including Eurostat availability and World Bank indicators like renewable share and energy import percentage.

## Facts

- Endpoint: GET https://api.datanexusai.org/api/v1/energy/profile/%7Bgeo%7D?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-10
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/datanexusai-energy-profile-by-country-c279ebc7
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_23YOudC3IQAylDJh0qBFC

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-profile-by-country-c279ebc7
```

Example prompt: Can you pull up the energy profile for Bulgaria — I want to know its renewable energy share and how much of its energy it imports, using DataNexusAI's country energy profile data?

## When to prefer this

Choose this endpoint when you need quick, structured country-level energy statistics combining Eurostat and World Bank sources for EU or world countries. Ideal for agents building energy dashboards, doing sustainability analysis, or comparing energy import dependency across countries. Prefer this over raw Eurostat or World Bank APIs when you want a unified, pre-aggregated profile in a single call for $0.01 USDC.

## Known failure modes

- Invalid or unsupported ISO2 country code returns an error or empty profile
- Country not covered by Eurostat returns available:false for Eurostat
- World Bank data missing for a country results in null or absent indicators
- Payment failure via x402 (insufficient USDC) blocks access to the paid endpoint
- Malformed geo path parameter causes a 400 or routing error

## 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 the queried country's ISO2 code, a flag indicating Eurostat data availability, and World Bank indicators including energy imports as a percentage of total energy use and renewable energy share as a percentage.

## 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"
    },
    "pathParams": {
     "type": "object",
     "required": [
      "geo"
     ],
     "properties": {
      "geo": {
       "type": "string",
       "example": "BG",
       "description": "ISO2 country code"
      }
     }
    },
    "queryParams": {
     "type": "object",
     "properties": {}
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "geo": "BG",
  "endpoint": "energy_profile",
  "eurostat": {
   "available": true
  },
  "available": true,
  "worldbank": {
   "energy_imports_pct": 36.5,
   "renewable_share_pct": 18.2
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/datanexusai-energy-profile-by-country-c279ebc7/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)