naftiko: 1.0.0-alpha2
info:
label: Energy-Charts API
description: '
Timestamp Format Options
When specifying timestamps, you can choose from the following three formats:
- ISO 8601 Format:
- This format includes the full date and time, with an optional timezone
indicator.
- Examples:
2025-01-01T17:00Z (UTC time) 2025-01-01T18:00+01:00
(Local time offset by +01:00)
- Daily Format:
- This format specifies
only the date.
- The start time is assumed to be at 00:00 on the specified date in the local timezone'
tags:
- Energy
- Charts
- Api
- API
created: '2026-05-06'
modified: '2026-05-06'
capability:
consumes:
- type: http
namespace: energy-charts-api
baseUri: https://api.example.com
description: Energy-Charts API HTTP API.
resources:
- name: public-power
path: /public_power
operations:
- name: public-power-public-power-get
method: GET
description: Public Power
inputParameters:
- name: country
in: query
type: string
- name: start
in: query
type: string
- name: end
in: query
type: string
- name: subtype
in: query
type: string
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
- name: public-power-forecast
path: /public_power_forecast
operations:
- name: public-power-forecast-public-power-forecast-get
method: GET
description: Public Power Forecast
inputParameters:
- name: country
in: query
type: string
- name: production_type
in: query
type: string
- name: forecast_type
in: query
type: string
- name: start
in: query
type: string
- name: end
in: query
type: string
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
- name: total-power
path: /total_power
operations:
- name: total-power-total-power-get
method: GET
description: Total Power
inputParameters:
- name: country
in: query
type: string
- name: start
in: query
type: string
- name: end
in: query
type: string
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
- name: installed-power
path: /installed_power
operations:
- name: installed-power-installed-power-get
method: GET
description: Installed Power
inputParameters:
- name: country
in: query
type: string
- name: time_step
in: query
type: string
- name: installation_decommission
in: query
type: boolean
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
- name: price
path: /price
operations:
- name: day-ahead-price-price-get
method: GET
description: Day Ahead Price
inputParameters:
- name: bzn
in: query
type: string
- name: start
in: query
type: string
- name: end
in: query
type: string
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
- name: cbet
path: /cbet
operations:
- name: cross-border-electricity-trading-cbet-get
method: GET
description: Cross Border Electricity Trading
inputParameters:
- name: country
in: query
type: string
- name: start
in: query
type: string
- name: end
in: query
type: string
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
- name: cbpf
path: /cbpf
operations:
- name: cross-border-physical-flows-cbpf-get
method: GET
description: Cross Border Physical Flows
inputParameters:
- name: country
in: query
type: string
- name: start
in: query
type: string
- name: end
in: query
type: string
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
- name: signal
path: /signal
operations:
- name: traffic-signal-signal-get
method: GET
description: Traffic Signal
inputParameters:
- name: country
in: query
type: string
- name: postal_code
in: query
type: string
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
- name: ren-share-forecast
path: /ren_share_forecast
operations:
- name: renewable-share-forecast-ren-share-forecast-get
method: GET
description: Renewable Share Forecast
inputParameters:
- name: country
in: query
type: string
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
- name: ren-share-daily-avg
path: /ren_share_daily_avg
operations:
- name: ren-share-daily-avg-ren-share-daily-avg-get
method: GET
description: Ren Share Daily Avg
inputParameters:
- name: country
in: query
type: string
- name: year
in: query
type: integer
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
- name: solar-share
path: /solar_share
operations:
- name: solar-share-solar-share-get
method: GET
description: Solar Share
inputParameters:
- name: country
in: query
type: string
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
- name: solar-share-daily-avg
path: /solar_share_daily_avg
operations:
- name: solar-share-daily-avg-solar-share-daily-avg-get
method: GET
description: Solar Share Daily Avg
inputParameters:
- name: country
in: query
type: string
- name: year
in: query
type: integer
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
- name: wind-onshore-share
path: /wind_onshore_share
operations:
- name: wind-onshore-share-wind-onshore-share-get
method: GET
description: Wind Onshore Share
inputParameters:
- name: country
in: query
type: string
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
- name: wind-onshore-share-daily-avg
path: /wind_onshore_share_daily_avg
operations:
- name: wind-onshore-share-daily-avg-wind-onshore-share-
method: GET
description: Wind Onshore Share Daily Avg
inputParameters:
- name: country
in: query
type: string
- name: year
in: query
type: integer
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
- name: wind-offshore-share
path: /wind_offshore_share
operations:
- name: wind-offshore-share-wind-offshore-share-get
method: GET
description: Wind Offshore Share
inputParameters:
- name: country
in: query
type: string
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
- name: wind-offshore-share-daily-avg
path: /wind_offshore_share_daily_avg
operations:
- name: wind-offshore-share-daily-avg-wind-offshore-shar
method: GET
description: Wind Offshore Share Daily Avg
inputParameters:
- name: country
in: query
type: string
- name: year
in: query
type: integer
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
- name: frequency
path: /frequency
operations:
- name: frequency-frequency-get
method: GET
description: Frequency
inputParameters:
- name: region
in: query
type: string
- name: start
in: query
type: string
- name: end
in: query
type: string
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
exposes:
- type: rest
port: 8080
namespace: energy-charts-api-rest
description: REST adapter for Energy-Charts API.
resources:
- path: /public_power
name: public-power-public-power-get
operations:
- method: GET
name: public-power-public-power-get
description: Public Power
call: energy-charts-api.public-power-public-power-get
outputParameters:
- type: object
mapping: $.
- path: /public_power_forecast
name: public-power-forecast-public-power-forecast-get
operations:
- method: GET
name: public-power-forecast-public-power-forecast-get
description: Public Power Forecast
call: energy-charts-api.public-power-forecast-public-power-forecast-get
outputParameters:
- type: object
mapping: $.
- path: /total_power
name: total-power-total-power-get
operations:
- method: GET
name: total-power-total-power-get
description: Total Power
call: energy-charts-api.total-power-total-power-get
outputParameters:
- type: object
mapping: $.
- path: /installed_power
name: installed-power-installed-power-get
operations:
- method: GET
name: installed-power-installed-power-get
description: Installed Power
call: energy-charts-api.installed-power-installed-power-get
outputParameters:
- type: object
mapping: $.
- path: /price
name: day-ahead-price-price-get
operations:
- method: GET
name: day-ahead-price-price-get
description: Day Ahead Price
call: energy-charts-api.day-ahead-price-price-get
outputParameters:
- type: object
mapping: $.
- path: /cbet
name: cross-border-electricity-trading-cbet-get
operations:
- method: GET
name: cross-border-electricity-trading-cbet-get
description: Cross Border Electricity Trading
call: energy-charts-api.cross-border-electricity-trading-cbet-get
outputParameters:
- type: object
mapping: $.
- path: /cbpf
name: cross-border-physical-flows-cbpf-get
operations:
- method: GET
name: cross-border-physical-flows-cbpf-get
description: Cross Border Physical Flows
call: energy-charts-api.cross-border-physical-flows-cbpf-get
outputParameters:
- type: object
mapping: $.
- path: /signal
name: traffic-signal-signal-get
operations:
- method: GET
name: traffic-signal-signal-get
description: Traffic Signal
call: energy-charts-api.traffic-signal-signal-get
outputParameters:
- type: object
mapping: $.
- path: /ren_share_forecast
name: renewable-share-forecast-ren-share-forecast-get
operations:
- method: GET
name: renewable-share-forecast-ren-share-forecast-get
description: Renewable Share Forecast
call: energy-charts-api.renewable-share-forecast-ren-share-forecast-get
outputParameters:
- type: object
mapping: $.
- path: /ren_share_daily_avg
name: ren-share-daily-avg-ren-share-daily-avg-get
operations:
- method: GET
name: ren-share-daily-avg-ren-share-daily-avg-get
description: Ren Share Daily Avg
call: energy-charts-api.ren-share-daily-avg-ren-share-daily-avg-get
outputParameters:
- type: object
mapping: $.
- path: /solar_share
name: solar-share-solar-share-get
operations:
- method: GET
name: solar-share-solar-share-get
description: Solar Share
call: energy-charts-api.solar-share-solar-share-get
outputParameters:
- type: object
mapping: $.
- path: /solar_share_daily_avg
name: solar-share-daily-avg-solar-share-daily-avg-get
operations:
- method: GET
name: solar-share-daily-avg-solar-share-daily-avg-get
description: Solar Share Daily Avg
call: energy-charts-api.solar-share-daily-avg-solar-share-daily-avg-get
outputParameters:
- type: object
mapping: $.
- path: /wind_onshore_share
name: wind-onshore-share-wind-onshore-share-get
operations:
- method: GET
name: wind-onshore-share-wind-onshore-share-get
description: Wind Onshore Share
call: energy-charts-api.wind-onshore-share-wind-onshore-share-get
outputParameters:
- type: object
mapping: $.
- path: /wind_onshore_share_daily_avg
name: wind-onshore-share-daily-avg-wind-onshore-share
operations:
- method: GET
name: wind-onshore-share-daily-avg-wind-onshore-share-
description: Wind Onshore Share Daily Avg
call: energy-charts-api.wind-onshore-share-daily-avg-wind-onshore-share-
outputParameters:
- type: object
mapping: $.
- path: /wind_offshore_share
name: wind-offshore-share-wind-offshore-share-get
operations:
- method: GET
name: wind-offshore-share-wind-offshore-share-get
description: Wind Offshore Share
call: energy-charts-api.wind-offshore-share-wind-offshore-share-get
outputParameters:
- type: object
mapping: $.
- path: /wind_offshore_share_daily_avg
name: wind-offshore-share-daily-avg-wind-offshore-shar
operations:
- method: GET
name: wind-offshore-share-daily-avg-wind-offshore-shar
description: Wind Offshore Share Daily Avg
call: energy-charts-api.wind-offshore-share-daily-avg-wind-offshore-shar
outputParameters:
- type: object
mapping: $.
- path: /frequency
name: frequency-frequency-get
operations:
- method: GET
name: frequency-frequency-get
description: Frequency
call: energy-charts-api.frequency-frequency-get
outputParameters:
- type: object
mapping: $.
- type: mcp
port: 9090
namespace: energy-charts-api-mcp
transport: http
description: MCP adapter for Energy-Charts API for AI agent use.
tools:
- name: public-power-public-power-get
description: Public Power
hints:
readOnly: true
destructive: false
idempotent: true
call: energy-charts-api.public-power-public-power-get
with:
country: tools.country
start: tools.start
end: tools.end
subtype: tools.subtype
inputParameters:
- name: country
type: string
description: country
- name: start
type: string
description: start
- name: end
type: string
description: end
- name: subtype
type: string
description: subtype
outputParameters:
- type: object
mapping: $.
- name: public-power-forecast-public-power-forecast-get
description: Public Power Forecast
hints:
readOnly: true
destructive: false
idempotent: true
call: energy-charts-api.public-power-forecast-public-power-forecast-get
with:
country: tools.country
production_type: tools.production_type
forecast_type: tools.forecast_type
start: tools.start
end: tools.end
inputParameters:
- name: country
type: string
description: country
- name: production_type
type: string
description: production_type
- name: forecast_type
type: string
description: forecast_type
- name: start
type: string
description: start
- name: end
type: string
description: end
outputParameters:
- type: object
mapping: $.
- name: total-power-total-power-get
description: Total Power
hints:
readOnly: true
destructive: false
idempotent: true
call: energy-charts-api.total-power-total-power-get
with:
country: tools.country
start: tools.start
end: tools.end
inputParameters:
- name: country
type: string
description: country
- name: start
type: string
description: start
- name: end
type: string
description: end
outputParameters:
- type: object
mapping: $.
- name: installed-power-installed-power-get
description: Installed Power
hints:
readOnly: true
destructive: false
idempotent: true
call: energy-charts-api.installed-power-installed-power-get
with:
country: tools.country
time_step: tools.time_step
installation_decommission: tools.installation_decommission
inputParameters:
- name: country
type: string
description: country
- name: time_step
type: string
description: time_step
- name: installation_decommission
type: boolean
description: installation_decommission
outputParameters:
- type: object
mapping: $.
- name: day-ahead-price-price-get
description: Day Ahead Price
hints:
readOnly: true
destructive: false
idempotent: true
call: energy-charts-api.day-ahead-price-price-get
with:
bzn: tools.bzn
start: tools.start
end: tools.end
inputParameters:
- name: bzn
type: string
description: bzn
- name: start
type: string
description: start
- name: end
type: string
description: end
outputParameters:
- type: object
mapping: $.
- name: cross-border-electricity-trading-cbet-get
description: Cross Border Electricity Trading
hints:
readOnly: true
destructive: false
idempotent: true
call: energy-charts-api.cross-border-electricity-trading-cbet-get
with:
country: tools.country
start: tools.start
end: tools.end
inputParameters:
- name: country
type: string
description: country
- name: start
type: string
description: start
- name: end
type: string
description: end
outputParameters:
- type: object
mapping: $.
- name: cross-border-physical-flows-cbpf-get
description: Cross Border Physical Flows
hints:
readOnly: true
destructive: false
idempotent: true
call: energy-charts-api.cross-border-physical-flows-cbpf-get
with:
country: tools.country
start: tools.start
end: tools.end
inputParameters:
- name: country
type: string
description: country
- name: start
type: string
description: start
- name: end
type: string
description: end
outputParameters:
- type: object
mapping: $.
- name: traffic-signal-signal-get
description: Traffic Signal
hints:
readOnly: true
destructive: false
idempotent: true
call: energy-charts-api.traffic-signal-signal-get
with:
country: tools.country
postal_code: tools.postal_code
inputParameters:
- name: country
type: string
description: country
- name: postal_code
type: string
description: postal_code
outputParameters:
- type: object
mapping: $.
- name: renewable-share-forecast-ren-share-forecast-get
description: Renewable Share Forecast
hints:
readOnly: true
destructive: false
idempotent: true
call: energy-charts-api.renewable-share-forecast-ren-share-forecast-get
with:
country: tools.country
inputParameters:
- name: country
type: string
description: country
outputParameters:
- type: object
mapping: $.
- name: ren-share-daily-avg-ren-share-daily-avg-get
description: Ren Share Daily Avg
hints:
readOnly: true
destructive: false
idempotent: true
call: energy-charts-api.ren-share-daily-avg-ren-share-daily-avg-get
with:
country: tools.country
year: tools.year
inputParameters:
- name: country
type: string
description: country
- name: year
type: integer
description: year
outputParameters:
- type: object
mapping: $.
- name: solar-share-solar-share-get
description: Solar Share
hints:
readOnly: true
destructive: false
idempotent: true
call: energy-charts-api.solar-share-solar-share-get
with:
country: tools.country
inputParameters:
- name: country
type: string
description: country
outputParameters:
- type: object
mapping: $.
- name: solar-share-daily-avg-solar-share-daily-avg-get
description: Solar Share Daily Avg
hints:
readOnly: true
destructive: false
idempotent: true
call: energy-charts-api.solar-share-daily-avg-solar-share-daily-avg-get
with:
country: tools.country
year: tools.year
inputParameters:
- name: country
type: string
description: country
- name: year
type: integer
description: year
outputParameters:
- type: object
mapping: $.
- name: wind-onshore-share-wind-onshore-share-get
description: Wind Onshore Share
hints:
readOnly: true
destructive: false
idempotent: true
call: energy-charts-api.wind-onshore-share-wind-onshore-share-get
with:
country: tools.country
inputParameters:
- name: country
type: string
description: country
outputParameters:
- type: object
mapping: $.
- name: wind-onshore-share-daily-avg-wind-onshore-share-
description: Wind Onshore Share Daily Avg
hints:
readOnly: true
destructive: false
idempotent: true
call: energy-charts-api.wind-onshore-share-daily-avg-wind-onshore-share-
with:
country: tools.country
year: tools.year
inputParameters:
- name: country
type: string
description: country
- name: year
type: integer
description: year
outputParameters:
- type: object
mapping: $.
- name: wind-offshore-share-wind-offshore-share-get
description: Wind Offshore Share
hints:
readOnly: true
destructive: false
idempotent: true
call: energy-charts-api.wind-offshore-share-wind-offshore-share-get
with:
country: tools.country
inputParameters:
- name: country
type: string
description: country
outputParameters:
- type: object
mapping: $.
- name: wind-offshore-share-daily-avg-wind-offshore-shar
description: Wind Offshore Share Daily Avg
hints:
readOnly: true
destructive: false
idempotent: true
call: energy-charts-api.wind-offshore-share-daily-avg-wind-offshore-shar
with:
country: tools.country
year: tools.year
inputParameters:
- name: country
type: string
description: country
- name: year
type: integer
description: year
outputParameters:
- type: object
mapping: $.
- name: frequency-frequency-get
description: Frequency
hints:
readOnly: true
destructive: false
idempotent: true
call: energy-charts-api.frequency-frequency-get
with:
region: tools.region
start: tools.start
end: tools.end
inputParameters:
- name: region
type: string
description: region
- name: start
type: string
description: start
- name: end
type: string
description: end
outputParameters:
- type: object
mapping: $.