Search for bids that match the input filters
| Time | Status | User Agent | |
|---|---|---|---|
| Make a request to see history. |
URL Expired
The URL for this request expired after 30 days.
🚧
CAISO Only & Generally Leap Managed
Submitting bids is only applicable for the CAISO wholesale marketplace. Most partners leverage Leap to manage bids on their behalf based on their dispatch preferences (frequency & timing). However, these bid endpoints are available for partners that would like to manage their own bids.
accountId
uuid
required
The UUID of your account
Filters for searching bids
The request object for searching bids
start_date
date-time
required
Start datetime range to get bids for (inclusive)
end_date
date-time
required
End datetime range to get bids for (inclusive).
End date must be max 24 hours after the start date
meter_ids
array of objects
Meter ids to get bids for. Limited at a 100 meters per request
meter_ids ADD uuid
market_type
string
enum
This can have the value "day-head" or "hour-ahead". It is used to decide the appropriate market to bid in.
day-aheadday-aheadhour-ahead
Allowed:
day-ahead``hour-ahead
page_token
string
Token of the page to request. Use null to request a new batch of results
`` 200 A paginated list of bids that matched the search input
object
The response object for searching bids
next_page_token
string
Token to be used in a subsequent request to get the next batch of results.
null will be returned when the last page of results has been reached.
results
array of objects
required
A list of the bids that were found.
results*
object
All versions of a bid. Note that versioning of bids is deprecated and only a single version of a bid will be returned
meter_id
uuid
The unique identifier of a meter
timeslots
array of objects
A list of all timeslots for this bid
timeslots
object
A specific version of a timeslot. Note that versioning of bids is deprecated and only a single version of a timeslot will be returned
start_time
date-time
required
The start time of the bid
end_time
date-time
required
The end time of the bid
latest_version
integer
required
Indicating the version of the bid. This field has been deprecated and will always return "1".
market_status
string
enum
The status of the internal market
Open- Market is open and accepting new bids, Accepted and Rejected bids can still be updatedProcessing- Market is closed and processing bidsCleared- Market is closed and finished processing, potential dispatches are availableUnknown- The market state is currently unknown
Open``Processing``Cleared``Unknown
versions
array of objects
required
A list of the stored bids. Versioning of bids has been deprecated. This list will only contain the currently active bid.
versions*
object
A version of a bid. Versioning of bids has been deprecated. There will only be a single version active at a given time.
key
integer
The version of the bid. Versioning of bids has been deprecated. The key of this field will always be "1".
value
object
A specific version of a timeslot. Note that versioning of bids is deprecated and only a single version of a timeslot will be returned
value object
market_type
string
enum
This can have the value "day-head" or "hour-ahead". It is used to decide the appropriate market to bid in.
day-ahead``hour-ahead
`` 400 The request could not be parsed or is invalid
`` 401 Unauthorized
`` 403 No access to this resource
`` 404 Resource not found
`` 5XX Unexpected error
Base URL
https://api.staging.leap.energy/v1.1/account/{accountId}/bidding/bids/search
xxxxxxxxxx
curl --request POST \
--url https://api.staging.leap.energy/v1.1/account//bidding/bids/search \
--header 'accept: application/json' \
--header 'content-type: application/json'
xxxxxxxxxx
{
"next_page_token": "<token>",
"results": [
{
"meter_id": "046b6c7f-0b8a-43b9-b35d-6489e6daee91",
"timeslots": [
{
"start_time": "2023-01-28T16:00:00Z",
"end_time": "2023-01-28T17:00:00Z",
"market_status": "Open",
"market_type": "day-ahead",
"latest_version": 1,
"versions": [
{
"value": {
"curve": [
{
"quantity_in_kw": 80,
"price": 0.14
},
{
"quantity_in_kw": 100,
"price": 0.16
}
],
"latest_state_change": "2023-01-24T14:00:00Z",
"date_received": "2023-01-24T12:00:00Z",
"status": "Received"
},
"key": 1
}
]
},
{
"start_time": "2023-01-28T17:00:00Z",
"end_time": "2023-01-28T18:00:00Z",
"market_status": "Open",
"market_type": "day-ahead",
"latest_version": 1,
"versions": [
{
"value": {
"curve": [
{
"quantity_in_kw": 80,
"price": 0.14
},
{
"quantity_in_kw": 100,
"price": 0.16
}
],
"latest_state_change": "2023-01-24T14:00:00Z",
"date_received": "2023-01-24T12:00:00Z",
"status": "Accepted"
},
"key": 1
}
]
}
]
},
{
"meter_id": "4a4b0s0e-0b8a-43b9-b35d-6489e6daee91",
"timeslots": [
{
"start_time": "2023-01-28T16:00:00Z",
"end_time": "2023-01-28T17:00:00Z",
"market_status": "Open",
"market_type": "day-ahead",
"latest_version": 1,
"versions": [
{
"value": {
"curve": [
{
"quantity_in_kw": 80,
"price": 0.14
},
{
"quantity_in_kw": 100,
"price": 0.16
}
],
"latest_state_change": "2023-01-24T14:00:00Z",
"date_received": "2023-01-24T12:00:00Z",
"status": "Received"
},
"key": 1
}
]
},
{
"start_time": "2023-01-28T17:00:00Z",
"end_time": "2023-01-28T18:00:00Z",
"market_status": "Open",
"market_type": "day-ahead",
"latest_version": 1,
"versions": [
{
"value": {
"curve": [
{
"quantity_in_kw": 80,
"price": 0.14
},
{
"quantity_in_kw": 100,
"price": 0.16
}
],
"latest_state_change": "2023-01-24T14:00:00Z",
"date_received": "2023-01-24T12:00:00Z",
"status": "Accepted"
},
"key": 1
}
]
}
]
}
]
}