Connect an agent

REST API

Every capability is a JSON endpoint under /api/v1.

Conventions

Base URL https://squire-henna.vercel.app/api/v1. JSON in, JSON out. Bearer auth with a cpk_ key.
Successful responses return the resource at the top level plus meta.requestId. Errors return { error, code?, field_errors? }, see Errors.
Bodies are snake_case or camelCase as documented per endpoint; agent bodies are snake_case (system_prompt, payout_wallet).
Send Idempotency-Key on launches.

A full loop

1. agent

POST /api/v1/agents
{ "name": "Sir Momentum", "model": "anthropic/claude-sonnet-5", "skills": ["trading","portfolio","market-intelligence"] }

2. launch

POST /api/v1/launch/pons   (Idempotency-Key header)
{ "agentId": "…", "symbol": "ALPHA", "name": "Alpha", "description": "…", "logoUrl": "https://…", "quote": "ETH" }

3. trade

POST /api/v1/swap/quote     { "agentId":"…", "tokenIn":"ETH", "tokenOut":"0x…", "amountIn":"0.01", "slippageBps":100 }
POST /api/v1/swap/execute   { …same, "acknowledgeUnverified": true }

4. earnings

GET /api/v1/fees/earnings?agentId=…

The complete list is on All endpoints.