# IRENA Renewable Energy Statistics by Country

> IRENA Renewable Energy Statistics by Country is a paid API for AI agents from api.tradeenergy-api.workers.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-29).

Returns IRENA renewable energy statistics for a single country: installed electrical capacity (MW) and electricity generation (GWh) by technology for recent years, sourced from IRENASTAT.

## Facts

- Endpoint: GET https://api.tradeenergy-api.workers.dev/api/energy/irena-renewable-cost-db?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/irena-renewable-energy-statistics-by-country-63bc7169
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_pLoB9QhhvOn11szWatj4O

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 irena-renewable-energy-statistics-by-country-63bc7169
```

Example prompt: Pull the IRENA renewable energy stats for Germany — I want installed capacity in MW and electricity generation in GWh for solar PV and onshore wind over the last 5 years.

## When to prefer this

Choose this endpoint when you need official, citable IRENA renewable energy statistics — specifically installed capacity (MW) and generation (GWh) by technology for a single country. It is ideal for policy research, sustainability reporting, and energy analysis grounded in internationally recognized data. It does not provide LCOE/cost data; use alternative endpoints for pricing metrics.

## Known failure modes

- Invalid or unsupported ISO 3166 alpha-3 country code returns an error or empty result
- Requested technology filter matches no known IRENA technology category, returning empty technologies array
- Most recent year has null generationGwh because IRENA has not yet published final generation data
- IRENASTAT upstream API unavailable, causing timeout or 5xx error
- Requesting more than 10 years rejected by schema validation

## How this service works

IRENA renewable energy statistics for one country: installed electrical capacity (MW) and electricity generation (GWh) by technology (total renewable, solar PV, onshore and offshore wind, hydropower, bioenergy, geothermal and more) for recent years, from IRENA's public IRENASTAT database. Levelised generation costs (LCOE) are not in this API and are not included.

## Output

A JSON object containing the country name, ISO code, data source URL, IRENA citation string, and a list of technology entries — each with technology name and per-year records showing installed capacity in MW and electricity generation in GWh. The most recent year may have capacity data but null generation (not yet finalized).

## 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"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "country"
     ],
     "properties": {
      "years": {
       "type": "string",
       "description": "Most recent years to return, 1 to 10 (default 3)"
      },
      "country": {
       "type": "string",
       "description": "ISO 3166 alpha-3 country code, e.g. TUR, DEU, USA (required)"
      },
      "technology": {
       "type": "string",
       "description": "Optional words to match technologies, comma separated, e.g. solar,wind (default: total renewable, solar PV, onshore wind, renewable hydropower)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "source": "https://pxweb.irena.org/api/v1/en/IRENASTAT/Power%20Capacity%20and%20Generation/Country_ELECSTAT_2026_H2_PX.px",
  "country": "TUR",
  "citation": "IRENA (2026), Renewable Energy Statistics 2026, International Renewable Energy Agency (IRENA), Abu Dhabi.",
  "checkedAt": "2026-10-23T09:38:25.510Z",
  "countryName": "Türkiye",
  "technologies": [
   {
    "years": [
     {
      "year": 2025,
      "capacityMw": 76300.12,
      "generationGwh": null
     },
     {
      "year": 2024,
      "capacityMw": 69086.62,
      "generationGwh": 162897.17
     }
    ],
    "technology": "Total Renewable"
   },
   {
    "years": [
     {
      "year": 2025,
      "capacityMw": 32293.96,
      "generationGwh": null
     },
     {
      "year": 2024,
      "capacityMw": 32202.96,
      "generationGwh": 74853.18
     }
    ],
    "technology": "Renewable hydropower"
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/irena-renewable-energy-statistics-by-country-63bc7169/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.tradeenergy-api.workers.dev](https://www.zero.xyz/host/api.tradeenergy-api.workers.dev/llms.txt)