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 + one daily fee + one 131k unit) 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.

Request

Responses

201

Subscription created and activated.

400

insufficient_balance — balance can't cover the entry threshold; or plan_not_found.

409

address_busy — the address already has a live subscription; or address_exists — a closed subscription exists (reactivate or delete first).

422

invalid_address — the address is malformed.

502

fulfiller_unavailable — the energy provider could not activate the delegation.