Skip to main content
POST
/
v1
/
agents
curl --request POST \
  --url https://api.gigabrain.gg/v1/agents \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "ETH Momentum Bot",
  "goal": "Monitor ETH/USDT and go long when RSI drops below 30 on the 4H chart",
  "instructions": "Use 4H timeframe. Enter long when RSI < 30 and funding is negative. Position size: 10% of wallet. Stop loss: 3% below entry. Take profit: 2:1 R:R minimum.",
  "triggers": [
    {
      "type": "scheduled",
      "cron": "*/15 * * * *"
    }
  ],
  "memory_enabled": true,
  "trading_enabled": true,
  "enabled": false
}
'
{
  "agent_id": "<string>",
  "name": "<string>",
  "description": "<string>",
  "goal": "<string>",
  "instructions": "<string>",
  "triggers": [
    {}
  ],
  "enabled": true,
  "wallet": {
    "wallet_id": "<string>",
    "address": "<string>",
    "agent_address": "<string>",
    "exchange": "hyperliquid",
    "chain_type": "ethereum",
    "status": "<string>"
  },
  "created_at": "<string>"
}

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

​
goal
string
required

Trading goal, e.g. "Monitor ETH/USDT and go long when RSI drops below 30"

​
instructions
string
required

Detailed strategy, behavior, and risk parameters

​
triggers
object[]
required
​
memory_enabled
boolean
default:true
​
trading_enabled
boolean
default:false
​
model
string
default:default

Model ID from the provider's API, or "default" for Gigabrain's default model. Use the exact ID the provider uses — e.g. "gpt-4o" for OpenAI, "claude-sonnet-4-20250514" for Anthropic, "anthropic/claude-sonnet-4" for OpenRouter. Requires a connected API key for the chosen provider.

​
model_provider
enum<string>

Provider of the custom model. Required when using a custom model ID.

Available options:
openai,
anthropic,
xai,
openrouter,
venice
​
enabled
boolean
default:false

Response

Agent created

​
agent_id
string
​
name
string
​
description
string | null
​
goal
string
​
instructions
string
​
triggers
object[]
​
enabled
boolean
​
wallet
object
​
created_at
string | null