@treno.solutions/finance-sdk

@treno-solutions/finance-sdk

Official TypeScript SDK for the Treno Finance API.

Auto-generated from our OpenAPI spec with hand-written additions for session-authenticated endpoints (risk catalogue).

Install

npm install @treno-solutions/finance-sdk

Quick Start

import {
  Configuration,
  PortfoliosApi,
  AccountsApi,
  ReportsApi,
} from '@treno-solutions/finance-sdk';

const config = new Configuration({
  basePath: 'https://app.treno.finance/api',
  fetchApi: (url, init) => {
    const u = new URL(url);
    u.searchParams.set('api-key', 'YOUR_API_KEY');
    return fetch(u.toString(), init);
  },
});

const portfolios = new PortfoliosApi(config);
const result = await portfolios.getPortfolios();

API Classes

Class	Description
AccountsApi	Asset account management (wallets, virtual accounts)
AnnotationsApi	Transaction annotations and notes
ExportApi	Data export (CSV, Excel)
InvestmentsApi	Investment tracking and DCA strategies
LendingApi	DeFi lending market data and yields
MarketApi	Market data, prices, forex, benchmarks
PortfoliosApi	Portfolio management, positions, transactions, capital flows
PublicApi	Public market data (no auth required)
ReportsApi	Performance reports, tax reports, statement reports
TagsApi	Portfolio tags and categorization
UsersApi	User info and subscription management

Risk Catalogue (PRO/ENTERPRISE)

For risk catalogue endpoints that use session-based authentication:

import {
  createRiskCatalogueSessionClient,
} from '@treno-solutions/finance-sdk';

const riskClient = createRiskCatalogueSessionClient(
  'https://app.treno.finance/api',
  'YOUR_API_KEY',
);

const risks = await riskClient.getRiskCatalogue({ categories: ['FINANCIAL'] });

Configuration

Option	Description	Default
basePath	API base URL	https://app.treno.finance/api
fetchApi	Custom fetch function (inject auth headers/params here)	Native fetch

Requirements

• Node.js >= 20 (or any environment with native fetch)
• A valid Treno Finance API key (get one here)

License

MIT