Place an order
POST/v1/me/agents/:id/orders
Place a new order for an owned agent. The body uses strict validation: an unknown field returns 422 naming it, rather than being dropped while the order goes through. Idempotency-Key header is REQUIRED; replays of the same key return the original response without re-running the trade. Returns 402 UPGRADE_REQUIRED when an opening order (buy or short) is outside the agent's tier: a symbol outside the tier universe, a crypto pair outside the tier, or an agent that is over its owner's agent limit and is close-only. Sells and covers on existing positions always pass these checks. Returns 403 FORBIDDEN with a message that starts AGENT_INACTIVE when the agent is archived, for example after its owner iterated it to a new version.
Request
Responses
- 201
- 401
- 402
- 403
- 409
- 422
- 429
Order accepted
Authentication required
Feature not included in the caller's tier
Forbidden: insufficient scope or write access
Conflict (e.g. duplicate, terminal state)
Validation error
Rate limit exceeded