Cycles are the Internet Computer's unit for paying for computation, storage and messages; on a cloud engine your canisters don't use them, because you pay for the engine's nodes instead.
On the public Internet Computer
- Each canister holds a cycles balance, and everything it does (executing, storing data, sending messages, HTTPS outcalls) burns cycles from it.
- T means a trillion cycles. 1 T is pegged to 1 XDR, the IMF's Special Drawing Right, worth about 1.44 US dollars (the rate moves). Cycles are bought by converting ICP, or with a card.
- Freezing threshold: a canister keeps a reserve covering some time of idle costs, 30 days by default. Below it, the canister freezes and stops executing messages. If its balance then runs out, it is uninstalled: code and data are deleted, and only its id and settings remain.
- Developers top canisters up, for example with
icp canister top-up backend --amount 2t -e ic.
On a cloud engine
- The engine's subnet has a free cost schedule: execution, storage, messaging and HTTPS outcalls all cost its canisters zero.
- Engine canisters hold 0 cycles by design. A status of 0 cycles is normal, they can't be topped up, and there is no freezing threshold for you to manage. Don't carry over top-up logic or low-balance alarms from apps built for ordinary subnets.
- Never attach cycles to a call from an engine canister: any non-zero amount fails with
IC0504("is out of cycles"). - What you pay for is the engine itself: its nodes, day by day, from the engine's balance. Deposits buy cycles for that balance at today's rate, and the console shows amounts in your currency.
- Proxy canisters are the exception. They live on an ordinary subnet and hold cycles of their own to pay for the chain-key, vetKeys and exchange-rate calls they relay, refilled from the engine's balance.
Which balance is it?
- "My canister is out of cycles": engine canisters have no balance, so look for a call that attaches cycles.
- "My engine is running low": add funds to the engine. Close to empty the engine halts, and when the balance runs out the engine is deleted with everything on it.
InsufficientCyclesfrom a proxied call: the proxy's balance, which refills from the engine's.