API Response Codes


Bids are validated against many market requirements. If all rules pass, you'll receive a successful 202 response. However, if one or more of the rules fail, you'll receive one of the 4XX error codes below with additional detail in the message body.

Possible validation exceptions:

codedescription
400The bid submissions deadline for admins has passed. You are not allowed to make any changes anymore to the bids for that trading day.
401The bid prices are not in the expected range. All prices have to be less than 1 $/kWh.
402The bid prices have an invalid scale. Check the precision of the bid prices. The maximum allowed decimals is 5.
403The bid quantities are not in the expected range. Valid quantity is greater than 1 kW.
404The bid contains timeslot(s) for a closed market.
405A bid contains one or more meters not assigned to any resource.
406A bid contains timeslot(s) which do not start at a full hour.
407A bid contains timeslot(s) which do not have a range of one hour.
408A bid contains meter(s) which are not assigned to this account.
409A bid contains meter(s) which are not assigned to a resource at the tradingDay.
410A bid curve does not meet the minimum quantity.
411A bid curve price is not within the range of $0.01 to $1.00.
412A bid curve is not increasing in power or price.
413The maximum number of bids in a single request has been exceeded. The limit is set to 100,000 per request.
414The maximum number of meters in a single bid request has been exceeded. The limit is set to 100 per request.
415The ask contains resources which are not assigned to this account.
416The ask curve power has quantity that is not positive.
417The ask price is not within the range of $0.01 to $1.00.
418An ask curve is not increasing in power or price.
419The ask contains timeslots which do not end at a full hour.
430The file contains duplicate bids for the following (meter id, bid start).


What’s Next