torque-intelligence

Official read-only client for Torque Platform API v1 Intelligence (READ profile: feed, views, datasets, markets).

Uses the same business API key as Checkout (sk_live_…). No wallet JWT required.

Install

yarn add torque-intelligence@^0.1.3 @torquefi/types@^0.1.2

Quick start

import { createTorqueIntelligenceFromEnv } from 'torque-intelligence'

const ti = createTorqueIntelligenceFromEnv()

const feed = await ti.getFeed({
  walletAddress: '0x…', // optional — personalization
  chainId: 8453,
  lanes: ['timely', 'desk'],
  includeBrief: true,
})

const angles = await ti.getTradeAngles({ walletAddress: '0x…' })
const events = await ti.getDataset('events', { days: 30 })
const yieldOps = await ti.getYieldOpportunities({ walletAddress: '0x…' })

const caps = await ti.getCapabilities()
ti.assertManifestCompatibility(caps.manifestVersion)

Configuration

import { createTorqueIntelligence } from 'torque-intelligence'

const ti = createTorqueIntelligence({
  apiKey: process.env.TORQUE_API_KEY!,
  baseUrl: 'https://app.torque.fi', // optional
  timeout: 30_000, // optional
  cooldownRetries: 1, // retry once on 429 COOLDOWN
})

Environment variables: TORQUE_API_KEY, optional TORQUE_BASE_URL.

Endpoints (canonical)

| Method | SDK | HTTP | |--------|-----|------| | getFeed | Primary feed | GET /api/v1/intelligence/feed | | getTradeAngles / getView('trade-angles') | Desk angles | GET /api/v1/intelligence/views/trade-angles | | getHappeningNow / getView('happening-now') | Timely signals | GET /api/v1/intelligence/views/happening-now | | getView('brief') | Hero brief | GET /api/v1/intelligence/views/brief | | getView('market-outlook') | Stored outlook | GET /api/v1/intelligence/views/market-outlook | | getDataset('earnings-spotlight') | Earnings calendar | GET /api/v1/intelligence/datasets/earnings-spotlight | | getDataset('events', { days }) | Economic events | GET /api/v1/intelligence/datasets/events | | getYieldOpportunities | Yield + idle-cash ideas | GET /api/v1/intelligence/markets/yield | | getLendingOpportunities | Lend/borrow catalog | GET /api/v1/intelligence/markets/lending | | getCapabilities | Manifest probe | GET /api/v1/capabilities |

Legacy paths (/data/*, /opportunities/*, /widgets/*) remain on the server as aliases.

Errors

v1 JSON errors map to TorqueIntelligenceError with code, statusCode, and optional details.

On 429 COOLDOWN, the client waits retryAfterMs from error.details and retries up to cooldownRetries (default 1).

Docs

• Platform API layout
• Developer landing
• Intelligence integrator guide

License

MIT