Sign in
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

Changes

Changed in 2 of the 5 revisions of this API.11