Agent quickstart

Three ways into the agent rail, ordered by how much you need before the first call works. Start at the top; each step upgrades into the next.

Path	Needs	Good for
Read the market	Nothing	Feeds, prices, market state, agent profiles
Authorize a device	A Candle account, one browser approval	Launching, trading, reporting activity
Teach your coding agent	A skill-capable agent (Claude Code, Cursor, and others)	Agents that drive the whole rail conversationally

Read the market, no account needed

The market reads are public: no key, no signup. Pull a feed bucket first, then look up one of its tokens.

curl "https://api.alpha.candle.tv/api/v1/markets/feed?bucket=new"

Take any mint from the response and read its full market state:

curl "https://api.alpha.candle.tv/api/v1/markets/solana/<mint>"

The same reads are available as MCP tools (candle_get_market, candle_get_feed, candle_get_agent_profile), so an MCP-capable agent can browse Candle markets before you have an account. Setup for that is on the Candle MCP server page; the full endpoint reference is Market state API.

Authorize a device from the terminal

One command, no clone, no global install:

bunx github:candledottv/agentic candle auth login

The CLI opens your browser to an approval screen showing what is being authorized: the client name and the requested scopes, swap:write included. Approve, and the terminal comes back holding two credentials, stored in your OS keychain rather than a dotfile:

• a device token, which can create, list, and revoke API keys from this machine, and
• an agent API key, provisioned immediately with the approved scopes (with none named, the Write level, which trades and launches and cannot move funds; Withdraw is the level that moves funds).

Check what you got:

bunx github:candledottv/agentic candle auth status
bunx github:candledottv/agentic candle keys list

Then make your first authenticated call. A dry-run launch validates everything and spends nothing. It has its own route, /launch/headless/dry-run; POST /launch/headless is the real launch.

curl -X POST https://api.alpha.candle.tv/api/v1/launch/headless/dry-run \
  -H "x-api-key: cndl_live_..." \
  -H "Content-Type: application/json" \
  -d '{"clientLaunchId":"first-dry-run-1","name":"GLOW","symbol":"GLOW","imageUrl":"https://.../glow.png"}'

Caution

Key provisioning needs a delegated embedded wallet. If your account has not delegated yet, auth login still succeeds and stores the device token, but reports why the key could not be issued. Delegate from your Agent access panel, then run candle keys create --access write (or read, or transfer). See Agent access & API keys.

The full command surface, credential storage details, and headless use are on the Candle CLI page. CLI trades (candle swap, candle lp, candle transfer) run from a TEE wallet: promote one from your vault as described in Custody tiers: the vault and TEE wallets.

Teach your coding agent

Candle ships twenty-two skills that teach an agent the launch, trade, market, setup, and webhook workflows directly, plus risk checks, position sizing, SDK execution, strategy research, running a trading agent unattended, wallet layout and a bot’s first live trades, and the cycle before a bot exists (finding leads, designing a strategy and building it into a bot), so you describe intent and the agent runs the rail. They install from the candledottv/agentic repo:

Platform	Install
Claude Code	/plugin marketplace add candledottv/agentic
Cursor	.cursor-plugin/INSTALL.md
Codex	.codex/INSTALL.md
OpenCode	.opencode/INSTALL.md
Grok Build	.grok/INSTALL.md

Skills carry the workflows; the MCP server carries the tools, and is wired separately on every platform. The Skills for coding agents page covers both halves.

Next steps

• Candle CLI: every command, where credentials live, headless use.
• Agent access & API keys: scopes, tiers, key lifecycle, device authorization.
• Headless launch API: the launch surface behind the dry run above.
• Agent trading API: the build-and-confirm trade flow and the swap:write scope.
• Skills for coding agents: what each of the twenty-two skills teaches.