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
-
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.
Frequently asked questions.
API documentation
Link to API documentation.