Subscribe
POST/autoenergy/subscriptions
Create and activate a subscription for an address: validates the address, charges the activation fee, and starts delegating Energy. Requires the entry threshold (activation fee + one daily fee + one 131k transfer) in balance. An address may hold only one live subscription, so the call is naturally idempotent on the active address — a repeat returns 409 address_busy.
Billing
- The activation fee is charged now. The daily fee is first charged 24h after activation, then every 24h after the previous charge; missed cycles are not back-billed.
- Each covered transfer is charged by its energy class (65k or 131k).
- The subscription closes automatically with
insufficient_balancewhen a daily fee can't be paid, or when, after a billed transfer, your balance is below one daily fee + one 131k transfer. - If the plan sets
min_daily_tx, a completed 24h cycle with fewer transfers is chargedpenalty_sunonce, asautoenergy_penalty.
Read GET /autoenergy/pricing for the current amounts.
Request
Responses
- 201
- 400
- 403
- 409
- 422
- 500
- 502
- 503
Subscription created and activated.
insufficient_balance — balance can't cover the entry threshold.
reseller_suspended — AutoEnergy is suspended for your account. Nothing was charged.
address_busy — the address already has a live subscription (yours, or another account's: if GET /autoenergy/subscriptions/{address} returns 404, another account covers it); or address_exists — you have a closed subscription on it (reactivate or delete it first).
invalid_address (object body, detail.error), or request validation failed (array body: detail is a list of field errors — e.g. idle_hours outside 24–72, quota_max_tx below 1, expire_at in the past).
internal_error — unexpected server error. Check GET /autoenergy/subscriptions/{address} before retrying.
fulfiller_unavailable — Energy delegation could not be started right now. Nothing was charged; retry later.
autoenergy_temporarily_unavailable or reseller_activation_balance_low — AutoEnergy is temporarily unavailable for your account. Nothing was charged; retry later.