Update aFRR bids for a single product and delivery day.

curl --request PUT \
  --url https://api.trlyr.com/organisations/{organisationID}/virtual-assets/{virtualAssetID}/ancillary/afrr/bids/{productDateCode} \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '
[
  {
    "offeredCapacity": 1000,
    "capacityPrice": 100.5,
    "energyPrice": 100.5
  }
]
'

import requests

url = "https://api.trlyr.com/organisations/{organisationID}/virtual-assets/{virtualAssetID}/ancillary/afrr/bids/{productDateCode}"

payload = [
    {
        "offeredCapacity": 1000,
        "capacityPrice": 100.5,
        "energyPrice": 100.5
    }
]
headers = {
    "Authorization": "<authorization>",
    "Content-Type": "application/json"
}

response = requests.put(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PUT',
  headers: {Authorization: '<authorization>', 'Content-Type': 'application/json'},
  body: JSON.stringify([{offeredCapacity: 1000, capacityPrice: 100.5, energyPrice: 100.5}])
};

fetch('https://api.trlyr.com/organisations/{organisationID}/virtual-assets/{virtualAssetID}/ancillary/afrr/bids/{productDateCode}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.trlyr.com/organisations/{organisationID}/virtual-assets/{virtualAssetID}/ancillary/afrr/bids/{productDateCode}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_POSTFIELDS => json_encode([
    [
        'offeredCapacity' => 1000,
        'capacityPrice' => 100.5,
        'energyPrice' => 100.5
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: <authorization>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.trlyr.com/organisations/{organisationID}/virtual-assets/{virtualAssetID}/ancillary/afrr/bids/{productDateCode}"

	payload := strings.NewReader("[\n  {\n    \"offeredCapacity\": 1000,\n    \"capacityPrice\": 100.5,\n    \"energyPrice\": 100.5\n  }\n]")

	req, _ := http.NewRequest("PUT", url, payload)

	req.Header.Add("Authorization", "<authorization>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.put("https://api.trlyr.com/organisations/{organisationID}/virtual-assets/{virtualAssetID}/ancillary/afrr/bids/{productDateCode}")
  .header("Authorization", "<authorization>")
  .header("Content-Type", "application/json")
  .body("[\n  {\n    \"offeredCapacity\": 1000,\n    \"capacityPrice\": 100.5,\n    \"energyPrice\": 100.5\n  }\n]")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.trlyr.com/organisations/{organisationID}/virtual-assets/{virtualAssetID}/ancillary/afrr/bids/{productDateCode}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Put.new(url)
request["Authorization"] = '<authorization>'
request["Content-Type"] = 'application/json'
request.body = "[\n  {\n    \"offeredCapacity\": 1000,\n    \"capacityPrice\": 100.5,\n    \"energyPrice\": 100.5\n  }\n]"

response = http.request(request)
puts response.read_body

[
  {
    "deliveryDay": "2025-11-11",
    "product": "POS_00_04",
    "productDateCode": "2025-11-11_POS_00_04",
    "bids": [
      {
        "offeredCapacity": 1000,
        "capacityPrice": 100.5,
        "energyPrice": 100.5
      }
    ]
  }
]

afrr

Update aFRR bids for a single product and delivery day.

Updates an aFRR product bid for a virtual asset

The endpoint expects a list of bids for a single product and delivery day. For now, only a single bid per product is allowed.

If one (or more) bids have already been submitted for the product, they will be replaced by the newer submission.

Path parameters

productDateCode:

The product date code identifies a single product and delivery day pair: YYYY-MM-DD_{{productName}}.

The delivery day inside the productDateCode path parameter must be in the following format: YYYY-MM-DD, e.g. 2025-01-01 (full day according to RFC3339).

All submitted bids for this product are updated. Previous bids are deleted.

Examples:

aFRR Energy: 2025-01-01_POS_001.
aFRR Capacity: 2025-01-01_POS_00_04.

Request body

The request body is a list of bids to be placed for the selected product and delivery day. It contains the following fields:

offeredCapacity:

The offered capacity of the bid in kilowatts, e.g. 2000.

The value must be an integer multiple of 1 megawatt. Any non-integral part will be rounded down, e.g. 1000.5 is accepted and rounded down to 1000kW, whereas 1500 would be rejected.

capacityPrice:

The max price that can be bid into both markets is 15,000 Euros, the min price is -15,000 Euros. If you bid a positive price (> 0), you will be paid by the TSO. If you bid a negative price (< 0), you pay the TSO.

aFRR Energy: This field is null.
aFRR Capacity: The capacity price of the bid in EUR/MW/h, e.g. 100.00. This price is used to determine the position of the bid in the TSO’s merit order.

energyPrice:

aFRR Energy: The energy price of the bid in EUR/MWh, e.g. 100.00. This price is used to determine the position of the bid in the TSO’s merit order.
aFRR Capacity: The energy price of the 16 implicit aFRR Energy bids in EUR/MWh, e.g. 100.00. When submitting a bid into the aFRR Capacity market, it is mandatory to place 16 implicit aFRR Energy bids covering the 4-hour duration of the Capacity bid. This is done by providing a mandatory energyPrice on each Capacity bid. Each of the 16 Energy bids will have the same offeredCapacity as the corresponding Capacity bid. These Energy bids can still be updated after the Capacity bid has received a result. However, if the Capacity bid was accepted, the offeredCapacity of the Energy bids cannot be reduced. If the Capacity bid is rejected, the implicit Energy bids are also rejected.

Bidding deadlines

aFRR Energy

All bids must be placed before the following deadline: 30 minutes before the delivery period, e.g. a bid for delivery period 15:30pm must be submitted by 15:00pm. Moreover, bids must be placed after 12:00pm CET/CEST on the day before delivery. If bids are made before that time, they are rejected.

aFRR Capacity

All bids must be placed before the following deadline: 8:40am CET/CEST on the day before delivery. The auction opens a week before the delivery day.

Determining available bidding capacity

Validation 1 and 2 must be passed, or the bid will be rejected.

Validation 1: Available positive and negative aFRR timeseries

The offeredCapacity for aFRR bids at any given point in time must be lower than or equal to the available positive or negative capacity for aFRR of the virtual asset.

The value can be retrieved from the operationalData endpoint on the virtual asset as a 15 minute timeseries by requesting the operational data category afrrNegCapacityAvailable and afrrPosCapacityAvailable respectively.

Example:

afrrPosCapacityAvailable from 00:00-04:00 am: 4000 kW
afrrNegCapacityAvailable from 00:00-04:00 am: 5000 kW
Remaining capacity for product POS_00_04: 4000 kW
Remaining capacity for products POS_001-POS_016: 4000 kW
Remaining capacity for product NEG_00_04: 5000 kW
Remaining capacity for products NEG_001-NEG_016: 5000 kW

Validation 2: Max total ancillary capacity timeseries

The offeredCapacity for aFRR bids at any given point in time must also take into account bids that have already been placed in the FCR market for the same period so as not to exceed the max total ancillary capacity of the virtual asset.

An FCR bid has both a positive and negative product direction and therefore reduces the available max total capacity in both directions.

The max total ancillary capacity can be retrieved from the operationalData endpoint on the virtual asset as a 15 minute timeseries by requesting the operational data category maxTotalAncillaryCapacityChargeAvailable (negative direction) and maxTotalAncillaryCapacityDischargeAvailable (positive direction) respectively.

Example:

maxTotalAncillaryCapacityDiscargeAvailable: 5000 kW
maxTotalAncillaryCapacityChargeAvailable: 4000 kW
FCR bid placed for product NEGPOS_00_04: 3000 kW
Remaining capacity for product POS_00_04: 2000 kW (5000 - 3000)
Remaining capacity for products POS_001-POS_016: 2000 kW (5000 - 3000)
Remaining capacity for product NEG_00_04: 1000 kW (5000 - 4000)
Remaining capacity for products NEG_001-NEG_016: 1000 kW (5000 - 4000)

Deleting bids

To delete a bid, set the body with 0 values:

[
  {
    "capacityPrice": 0,
    "energyPrice": 0,
    "offeredCapacity": 0
  }
]

Adjustment of virtual asset blocks

Once a valid product bid has been submitted, a new aFRR block ("market":"AFRR") is added to the virtual asset.

The block will cover the duration of the whole virtual asset.

Inside the block’s power capacity timeseries, the powerCapacity is updated to value of the bid’s offeredCapacity for the delivery period of the product you bid on.

At the same time, the powerCapacity of the wholesale block ("market":"WHOLESALE") for the delivery period of the product you bid on is reduced by the offeredCapacity.

Both the aFRR and the wholesale block will be adjusted according to the incoming bid results.

E.g. if a bid is rejected, the powerCapacity is removed from the aFRR block and added to the wholesale block.

Response format

Returns a JSON representation of the created aFRR product bids identical to the response body of the POST aFRR bids endpoint.

PUT

organisations

{organisationID}

virtual-assets

{virtualAssetID}

ancillary

afrr

bids

{productDateCode}

Update aFRR bids for a single product and delivery day.

curl --request PUT \
  --url https://api.trlyr.com/organisations/{organisationID}/virtual-assets/{virtualAssetID}/ancillary/afrr/bids/{productDateCode} \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '
[
  {
    "offeredCapacity": 1000,
    "capacityPrice": 100.5,
    "energyPrice": 100.5
  }
]
'

import requests

url = "https://api.trlyr.com/organisations/{organisationID}/virtual-assets/{virtualAssetID}/ancillary/afrr/bids/{productDateCode}"

payload = [
    {
        "offeredCapacity": 1000,
        "capacityPrice": 100.5,
        "energyPrice": 100.5
    }
]
headers = {
    "Authorization": "<authorization>",
    "Content-Type": "application/json"
}

response = requests.put(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PUT',
  headers: {Authorization: '<authorization>', 'Content-Type': 'application/json'},
  body: JSON.stringify([{offeredCapacity: 1000, capacityPrice: 100.5, energyPrice: 100.5}])
};

fetch('https://api.trlyr.com/organisations/{organisationID}/virtual-assets/{virtualAssetID}/ancillary/afrr/bids/{productDateCode}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.trlyr.com/organisations/{organisationID}/virtual-assets/{virtualAssetID}/ancillary/afrr/bids/{productDateCode}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_POSTFIELDS => json_encode([
    [
        'offeredCapacity' => 1000,
        'capacityPrice' => 100.5,
        'energyPrice' => 100.5
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: <authorization>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.trlyr.com/organisations/{organisationID}/virtual-assets/{virtualAssetID}/ancillary/afrr/bids/{productDateCode}"

	payload := strings.NewReader("[\n  {\n    \"offeredCapacity\": 1000,\n    \"capacityPrice\": 100.5,\n    \"energyPrice\": 100.5\n  }\n]")

	req, _ := http.NewRequest("PUT", url, payload)

	req.Header.Add("Authorization", "<authorization>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.put("https://api.trlyr.com/organisations/{organisationID}/virtual-assets/{virtualAssetID}/ancillary/afrr/bids/{productDateCode}")
  .header("Authorization", "<authorization>")
  .header("Content-Type", "application/json")
  .body("[\n  {\n    \"offeredCapacity\": 1000,\n    \"capacityPrice\": 100.5,\n    \"energyPrice\": 100.5\n  }\n]")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.trlyr.com/organisations/{organisationID}/virtual-assets/{virtualAssetID}/ancillary/afrr/bids/{productDateCode}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Put.new(url)
request["Authorization"] = '<authorization>'
request["Content-Type"] = 'application/json'
request.body = "[\n  {\n    \"offeredCapacity\": 1000,\n    \"capacityPrice\": 100.5,\n    \"energyPrice\": 100.5\n  }\n]"

response = http.request(request)
puts response.read_body

[
  {
    "deliveryDay": "2025-11-11",
    "product": "POS_00_04",
    "productDateCode": "2025-11-11_POS_00_04",
    "bids": [
      {
        "offeredCapacity": 1000,
        "capacityPrice": 100.5,
        "energyPrice": 100.5
      }
    ]
  }
]

Headers

Authorization

string

default:Bearer <access token value>

required

Access token

Path Parameters

organisationID

string

required

Organisation ID

virtualAssetID

string

required

Virtual Asset ID

productDateCode

string

default:YYYY-MM-DD_ProductName

required

Bid ID

Body

application/json

AFRR Product Bid Update

offeredCapacity

number<float>

required

In kW

Example:

1000

capacityPrice

number<float>

In EUR/MW/h

Example:

100.5

energyPrice

number<float>

In EUR/MWh

Example:

100.5

Response

deliveryDay

string

required

Example:

"2025-11-11"

product

string

required

Capacity market bid: POS_00_04, Energy market bid: POS_001

Example:

"POS_00_04"

productDateCode

string

required

Capacity market bid: 2025-11-11_POS_00_04, Energy market bid: 2025-11-11_POS_001

Example:

"2025-11-11_POS_00_04"

bids

object[]

Hide child attributes

bids.offeredCapacity

number<float>

required

In kW (must be an integer multiple of 1 megawatt, e.g. 1000, 2000)

Example:

1000

bids.capacityPrice

number<float>

In EUR/MW/h (will be 'null' in energy market bid)

Example:

100.5

bids.energyPrice

number<float>

In EUR/MWh

Example:

100.5

Last modified on August 21, 2026

API documentation

Auth API

Virtual Assets API

Auctions API

Revenue Reporting API

Physical Asset Management API

Asset Monitoring API

Update aFRR bids for a single product and delivery day.

Updates an aFRR product bid for a virtual asset

Path parameters

Request body

Bidding deadlines

aFRR Energy

aFRR Capacity

Determining available bidding capacity

Validation 1: Available positive and negative aFRR timeseries

Validation 2: Max total ancillary capacity timeseries

Deleting bids

Adjustment of virtual asset blocks

Response format

Headers

Path Parameters

Body

Response