Create a Copilot price recommendation
POST /v1/perps/copilot-analysis — Runs bounded research through the local Agent, combining the selected perpetual venue snapshot with relevant current too
POST /v1/perps/copilot-analysis
Runs bounded research through the local Agent, combining the selected perpetual venue snapshot with relevant current tools and skills. The Agent uses the connected model provider; local execution does not imply an offline model. Pass executionSymbol for an exact contract and locale for the response language. When subAccountId is omitted, exactly one active wallet must be available. This endpoint does not preview, create, or execute an order.
| Method | POST |
| Path | /v1/perps/copilot-analysis |
| Auth | Authorization: Bearer <token> required when GATEWAY_AUTH_TOKEN is set |
| Category | perps |
Request body
{ "symbol": "BTC", "executionSymbol": "BTC", "style": "day", "strategy": "max_gain", "initialMarginUsd": 1000, "subAccountId": "sub_123", "locale": "en" }Response body
{ "recommendation": { "id": "copilot-1", "direction": "long", "entryPrice": 65000, "takeProfitPrice": 68000, "stopLossPrice": 63000, "initialMarginUsd": 1000, "reasons": ["Venue momentum and current catalysts support the setup"], "risks": ["Funding and volatility may invalidate the setup"], "source": "local_agent", "marketMode": "perps", "executionSymbol": "BTC", "exchange": "hyperliquid", "subAccountId": "sub_123", "research": { "tools": [{ "tool": "web_search", "ok": true, "retrievedAt": "2026-09-16T00:00:00.000Z" }], "skills": [] } }, "connected": true }