Get all ancillary bids for a given virtual asset and interval.

curl --request GET \
  --url https://api.trlyr.com/organisations/{organisationID}/virtual-assets/{virtualAssetID}/ancillary/bids \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '{}'

import requests

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

payload = {}
headers = {
    "Authorization": "<authorization>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'GET',
  headers: {Authorization: '<authorization>', 'Content-Type': 'application/json'},
  body: JSON.stringify({})
};

fetch('https://api.trlyr.com/organisations/{organisationID}/virtual-assets/{virtualAssetID}/ancillary/bids', 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/bids",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_POSTFIELDS => json_encode([
    
  ]),
  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/bids"

	payload := strings.NewReader("{}")

	req, _ := http.NewRequest("GET", 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.get("https://api.trlyr.com/organisations/{organisationID}/virtual-assets/{virtualAssetID}/ancillary/bids")
  .header("Authorization", "<authorization>")
  .header("Content-Type", "application/json")
  .body("{}")
  .asString();

require 'uri'
require 'net/http'

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

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

request = Net::HTTP::Get.new(url)
request["Authorization"] = '<authorization>'
request["Content-Type"] = 'application/json'
request.body = "{}"

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

[
  {
    "deliveryDay": "2025-11-11",
    "market": "AFRRCapacity",
    "product": "POS_00_04",
    "bids": [
      {
        "bidID": "11111111-1111-1111-1111-111111111111",
        "offeredCapacity": 1000,
        "status": "submitted",
        "capacityPrice": 100.5,
        "energyPrice": 100.5,
        "unavailabilities": [
          {
            "end": "2025-06-15T10:00:00Z",
            "start": "2025-06-15T10:00:00Z",
            "volume": 123
          }
        ]
      }
    ]
  }
]

ancillary

Get all ancillary bids for a given virtual asset and interval.

Gets all ancillary bids for a given virtual asset and time interval

Query Parameters

Required query parameters:

start: Start specifies the start of the time interval for which to retrieve bids, e.g. 2025-06-17T12:00:00Z (RFC3339 in UTC).

end: End specifies the end of the time interval for which to retrieve bids, e.g. 2025-06-18T12:00:00Z (RFC3339 in UTC).

Optional query parameters:

markets: Returns bids for requested markets as a comma separated string, e.g. FCR,AFRREnergy. If not set, returns all markets. Available options (case sensitive): FCR, AFRREnergy, AFRRCapacity.

productDirections: Returns bids for requested product directions as a comma separated string, e.g. NEGPOS,POS. If not set, returns all product directions. Available options (case sensitive): POS, NEG, NEGPOS.

Response format

Returns a JSON representation of the ancillary bids for the given time interval and virtual asset as a list. The following fields are provided:

market: The market of the bid, one of: FCR, AFRREnergy, AFRRCapacity.

product: The product of the bid, e.g. NEGPOS_00_04 (FCR), POS_00_04 (AFRR Capacity), POS_001 (AFRR Energy).

deliveryDay: The delivery day of the bid in the format YYYY-MM-DD, e.g. 2026-05-30 (full day according to RFC3339).

bids: A list of individual bids for the product.

Each bid in the list contains the following fields whose contents can vary depending on the market:

bidID: The ID of the bid.

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

capacityPrice:

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.
FCR: The capacity price of the bid in EUR/MW, 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 an 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.
FCR: This field is null.

status: The status of the bid, one of: pending, submitted. submitted confirms that the bid has been placed successfully with the TSO. pending indicates that the process of placing the bid with the TSO is still in progress. While a bid has status pending, it cannot be updated to avoid double bidding.

unavailabilities: During a period of unavailability, a bid may need to be reduced in its power capacity to still be deliverable by the virtual asset. The unavailability can cover the whole delivery period of a bid, or only a section of it. Moreover, capacity products may be affected by more than one unavailability event with different unavailable volumes. The following fields are provided for each bid unavailability:

start: The start of the unavailability period.
end: The end of the unavailability period.
volume: The unavailable power volume in kW. The remaining power of the bid can be calculated the following way: offeredCapacity - volume. Notably, if a bid has already received a result, the unavailable volume must be deducted from the acceptedCapacity of the result instead. The unavailable volume will then be backed up by terralayr via our pool provider.

Behaviour during unavailability

If a virtual asset is affected by an unavailability, we will:

1, Add unavailabilities to both the bid and the result which are then returned with every GET request. See above for the details.

2, Adjust the ancillary commitments timeseries so it matches the reduced bid power capacities.

Notably, reducing ancillary power capacities is always a last resort action: We will first fully reduce the available wholesale capacity before touching the ancillary bids.

To be informed about the state of your ancillary commitments and the available wholesale capacity, make sure to always monitor the following operational data categories: afrrPosCommitment, afrrNegCommitment, fcrCommitment, wholesalePowerCapacityChargeAvailable, wholesalePowerCapacityDischargeAvailable.

GET

organisations

{organisationID}

virtual-assets

{virtualAssetID}

ancillary

bids

Get all ancillary bids for a given virtual asset and interval.

curl --request GET \
  --url https://api.trlyr.com/organisations/{organisationID}/virtual-assets/{virtualAssetID}/ancillary/bids \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '{}'

import requests

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

payload = {}
headers = {
    "Authorization": "<authorization>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'GET',
  headers: {Authorization: '<authorization>', 'Content-Type': 'application/json'},
  body: JSON.stringify({})
};

fetch('https://api.trlyr.com/organisations/{organisationID}/virtual-assets/{virtualAssetID}/ancillary/bids', 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/bids",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_POSTFIELDS => json_encode([
    
  ]),
  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/bids"

	payload := strings.NewReader("{}")

	req, _ := http.NewRequest("GET", 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.get("https://api.trlyr.com/organisations/{organisationID}/virtual-assets/{virtualAssetID}/ancillary/bids")
  .header("Authorization", "<authorization>")
  .header("Content-Type", "application/json")
  .body("{}")
  .asString();

require 'uri'
require 'net/http'

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

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

request = Net::HTTP::Get.new(url)
request["Authorization"] = '<authorization>'
request["Content-Type"] = 'application/json'
request.body = "{}"

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

[
  {
    "deliveryDay": "2025-11-11",
    "market": "AFRRCapacity",
    "product": "POS_00_04",
    "bids": [
      {
        "bidID": "11111111-1111-1111-1111-111111111111",
        "offeredCapacity": 1000,
        "status": "submitted",
        "capacityPrice": 100.5,
        "energyPrice": 100.5,
        "unavailabilities": [
          {
            "end": "2025-06-15T10:00:00Z",
            "start": "2025-06-15T10:00:00Z",
            "volume": 123
          }
        ]
      }
    ]
  }
]

Headers

Authorization

string

default:Bearer <access token value>

required

Access token

Path Parameters

organisationID

string

required

Organisation ID

virtualAssetID

string

required

Virtual Asset ID

Query Parameters

start

string

required

Query start time

end

string

required

Query end time

markets

string

Selected markets

productDirections

string

Selected product directions

Body

application/json

The body is of type object.

Response

deliveryDay

string

required

Example:

"2025-11-11"

market

string

required

Example:

"AFRRCapacity"

product

string

required

Example:

"POS_00_04"

bids

object[]

Hide child attributes

bids.bidID

string<uuid>

required

Example:

"11111111-1111-1111-1111-111111111111"

bids.offeredCapacity

number<float>

required

In kW

Example:

1000

bids.status

string

required

Example:

"submitted"

bids.capacityPrice

number<float>

In EUR/MW/h (AFRR Capacity) or EUR/MW (FCR)

Example:

100.5

bids.energyPrice

number<float>

In EUR/MWh (AFRR Capacity and AFRR Energy only)

Example:

100.5

bids.unavailabilities

object[]

Hide child attributes

bids.unavailabilities.end

string<dateTime>

Example:

"2025-06-15T10:00:00Z"

bids.unavailabilities.start

string<dateTime>

Example:

"2025-06-15T10:00:00Z"

bids.unavailabilities.volume

number

API documentation

Auth API

Virtual Assets API

Auctions API

Revenue Reporting API

Physical Asset Management API

Asset Monitoring API

Get all ancillary bids for a given virtual asset and interval.

Gets all ancillary bids for a given virtual asset and time interval

Query Parameters

Response format

Behaviour during unavailability

Headers

Path Parameters

Query Parameters

Body

Response