[GET] https://api.terna.it/market/v1.0/output/costs
These are the UP (SELL) and DOWN (BUY) costs and their totals, over the various market sessions. UP costs will be equal to the sum of the products of the quantities accepted to rise by the relative 'bid' prices, as a result of each market session.DOWN costs will be equal to the sum of the products of the accepted quantities going down by the relative 'offered' prices, as a result of each market session. TOTAL costs will be equal to the difference between UP costs and DOWN costs, as a result of each market session.
Authorization OAuth
2.0
Request Header
Query Params
API field |
Type |
Description |
Format |
Card |
Example |
dateFrom
|
string |
Format dd/mm/yyyy |
|
1..1 |
|
dateTo
|
string |
Format dd/mm/yyyy |
|
1..1 |
|
sessionType
|
string |
If not entered, the filter is not applied and all types will be considered an error |
|
1..1 |
|
direction
|
string |
If not entered, the filter is not applied and all types will be considered an error |
|
0..1 |
|
Response Structure 200
API field |
Type |
Description |
Format |
Card |
Example |
result
|
|
|
|
0..1 |
|
.messagge
|
string |
|
|
0..1 |
OK |
.status
|
string |
|
|
0..1 |
Completed |
costs
|
array |
|
|
0..n |
|
.reference_date
|
string |
|
|
0..1 |
2023-10-24 |
.date_tz
|
string |
|
|
0..1 |
Europe/Rome |
.offset |
string |
|
|
0..1 |
+02:00 |
.zone
|
string |
|
|
0..1 |
Calabria |
.session_type
|
string |
|
|
0..1 |
MSD1 |
.direction
|
string |
|
|
0..1 |
UP |
.cost_euro
|
string |
|
|
0..1 |
32767 |
Response Structure 406
API field |
Type |
Description |
Format |
Card |
Example |
result
|
|
|
|
0..1 |
|
.messagge
|
string |
|
|
0..1 |
Input Validation Error: the value entered is incorrect or does not conform to the expected format. Value entered: 200 |
.status
|
string |
|
|
0..1 |
ERROR |
Response Structure 500
API field |
Type |
Description |
Format |
Card |
Example |
result
|
|
|
|
0..1 |
|
.messagge
|
string |
|
|
0..1 |
Information retrieval error |
.status
|
string |
|
|
0..1 |
ERROR |
Example
curl --location --request GET 'https://api.terna.it/market/v1.0/output/costs?dateFrom=22/11/23&dateTo=22/11/23&sessionType=MSD1&direction=UP' --header 'Authorization: <token>'
Response
{
"result": {
"message": "string",
"status": "string"
},
"costs": [
{
"reference_date": "string",
"date_tz": "string",
"offset": "string",
"zone": "string",
"session_type": "string",
"direction": "string",
"cost_euro": "string"
}
]
}