v5

latestOpenAPI 3.1.0raw.githubusercontent.com2026-03-15312564.6 KB

Agents

Create agent

Create a new trading agent. Costs $0.20 in credits. The agent is created disabled by default.

post/v1/agents

Request body

namestring required

Display name for the agent

goalstring required

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

instructionsstring required

Detailed strategy, behavior, and risk parameters

memory_enabledboolean

trading_enabledboolean

modelstring

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'openai' | 'anthropic' | 'xai' | 'openrouter' | 'venice'

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

enabledboolean

Response

Agent created

agent_idstring

namestring

descriptionstring nullable

goalstring

instructionsstring

triggersobject[]

enabledboolean

created_atstring nullable