Authentication
Torque Platform v1 uses two credentials. Business API keys identify integrators for Intelligence, Checkout, and programmatic Assistant calls. Smart wallet JWTs authorize on-chain Actions for users who sign in through Torque.
At a glance
| Credential | Header | Used for |
|---|---|---|
| sk_live_… | Authorization: Bearer sk_live_… | Intelligence, Checkout, programmatic Assistant |
| Smart wallet JWT | Authorization: Bearer <jwt> | Actions (/api/v1/actions/**), wallet identity |
Business API key
Keys use the sk_live_ prefix. There are no test or sandbox keys — use local development or a live business key against production.
- Create or open a Torque Business account at app.torque.fi.
- Go to Business Settings → API Integration and copy your key.
- Send it from your server only — never ship it in browser bundles or mobile apps.
export TORQUE_KEY="sk_live_…"
curl -sS "https://app.torque.fi/api/v1/intelligence/feed" \
-H "Authorization: Bearer $TORQUE_KEY" \
| jq '.meta.manifestVersion, (.items | length)'Smart wallet JWT
A RS256 session token issued when a user signs in through Torque (email OTP or Google). The client stores it as smartWalletAuthJWT. It authorizes on-chain Actions and GET /api/v1/wallet/me.
Partner apps: there is no public API to mint wallet JWTs for arbitrary users. Third-party integrators use a business key plus walletAddress in Assistant context for programmatic chat. On-chain execution requires the user to authenticate through Torque.
export WALLET_JWT="<smart_wallet_jwt>"
curl -sS -X POST "https://app.torque.fi/api/v1/actions/trade/swap" \
-H "Authorization: Bearer $WALLET_JWT" \
-H "Content-Type: application/json" \
-d '{ ... }'Legacy parity: some routes accept authJWT as a query parameter. Prefer the Authorization header.
Which credential do I need?
| I'm building… | Credential | Primary surface |
|---|---|---|
| Merchant checkout embed | sk_live_… + Business ID | torque-checkout SDK |
| Market intelligence feed | sk_live_… | GET /api/v1/intelligence/feed |
| Programmatic assistant | sk_live_… + walletAddress in context | POST /api/v1/assistant/chat |
| In-app wallet actions | Smart wallet JWT | POST /api/v1/actions/** |
| Order status sync to Torque | sk_live_… | POST /api/webhooks/order-update |
Testing
| Production API | https://app.torque.fi/api/v1 |
| Local development | http://localhost:3000/api/v1 |
| Capabilities probe (no auth) | https://app.torque.fi/api/v1/capabilities |
Live business keys against production trigger real checkout and settlement. Prefer local development when iterating on integrations.
Related
Quickstart — step-by-step paths for merchants, intelligence partners, and fintech apps. API & SDK coverage — full credential matrix. API Reference — endpoint index.