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.

Types of Currency:

  1. Fiat Currency: Issued by governments (e.g., USD, EUR) with no intrinsic value but accepted by law.

  2. Digital Currency: Exists only in digital form (e.g., cryptocurrencies like Bitcoin).

  3. Foreign Currency: Currency of another country used in international trade or investment.

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 also used in:

    • Instrumentinstrument pricing and valuation – Every instrument is associated with a base currency for accurate market value calculations.association

    • Cash positions in portfolios – Currencies represent the cash componentpositioning inwithin portfolios as part of asset allocation.allocation

    • Reporting and conversions – Enables reporting in differentmultiple currencies using FX ratesrate for conversions.conversions

    • Reconciliationreconciliation – Supportsby matching of positions and transactions by currency as part of reconciliation workflows.

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