Skip to main content

Currency

Table of Contents

Description

Financial meaning

Currency is a system of money used in a particular country or region to facilitate trade, value goods/services, and store wealth. It is a medium of exchange, a unit of account, and a store of value—the three key functions of money in economics.

Platform abstraction

Currency in the Finmars platform is a reference entity that represents monetary units used across all financial operations, including transactions, valuations, and reporting. Currencies are linked to instruments, portfolios, and other modules where value tracking is required.

Currency also is used in:

  • instrument pricing and valuation with base currency association

  • cash positioning within portfolios as part of asset allocation

  • reporting in multiple currencies using FX rate conversions

  • reconciliation by matching positions and transactions by currency

Examples

User Code Country Short Name Name Public Name Notes
EUR Europe EUR Euro EUR
  • User code: internal system identifier for the currency.

  • Country: the country or region that officially issues or predominantly uses the currency (e.g., "Switzerland" for CHF, "Europe" for EUR); "Worldwide" used for globally recognized assets like BTC, Silver (XAG), or Palladium (XPD).

  • Short name: standard currency code (typically ISO 4217 format), used across the system in relations, selections, and dropdowns (e.g., "USD", "GBP", "BTC").

  • Name: full name of the currency (e.g., "US Dollar", "Pound Sterling", "Bitcoin") used in detailed views or documentation.

  • Public name: display name for external users or limited-access users, often identical to the short name (e.g., "EUR", "HKD"); controls visibility in shared environments.

  • Notes: optional field for internal comments, labels, or usage notes – can be left blank or filled with custom metadata (e.g., restrictions, FX rules, system flags).

Cookbook

CRUD

Operations within platform.

Use Cases

What for it's used.

F.A.Q.

API documentation

Back to top