Place, modify or cancel a bid

Initial bids must be placed at least 24 hours before the start of the trading day for Leap’s Pay-as-Bid auction.

Bids are sets of pairs (Price, Capacity) from which a bid curve is constructed. The bid curve is the function of the form Price = F(Capacity) which determines at which price a demand response provider is willing to curtail a certain volume of load.

Example: A storage provider is bidding in capacity. A sample bid for a given hour may have the form shown below:

Price ($/kWh) - Capacity (kW) 0.18 $/kWh - 40 kW 0.24 $/kWh - 80 kW 0.28 $/kWh - 200 kW

According to this bid, the provider is willing to curtail the first 40kW of load for 18 cents per kWh. If a greater volume is needed, the same provider is willing to curtail any amount of energy from zero up to 80 kW at $0.24/kWh, up to 200 kW for $0.28/kWh.

General guidelines All datetimes must be provided in the UTC timezone

Modifying bids Bids can be modified by placing a new bid for the same meter/timeslot combination. The previous curve will be completely replaced by the new curve.

Cancelling bids A bid can be cancelled until the market closes. Cancel a bid by submitting an empty curve for a meter/timeslot combination.

Path Params
uuid
required

The UUID of your account

Body Params

The bid to be submitted for this account

string
enum
required

The currency to use for the trade

Allowed:
bids
array of objects
required
length ≥ 1

The list of bids to submit into the market.

bids*
uuid
required

The unique identifier of a meter

string
enum

This can have the value "day-head" or "hour-ahead". It is used to decide the appropriate market to bid in.

Allowed:
timeslots
array of objects
required
length ≥ 1

A collection of all timeslots of a bid.

timeslots*
date-time
required

The start time of the bid

date-time
required

The end time of the bid

curve
array of objects
required

A list of quantity/price pairs

curve*
Responses

Language
Credentials
Bearer
JWT
URL
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json