{"uid":"cap_MUewE7JmE0L0_qEDihq-w","slug":"datanexusai-energy-balance-api-762014a9","name":"DataNexusAI Energy Balance API","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/balance/%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":"TOTAL","description":"Product code (default TOTAL)."},"unit":{"type":"string","example":"KTOE","description":"Unit (default KTOE; also TJ, GWH)."},"view":{"type":"string","example":"mix","description":"Optional view=mix to include GIC fuel-mix by siec."},"period":{"type":"string","description":"Optional year, e.g. 2024."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"geo":"BG","derived":{"import_dependency_pct":42.1},"metrics":{"primary_production":{"unit":"KTOE","value":9633.8,"period":"2024"},"gross_inland_consumption":{"unit":"KTOE","value":17277.5}},"endpoint":"energy_balance","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_Q7olxMFlOvgPe4STTOdch","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 energy balance metrics (primary production, gross inland consumption, import dependency) for a given EU country and optional product/unit/period filters.","exampleAgentPrompt":"What's Bulgaria's total energy balance for 2024 — I need primary production and gross inland consumption in KTOE, plus the import dependency percentage and the fuel mix breakdown.","exampleUseCases":[{"title":"Country energy import dependency check","prompt":"What percentage of its energy does Poland import, and what was its gross inland consumption in KTOE for 2024?"},{"title":"Fuel mix breakdown for policy research","prompt":"Pull the full energy balance for Germany in 2023 with the fuel mix view so I can see how much each energy source contributes to gross inland consumption."},{"title":"Cross-country energy production comparison","prompt":"Get me primary energy production figures in terajoules for France for 2024 — I'm comparing it to other EU countries."}],"resultDescription":"A JSON object containing the requested country code, the endpoint name, an availability flag, key energy balance metrics (primary production and gross inland consumption with unit and period), and a derived import dependency percentage. Optionally includes a fuel-mix breakdown by SIEC product code when view=mix is specified.","failureModes":["Invalid or unsupported ISO2 country code returns an error or available:false","Unsupported SIEC product code may return empty or error","Data not yet available for the requested period returns available:false or empty metrics","Invalid unit value falls back to default or returns validation error","Missing or failed USDC micropayment (x402) returns HTTP 402 Payment Required"],"whenToPreferThis":"Choose this endpoint when you need structured Eurostat energy balance data for a specific EU country, including primary production, gross inland consumption, and import dependency metrics. It is ideal for energy policy research, sustainability reporting, country-level comparisons, and automated analytics pipelines that require machine-readable Eurostat data with optional fuel-mix granularity. Prefer it over scraping Eurostat directly when you need clean, pre-parsed JSON with derived metrics like import dependency percentage.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T18:31:37.611Z","isFirstParty":false,"canonicalSlug":"datanexusai-energy-balance-api-762014a9"}