{"uid":"cap_AJA5ITIr7D75G5adil-Ul","slug":"datanexusai-electricity-statistics-by-country-5ff17c76","name":"DataNexusAI Electricity Statistics by Country","description":"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.\n\nMachine-readable discovery: `https://api.datanexusai.org/openapi.json`, `https://api.datanexusai.org/llms.txt`, `https://api.datanexusai.org/.well-known/x402`.\n\nHuman docs: `/docs` and `/api/`.","url":"https://api.datanexusai.org/api/v1/energy/electricity/%7Bgeo%7D?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"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":{"siec":{"type":"string","example":"E7000","description":"Product code (default E7000)."},"unit":{"type":"string","example":"GWH","description":"Unit (default GWH)."},"period":{"type":"string","description":"Optional year, e.g. 2025."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"geo":"BG","derived":{"trade_balance":1320.9,"self_sufficiency_pct":112.7},"metrics":{"gross_production":{"unit":"GWH","value":39645.5,"period":"2025"},"final_consumption":{"unit":"GWH","value":32526.7}},"endpoint":"energy_electricity","available":true}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_ou1IgI2noKNtC2pCe2WgI","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns Eurostat electricity production, consumption, and trade-balance metrics for a given EU country and year.","exampleAgentPrompt":"What are Bulgaria's electricity production and consumption figures for 2025, including its trade balance and self-sufficiency percentage?","exampleUseCases":[{"title":"EU energy policy research","prompt":"Can you pull the electricity gross production and final consumption stats for Germany in 2024, and tell me how self-sufficient they are?"},{"title":"Country energy trade balance check","prompt":"What's France's electricity trade balance for 2025 — are they a net exporter or importer, and by how many GWH?"},{"title":"Renewable energy product-code deep dive","prompt":"Fetch the electricity data for Romania using SIEC product code E7000 for 2023 and show me production vs consumption in GWH."}],"resultDescription":"Returns a JSON object containing the country ISO2 code, gross electricity production in GWH, final consumption in GWH, derived trade balance in GWH, self-sufficiency percentage, the queried period, and an availability flag.","failureModes":["Invalid or unsupported ISO2 country code returns an error or unavailable flag","Unsupported SIEC product code may return no data","Requested year/period has no data yet (future period or data lag) returns null or unavailable","Missing required geo path parameter returns 400/422","Payment not completed (x402) results in 402 Payment Required before data is returned"],"whenToPreferThis":"Choose this endpoint when you need structured, machine-readable Eurostat electricity statistics — including production, consumption, and trade balance — for a specific EU/EEA country. Prefer it over generic web search when you need precise numeric figures, derived ratios like self-sufficiency percentage, or when integrating energy data into automated workflows or dashboards.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T18:39:59.739Z","isFirstParty":false,"canonicalSlug":"datanexusai-electricity-statistics-by-country-5ff17c76"}