@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

@treno.solutions/finance-sdk

Package Exports

Readme