{"uid":"cap_25fEo_4qlx0elrHQcaHVo","slug":"datanexusai-energy-rankings-c0598a78","name":"DataNexusAI Energy Rankings","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/rankings?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"},"queryParams":{"type":"object","required":["metric"],"properties":{"geos":{"type":"string","example":"BG,RO,EL,DE","description":"Optional comma-separated ISO2 list (default EU27)."},"limit":{"type":"integer","example":27,"description":"Max rows (default 40)."},"metric":{"type":"string","example":"import_dependency_pct","description":"Ranking metric id"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"metric":"import_dependency_pct","endpoint":"energy_rankings","rankings":[{"geo":"MT","rank":1,"value":97.5,"percentile":100}]}},"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_jgnBjofNYuOnK7qz-W5_7","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 ranked EU country energy metric scores (e.g. import dependency percentage) with rank, value, and percentile for each country.","exampleAgentPrompt":"Show me the EU country rankings for import_dependency_pct — include only Bulgaria, Romania, Greece, and Germany, and limit the results to 4 rows.","exampleUseCases":[{"title":"EU energy vulnerability policy briefing","prompt":"I need a ranking of all EU27 countries by energy import dependency percentage — who is most exposed and who is most self-sufficient?"},{"title":"Targeted comparison of eastern EU energy metrics","prompt":"Can you pull the energy import dependency rankings just for Bulgaria, Romania, Greece, and Hungary and tell me how they stack up against each other?"},{"title":"Top-10 energy metric leaderboard","prompt":"Give me the top 10 EU countries ranked by import_dependency_pct so I can put together a quick league table for my energy research report."}],"resultDescription":"A JSON object containing the metric name queried, the endpoint label, and a ranked list of country entries each with geo (ISO2 code), rank (integer), value (numeric metric score), and percentile (0–100). Results are sorted by rank ascending.","failureModes":["Invalid or unrecognized metric ID returns an error or empty rankings list","Unrecognized ISO2 country codes in the geos parameter may silently filter those countries out","Payment failure (x402) if USDC micropayment is not properly authorized returns HTTP 402","Rate limiting or quota errors if too many calls are made in quick succession","Network timeout for large result sets if limit is very high"],"whenToPreferThis":"Use this endpoint when you need cross-country comparative energy rankings from Eurostat data — particularly import dependency or similar EU energy indicators — and want pre-computed rank and percentile values rather than raw time-series figures. It is especially useful when building policy briefings, investment research, or dashboards that require quick country-level comparisons. Prefer this over raw Eurostat APIs when you want ranked, normalized output in a single call with micropayment access rather than navigating complex SDMX queries.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T18:37:54.960Z","isFirstParty":false,"canonicalSlug":"datanexusai-energy-rankings-c0598a78"}