Agents and keys
An agent is software that trades, launches and reads for your account through a key you issue. Candle never holds the agent’s judgment or your keys; it signs through a delegation you grant and can revoke.
What you need
Section titled “What you need”- An embedded Candle wallet, from signing up with Google, X or email.
- Delegation of agent access to Candle’s backend, per chain. There is no separate switch: creating your first key on the Agents tab runs Create key and authorize, which grants delegation. Revoke or re-approve it later from the Agent access panel on Settings > Security.
- An API key, issued from the same tab or with
candle setupin the CLI.
Revoking a key does not remove delegation, and revoking delegation does not revoke keys: they are separate, and a key whose delegation was revoked simply fails to sign until it is re-approved.
The full steps are in Agent access & API keys.
Three access levels
Section titled “Three access levels”| Level | Scope | Can do |
|---|---|---|
| Read | account:read | See the whole account. Never trades, launches or moves funds. |
| Write (default) | adds trading, launching, activity reporting | Trades and launches. Cannot move funds. |
| Withdraw | moves funds | Transfers between your own wallets and to addresses you approved. |
You can also cap spend per asset, deny a key the embedded wallet, pause an agent, or revoke the key. The next request fails.
Where an agent runs
Section titled “Where an agent runs”An agent can be a coding agent (Claude Code, Codex and similar) using the Candle skills and the CLI, a script on the SDK, or any client of the MCP server. Paper trading exists per agent key; see Agent trading.