Skip to content

Prices for every service

GET
/pricing

The recommended pricing endpoint. Returns the prices of all services in one response, with dynamic time-of-day periods.

Replaces the deprecated /prices.

The price may change while an order is being fulfilled. A provider may decline a delegation, in which case NETTS routes the order to the next available one — so an order may be fulfilled above the quoted price. This applies only to orders of 300,000 energy units and above.

Periods, providers and rates are dynamic: iterate the arrays from the response instead of hardcoding their number, labels and ids. Parse each service by its pricing_type field.

Sub-users receive prices with their parent's markup already applied — no client-side calculation is needed.

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"

Query Parameters

services

Comma-separated service filter. By default every service is returned except bandwidth, which must be requested explicitly. type: string

Type
string
Examples
"energy_1h"

Responses

Prices. With X-Format set, a text/plain string arrives instead of JSON, carrying the price of the currently active energy_1h period. application/json: schema: { $ref: '#/components/schemas/PricingResponse' } example: success: true version: '2.1' timestamp: '2026-09-05T09:00:00Z' data: trx_rate_usd: 0.3391 units_meta: sun: { base: trx, multiplier: 1000000 } trx: { base: trx, multiplier: 1 } usdt: { base: usdt, multiplier: 1 } services: energy_1h: unit: sun pricing_type: periodic description: 1-hour energy delegation cache_ttl: 30 current_period: daytime periods:
- id: daytime
label: Daytime Hours (11:00-21:00 UTC) start: '11:00' end: '21:00' is_current: true price: 27 tiers: null text/plain: schema: { type: string } examples: now: summary: 'X-Format: now' value: 'Daytime Hours (11:00-21:00 UTC): price=27 sun, 65k=1.755 TRX (0.52$), 131k=3.537 TRX (1.05$), 1m=27.000 TRX (7.99$)' short1h: summary: 'X-Format: short1h' value: '65k=1.755 TRX (0.52$), 131k=3.537 TRX (1.05$), 1m=27.000 TRX (7.99$)' count: summary: 'X-Format: count — cost of 1, 2, 3, 5, 10 and 20 orders' value: '1-1.690 TRX (0.50$), 2-3.380 TRX (1.00$), 3-5.070 TRX (1.50$), 5-8.450 TRX (2.50$), 10-16.900 TRX (5.00$), 20-33.800 TRX (10.00$)'

JSON
{
  
"success": true,
  
"version": "2.1",
  
"timestamp": "string",
  
"data": {
  
  
"trx_rate_usd": 0.3391,
  
  
"units_meta": {
  
  
  
"additionalProperties": {
  
  
  
  
"base": "string",
  
  
  
  
"multiplier": 0
  
  
  
}
  
  
},
  
  
"services": {
  
  
  
"additionalProperties": {
  
  
  
  
"unit": "sun",
  
  
  
  
"pricing_type": "periodic",
  
  
  
  
"description": "string",
  
  
  
  
"cache_ttl": 0,
  
  
  
  
"current_period": "string",
  
  
  
  
"periods": [
  
  
  
  
  
{
  
  
  
  
  
  
"id": "string",
  
  
  
  
  
  
"label": "Daytime Hours (11:00-21:00 UTC)",
  
  
  
  
  
  
"start": "string",
  
  
  
  
  
  
"end": "string",
  
  
  
  
  
  
"is_current": true,
  
  
  
  
  
  
"price": 0,
  
  
  
  
  
  
"tiers": [
  
  
  
  
  
  
]
  
  
  
  
  
}
  
  
  
  
]
  
  
  
}
  
  
}
  
}
}

Playground

Authorization
Headers
Variables
Key
Value

Samples

Powered by VitePress OpenAPI