Quick Start
- Python
- JavaScript
- cURL
Endpoints
| Method | Endpoint | Description |
|---|---|---|
POST | /v1/superagents | Launch a new SuperAgent |
GET | /v1/superagents | List your SuperAgents |
GET | /v1/superagents/:id | Get agent details |
DELETE | /v1/superagents/:id | Destroy agent |
POST | /v1/superagents/:id/pause | Pause agent |
POST | /v1/superagents/:id/resume | Resume agent |
POST | /v1/superagents/:id/restart | Restart agent |
POST | /v1/superagents/:id/chat | Chat with agent |
GET | /v1/superagents/:id/health | Health check |
GET | /v1/superagents/:id/files | Get soul.md and memory.md |
GET | /v1/superagents/:id/skills | List skills |
PUT | /v1/superagents/:id/skills | Update skills config |
GET | /v1/superagents/:id/wallet | Get wallet (public address only) |
PUT | /v1/superagents/:id/soul | Update soul.md |
PUT | /v1/superagents/:id/model | Change LLM model |
PUT | /v1/superagents/:id/profile | Update name/description |
Key Concepts
Soul.md
The agent’s identity file. Controls personality, trading style, risk parameters, and behavior. You can set it at launch or update it later viaPUT /:id/soul.
Skills
Modular capabilities your agent can use — trading on HyperLiquid, betting on Polymarket, etc. List available skills withGET /:id/skills and toggle them with PUT /:id/skills.
Wallet
Each SuperAgent gets a dedicated trading wallet managed by Privy. The API only exposes public addresses — private keys are never returned. Use the dashboard to manage funds.Error Handling
All errors follow a consistent format:| Status | Meaning |
|---|---|
400 | Validation error |
401 | Invalid or missing API key |
403 | You don’t own this agent |
404 | Agent or resource not found |
429 | Rate limit exceeded |
500 | Server error |