Skip to main content
The SuperAgents API gives you full lifecycle control over always-on AI agents. Each SuperAgent runs in its own cloud container with persistent memory, installable skills, and multi-chain trading.
Base URL: https://api.gigabrain.gg/v1/superagents
  • Rate limit: 60 requests per minute
  • Minimum credits: $100 to launch a SuperAgent through the API
  • Max agents: 10 SuperAgents per account

Quick Start

import requests

KEY = "gb_sk_..."
BASE = "https://api.gigabrain.gg/v1/superagents"
headers = {"Authorization": f"Bearer {KEY}", "Content-Type": "application/json"}

# Launch an agent
agent = requests.post(BASE, headers=headers, json={
    "name": "ETH Scalper",
    "soul_md": "You are an aggressive ETH scalper. Focus on short timeframes."
}).json()

agent_id = agent["agent_id"]
print(f"Launched: {agent_id}")

# Chat with it
reply = requests.post(f"{BASE}/{agent_id}/chat", headers=headers, json={
    "message": "What's your current view on ETH?"
}).json()

print(reply["content"])

# Check health
health = requests.get(f"{BASE}/{agent_id}/health", headers=headers).json()
print(f"Healthy: {health['healthy']}")

Endpoints

MethodEndpointDescription
POST/v1/superagentsLaunch a new SuperAgent
GET/v1/superagentsList your SuperAgents
GET/v1/superagents/:idGet agent details
DELETE/v1/superagents/:idDestroy agent
POST/v1/superagents/:id/pausePause agent
POST/v1/superagents/:id/resumeResume agent
POST/v1/superagents/:id/restartRestart agent
POST/v1/superagents/:id/chatChat with agent
GET/v1/superagents/:id/healthHealth check
GET/v1/superagents/:id/filesGet soul.md and memory.md
GET/v1/superagents/:id/skillsList skills
PUT/v1/superagents/:id/skillsUpdate skills config
GET/v1/superagents/:id/walletGet wallet (public address only)
PUT/v1/superagents/:id/soulUpdate soul.md
PUT/v1/superagents/:id/modelChange LLM model
PUT/v1/superagents/:id/profileUpdate 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 via PUT /:id/soul.

Skills

Modular capabilities your agent can use — trading on HyperLiquid, betting on Polymarket, etc. List available skills with GET /: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:
{
  "statusCode": 400,
  "message": "name is required",
  "error": "Bad Request"
}
Upstream errors from the agent runtime use:
{
  "error": {
    "message": "Container not found",
    "type": "upstream_error"
  }
}
StatusMeaning
400Validation error
401Invalid or missing API key
403You don’t own this agent
404Agent or resource not found
429Rate limit exceeded
500Server error