@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