Skip to content
Deprecated

Energy prices (deprecated)

GET
/prices

The deprecated pricing endpoint, scheduled for removal. Move to /pricing: it has dynamic periods, a service filter, energy_5m, AML and host prices in one response, and machine-readable units.

Returns five fixed time-of-day periods and three hardcoded volume categories.

The rate limit here is the strictest in the whole API — one request per minute, because the response is assembled by heavy database queries.

Authorizations

ApiKeyAuth

API key from the dashboard. Some Host Mode endpoints also accept the key as an api_key field in the request body — this is stated in the schema of the particular operation.

Type
API Key (header: X-API-KEY)

Parameters

Header Parameters

X-Real-IP*

An IP address from the key's whitelist. A request from an address outside the whitelist is rejected with 401.

Type
string
Required
Example"203.0.113.10"
Format
"ipv4"
X-Format

Compact plain-text response instead of JSON. The response arrives with Content-Type: text/plain.

Type
string
Valid values
"now""compact""short""short1h""count"
Example"now"

Responses

Prices by time-of-day period.

JSON
{
  
"status": "success",
  
"current_utc_time": "2025-09-02 06:50:39",
  
"current_utc_hour": 0,
  
"active_period": "05:00-07:00",
  
"last_update": "string",
  
"host_price": 0,
  
"periods": [
  
  
{
  
  
  
"label": "string",
  
  
  
"period": "05:00-07:00",
  
  
  
"is_active": true,
  
  
  
"prices": {
  
  
  
  
"less_than_200k": {
  
  
  
  
  
"price_sun": 0
  
  
  
  
},
  
  
  
  
"equal_131k": {
  
  
  
  
  
"price_sun": 0
  
  
  
  
},
  
  
  
  
"more_than_200k": {
  
  
  
  
  
"price_sun": 0
  
  
  
  
}
  
  
  
}
  
  
}
  
]
}

Playground

Authorization
Headers

Samples

Powered by VitePress OpenAPI