Skip to main content
POST
Electricity Cost Calculator

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
ioWattage
number

Device Wattage (W)

Required range: x >= 0.01
ioHoursPerDay
number

Hours Per Day

Required range: 0.01 <= x <= 24
ioRatePreset
enum<string>

Rate Preset

Available options:
custom,
0.16,
0.34,
0.25,
0.30,
0.13,
0.08
ioRate
number

Rate (per kWh)

Required range: x >= 0.001
ioQuantity
number

Number of Devices

Required range: 1 <= x <= 100

Response

Tool output

tool
string
required
tool_version
string
required

Output-contract version for this tool. Currently "1" for all tools.

outputs
object
required
credits_used
integer
required

Credits this call consumed, after any settlement refund. 0 when metering is disabled.

request_id
string
credits_remaining
integer | null

Credits left in the current monthly allowance, or null when metering is disabled.