API Reference
All 40 canonical Platform API v1 routes, grouped by runtime stage. Prefer canonical paths; legacy aliases remain stable. Live machine catalog: GET /capabilities. Contract: OpenAPI 3.1.
| Base URL | https://app.torque.fi/api/v1 |
| Routes in catalog | 40 |
| Manifest version | v18 (see capabilities.operations + endUsers) |
| Rate limit (business key) | 100 requests / minute |
Auth models: Authentication. Errors & idempotency: Errors & Rate Limits. Stage layout: API Layout.
Meta
Health, capabilities manifest, OpenAPI, and Connect token verification.
| Method | Canonical path | Aliases | Auth | Summary |
|---|---|---|---|---|
| GET | /api/v1/health | — | None | Liveness probe |
| GET | /api/v1/capabilities | — | None | Capability manifest + entitlements catalog |
| GET | /api/v1/openapi | — | None | OpenAPI 3.1 document |
| GET | /api/v1/connect/confirm/verify | — | None | Verify hosted execute confirm token |
Accounts & Connect
Identity probes, Connect OAuth, and partner end-user wallet provisioning.
| Method | Canonical path | Aliases | Auth | Summary |
|---|---|---|---|---|
| GET | /api/v1/accounts/business | /api/v1/business/me | sk_live_… | Merchant identity for API key |
| GET | /api/v1/accounts/wallet | /api/v1/wallet/me | Smart wallet JWT | User identity for smart wallet JWT |
| POST | /api/v1/accounts/end-users | — | sk_live_… | Provision partner end-user wallet (EVM + Solana + BTC deposit); idempotent on externalUserId |
| GET | /api/v1/accounts/end-users | — | sk_live_… | List partner-provisioned end-users for business API key |
| GET | /api/v1/accounts/end-users/{externalUserId} | — | sk_live_… | Get partner end-user addresses by externalUserId |
| POST | /api/v1/connect/authorize/session | — | sk_live_… | Mint OAuth authorize session for Connect with Torque |
| POST | /api/v1/connect/authorize/complete | — | None | User approves Connect OAuth session (hosted page) |
| POST | /api/v1/connect/token | — | sk_live_… | Exchange Connect authorization code or refresh delegated JWT |
Read
Intelligence feeds, datasets, markets, portfolio, and prediction positions.
| Method | Canonical path | Aliases | Auth | Summary |
|---|---|---|---|---|
| GET | /api/v1/intelligence/feedread profile: feed | — | sk_live_… | Primary narrative feed (IntelligenceItemV1) |
| GET | /api/v1/intelligence/views/event-playsread profile: feed | /api/v1/intelligence/event-plays | sk_live_… | Event Plays — Jupiter prediction markets view |
| GET | /api/v1/intelligence/views/trade-anglesread profile: feed | /api/v1/intelligence/trade-angles | sk_live_… | Desk trade angles view |
| GET | /api/v1/intelligence/views/happening-nowread profile: feed | /api/v1/intelligence/happening-now | sk_live_… | Timely signals view |
| GET | /api/v1/intelligence/views/briefread profile: feed | /api/v1/intelligence/brief | sk_live_… | Hero brief item |
| GET | /api/v1/intelligence/views/market-outlookread profile: feed | /api/v1/intelligence/market-outlook | sk_live_… | Stored market outlook |
| GET | /api/v1/intelligence/datasets/earnings-spotlightread profile: dataset · earnings-spotlight | /api/v1/data/earnings-spotlight, /api/v1/widgets/earnings-spotlight | sk_live_… | Upcoming earnings spotlight |
| GET | /api/v1/intelligence/datasets/eventsread profile: dataset · events | /api/v1/data/events | sk_live_… | Economic events calendar |
| GET | /api/v1/intelligence/markets/yieldread profile: market | /api/v1/opportunities/yield | sk_live_… | Yield spotlight + idle-cash ideas |
| GET | /api/v1/intelligence/markets/lendingread profile: market | /api/v1/opportunities/lending | sk_live_… | Lend/borrow catalog rates |
| GET | /api/v1/intelligence/markets/predictions/eventsread profile: market | — | sk_live_… | Jupiter prediction events catalog |
| GET | /api/v1/intelligence/markets/predictions/events/searchread profile: market | — | sk_live_… | Search Jupiter prediction events |
| GET | /api/v1/intelligence/markets/predictions/markets/{marketId}read profile: market | — | sk_live_… | Jupiter prediction market detail |
| GET | /api/v1/read/predictions/positions | — | sk_live_… | Open prediction positions — business key + ownerPubkey, or smart wallet JWT |
| GET | /api/v1/read/portfolio | — | sk_live_… | Cross-chain product-bucket portfolio (read-only) |
Decide
Assistant chat, fulfillment preview, and hosted execute confirm.
| Method | Canonical path | Aliases | Auth | Summary |
|---|---|---|---|---|
| POST | /api/v1/connect/confirm | — | sk_live_… | Mint hosted execute confirm token from functionResults |
| POST | /api/v1/connect/confirm/complete | — | None | Report hosted execute completion and dispatch partner webhook |
| POST | /api/v1/decide/assistant/chat | /api/v1/assistant/chat | sk_live_… | Torque Intelligence chat (functionResults for confirm) |
| POST | /api/v1/decide/fulfillment | — | Smart wallet JWT | Portfolio fulfillment preview for transfer/checkout (DECIDE) |
Execute
Unsigned transaction builders for trades, transfers, lend/borrow, and predictions.
| Method | Canonical path | Aliases | Auth | Summary |
|---|---|---|---|---|
| POST | /api/v1/execute/trades | /api/v1/actions/trade/swap | Smart wallet JWT | Build unsigned EVM swap route (Enso) |
| POST | /api/v1/execute/trades/solana | /api/v1/actions/trade/swap/solana | Smart wallet JWT | Build unsigned Solana swap (Jupiter Ultra) |
| POST | /api/v1/execute/transfers/evm | /api/v1/actions/transfer/evm | Smart wallet JWT | Build unsigned EVM transfer |
| POST | /api/v1/execute/transfers/solana | /api/v1/actions/transfer/solana | Smart wallet JWT | Build unsigned Solana transfer |
| POST | /api/v1/execute/transfers/btc | /api/v1/actions/transfer/btc | Smart wallet JWT | Custodial BTC send from deposit |
| POST | /api/v1/execute/lends/evm | /api/v1/actions/lend/evm | Smart wallet JWT | Enso lend delegate bundle |
| POST | /api/v1/execute/borrows/evm | /api/v1/actions/borrow/evm | Smart wallet JWT | Enso borrow delegate bundle |
| POST | /api/v1/execute/predictions/solana | /api/v1/actions/predict/solana | Smart wallet JWT | Build unsigned Jupiter prediction order (Solana) |
| POST | /api/v1/execute/predictions/claim/solana | /api/v1/actions/predict/claim/solana | sk_live_… | Build unsigned Jupiter prediction claim tx — business key + ownerPubkey, or smart wallet JWT |
Merchant checkout and inbound order webhooks use the Checkout SDK and torque-webhooks, not HTTP routes in this catalog. Alias responses include X-Torque-Canonical-Path and related headers — see API Layout.