{"uid":"cap_reoq9fbdvBNm4OUiHEV0b","slug":"datanexusai-energy-changes-by-country-df2b5a86","name":"DataNexusAI Energy Changes 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/changes/%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","required":["from","to"],"properties":{"to":{"type":"string","example":"2024","description":"Compare year YYYY"},"from":{"type":"string","example":"2020","description":"Base year YYYY"},"siec":{"type":"string","example":"TOTAL","description":"Balance product (default TOTAL)."},"unit":{"type":"string","example":"KTOE","description":"Balance unit (default KTOE)."},"scope":{"type":"string","example":"both","description":"balance | electricity | both (default both)."},"electricity_siec":{"type":"string","example":"E7000","description":"Electricity product (default E7000)."},"electricity_unit":{"type":"string","example":"GWH","description":"Electricity unit when scope includes electricity (default GWH)."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"geo":"BG","balance":{"metrics":{"primary_production":{"to":{"unit":"KTOE","value":11000,"period":"2024"},"from":{"unit":"KTOE","value":10000,"period":"2020"},"direction":"up","abs_change":1000,"pct_change":10}}},"endpoint":"energy_changes","available":true,"to_period":"2024","electricity":{"metrics":{"gross_production":{"direction":"up","pct_change":5.2}}},"from_period":"2020"}},"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_ndLlmuEgk7kVl23bgXD75","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 year-over-year changes in energy balance and electricity metrics for a specified EU/EEA country between two years.","exampleAgentPrompt":"Show me how Bulgaria's total energy balance and electricity production changed between 2020 and 2024, using KTOE for the balance and GWH for electricity.","exampleUseCases":[{"title":"Tracking national energy transition progress","prompt":"How has Germany's electricity generation changed between 2018 and 2023? I want to see both the balance and electricity metrics in KTOE and GWH respectively."},{"title":"EU energy policy research comparison","prompt":"Can you pull the year-over-year energy balance changes for Poland from 2015 to 2022, total energy products, in KTOE — I need to see whether production went up or down and by how much."},{"title":"Investment due diligence on renewable growth","prompt":"I'm looking at Romania's energy sector — can you compare their gross electricity production between 2019 and 2024 and tell me the percentage change and direction?"}],"resultDescription":"A JSON object containing the country code, from/to period labels, and nested metrics for both the energy balance and electricity scope. Each metric includes the base and comparison period values with units, the direction of change (up/down), absolute change, and percentage change. Availability flag indicates whether data exists for the requested parameters.","failureModes":["Invalid or unsupported ISO2 country code returns an error or empty result","Missing required 'from' or 'to' query parameters causes a 400 or validation error","Requested year range has no available Eurostat data for the given country or SIEC product","Unsupported SIEC or unit code results in no metrics returned","Payment not settled (x402) returns 402 Payment Required before data is served"],"whenToPreferThis":"Choose this endpoint when you need computed year-over-year energy change metrics (absolute and percentage deltas, direction) for a specific EU/EEA country sourced from Eurostat, rather than raw time-series data. Ideal for dashboards, policy analysis, or investment research where the delta between two specific years matters more than the full historical series. Prefer over raw Eurostat queries when you want pre-computed comparisons with both energy balance and electricity scope in a single call.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-10T06:45:22.616Z","isFirstParty":false,"canonicalSlug":"datanexusai-energy-changes-by-country-df2b5a86"}