Assistant

Key Rule

Execution Flow

API Reference

At a Glance

Authentication

walletAddress preloads portfolio (Profile B). Do not call /assistant/functions; internal to chat.

Request Body

AssistantChatPostBody

{
  "messages": [
    { "role": "user", "content": "What is the price of ETH?" }
  ],
  "context": {
    "walletAddress": "0x…",
    "solanaWalletAddress": "…",
    "chainId": 8453,
    "localCurrency": "USD",
    "authJWT": "<smart_wallet_jwt>"
  },
  "conversationId": "optional-thread-id"
}

Required: messages. Context: walletAddress, chainId, authJWT for portfolio & tx drafts.

Product language: example user prompts use product buckets (USD, ETH) and a unified portfolio — not network names. End users do not pick Base vs Arbitrum; Torque routes automatically. Optional chainId in context is server routing metadata for integrators, not something to expose in end-user copy.

Response (JSON)

response.json

{
  "content": [
    { "type": "text", "text": "Here's the best route I found…" }
  ],
  "functionResults": [
    {
      "toolName": "swap_tokens",
      "result": {
        "success": true,
        "requiresConfirmation": true,
        "tokenIn": "USDC",
        "tokenOut": "ETH",
        "amountIn": "100",
        "chainId": 8453,
        "transaction": { … }
      }
    }
  ]
}

functionResults is omitted when empty. Torque resolves canonical write verbs (trade, transfer, schedule, …) from grounded user intent — often without a model tool round when required slots are already complete. Expanded payloads often use legacy toolName values such as swap_tokens. Read-only tools return answers in content only.

functionResults by Tool

Signable (tradetransferlendborrowbridgeschedulepayswap_tokenstransfer_tokenslend_tokensborrow_tokensbridge_tokens) set requiresConfirmation: true; hand off via Connect or submit with a wallet JWT on Connect & Execute. Advisory (read_portfolioread_marketread_ratesread_taperead_researchread_intelligenceread_planread_commerceget_portfolio_summaryget_yield_opportunitiesget_weatherget_perp_market_infoget_perp_positionscreate_market_scannerdisplay_data_table) return context in content only. Advisory tools also include weather (get_weather thesisCard), perps, market scanners, SEC research, and tables — see query examples.

Streaming

Append ?stream=true for Server-Sent Events.

assistant-chat.sh

curl -sS -N -X POST "https://app.torque.fi/api/v1/assistant/chat?stream=true" \
  -H "Authorization: Bearer $TORQUE_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "messages": [{ "role": "user", "content": "Trade 100 USD for ETH" }],
    "context": { "walletAddress": "0x…", "chainId": 8453 }
  }'

Query examples