API reference
Run API demo
Run a simplified version of our API against a simulated asset under real market conditions. No integration needed. Make the right calls and see what you could have earned on the market today!
Your starting point
BESS_01 is a 10 MW, 20 MWh battery already integrated into the EBX Platform, with live and steady telemetry. It is prequalified for negative aFRR only, so you earn money by absorbing energy from the grid.
How our market simulation worksRead this firstHide
The demo replays two real days of the German aFRR market. Here's how that works:
Why we replay past days: capacity is auctioned and cleared the day before delivery, energy bids close only 25 minutes before each 15-minute delivery period, and activation happens in real time within it. A complete set of real results therefore exists only once the delivery day has passed. Replaying dates in the past (5 and 6 August) lets us demo genuine market outcomes straight away.
Step 1
Check your asset status
Everything starts from the physical state of your asset. Read how much power and energy it has available before you commit anything to the market.
Check the asset
How does this work?
Available charging power and headroom are the physical ceiling on what you can offer: power caps the MW per block, headroom caps the MWh you can charge before the battery is full.
Step 2
Bid in the market
Bid negative aFRR capacity, then energy in the blocks you win. You can only offer what your asset is able to deliver, so its available power is your upper limit here. Finding the most profitable bid within that limit is a complex optimisation problem in practice.
Bid aFRR capacity
How does this work?
Each block has a marginal price: you win wherever your bid is at or below it. German aFRR capacity is pay-as-bid, so you are paid your own price: bidding low wins more blocks but earns less per MW.
YOUR INPUT
Set a capacity price and the power you offer for each 4-hour block. Use the reference prices above as a guide.
A bid is a commitment. Once a block is awarded the TSO can call your full offered power for all four hours, so every block you bid counts here in full, whether or not it is actually called.
Read the auction results
How does this work?
Your bids against the real marginal price of each block, as cleared on the day. You win every block where your price is at or below it, and are paid your own bid price for the capacity you reserved.
Bid aFRR energy
How does this work?
A capacity award obliges you to offer energy in those blocks, at their full awarded power. The TSO activates the cheapest offers first, so a lower price means more activations and more MWh charged. Energy is paid at the period's marginal price. In reality you bid per 15-minute period; this demo simplifies that to one average price per 4-hour block.
YOUR INPUT
Set an energy price for every block you were awarded. An award obliges its full power in every quarter-hour. Blocks you did not win are locked.
A bid is a commitment. Once a block is awarded the TSO can call your full offered power for all four hours, so every block you bid counts here in full, whether or not it is actually called.
Step 3
Deliver & Monitor
Inside each awarded block, energy bids close 25 minutes before delivery, and the TSO activates your asset in real time when the grid needs it. EBX runs this end to end, so all that is left for you is to read the results and check the state your asset ends the day in.
Read the activations
How does this work?
Your bids against the real activations on the delivery day. You are called wherever your bid is at or below the activation price, and paid that marginal price. In reality you bid per 15-minute period; this demo simplifies that to one price per 4-hour block.
Check the asset again
How does this work?
Every activation charges the battery. What the API returns here is where the day leaves you: the headroom you have left is the ceiling on tomorrow’s bids, and every MWh cycled through the battery counts toward its degradation. The ideal optimisation maximises revenue per cycle.
Step 4
Settle
One day after delivery, EBX publishes preliminary figures per market. The official TSO settlement can take up to a month to arrive.
Check the settlement
How does this work?
Capacity is paid for the award whether or not you were activated; energy is paid for what you actually delivered. Quality deductions appear only after a delivery break.