Skip to main content
POST
/
v1
/
superagents
curl --request POST \
  --url https://api.gigabrain.gg/v1/superagents \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "My Trading Agent",
  "model": "gpt-4o",
  "model_provider": "openai"
}
'
{
  "agent_id": "a1b2c3d4-5678-90ab-cdef-1234567890ab",
  "name": "ETH Scalper",
  "bot_username": null,
  "wallet_address": "0x1234...abcd",
  "status": "running"
}

Authorizations

​
Authorization
string
header
required

Your Gigabrain API key. Get one at https://gigabrain.gg/profile?tab=api. Format: gb_sk_...

Body

application/json
​
name
string
required

Display name for the agent

​
model
string
required

Model ID from the selected provider

​
model_provider
enum<string>
required

Provider for the model

Available options:
openai,
anthropic,
xai,
openrouter,
venice
​
soul_md
string

Custom soul.md content — the agent's identity and instructions

​
description
string

Short description of what the agent does

​
telegram_bot_token
string

Telegram bot token (from @BotFather) for Telegram interface

Response

Agent launched

​
agent_id
string
​
name
string
​
bot_username
string | null

Telegram bot username (if token was provided)

​
wallet_address
string | null
​
status
string