# Currency

#### **Table of Contents**

- [Description](#bkmrk-description)
- [Examples](#bkmrk-examples)
- [Cookbook](#bkmrk-cookbook)
- [F.A.Q.](#bkmrk-api-documentation)
- [API Documentation](#bkmrk-api-documentation)

#### **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](https://docs.finmars.com/books/entities/page/transactions "Transactions"), valuations, and [reporting](https://docs.finmars.com/books/reports "Reports"). Currencies are linked to [instruments](https://docs.finmars.com/books/entities/page/instrument "Instrument"), [portfolios](https://docs.finmars.com/books/entities/page/portfolio "Portfolio"), 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](https://docs.finmars.com/books/entities/page/portfolio "Portfolio") as part of asset allocation
- [reporting ](https://docs.finmars.com/books/reports "Reports")in multiple currencies using [FX rate ](https://docs.finmars.com/books/entities/page/fx-rate-currency-history-eN8 "FX Rate (Currency History)")conversions
- [reconciliation](https://docs.finmars.com/books/reports/chapter/reconciliation "Reconciliation") by matching positions and [transactions](https://docs.finmars.com/books/entities/chapter/transactions "Transactions") by currency

#### **Examples**

<table border="1" id="bkmrk-user-code-country-sh" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 16.6667%;"></col><col style="width: 16.6667%;"></col><col style="width: 16.6667%;"></col><col style="width: 16.6667%;"></col><col style="width: 16.6667%;"></col><col style="width: 16.6667%;"></col></colgroup><tbody><tr><td>**User Code**</td><td>**Country**</td><td>**Short Name**</td><td>**Name**</td><td>**Public Name**</td><td>**Notes**</td></tr><tr><td>EUR</td><td>Europe</td><td>EUR</td><td>Euro</td><td>EUR</td><td>  
</td></tr></tbody></table>

- `<strong data-end="184" data-start="171">User code</strong>:` internal system identifier for the currency.
- `<strong data-end="314" data-start="303">Country</strong>`: 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).
- `<strong data-end="554" data-start="540">Short name</strong>`: standard currency code (typically ISO 4217 format), used across the system in relations, selections, and dropdowns (e.g., "USD", "GBP", "BTC").
- `<strong data-end="711" data-start="703">Name</strong>`: full name of the currency (e.g., "US Dollar", "Pound Sterling", "Bitcoin") used in detailed views or documentation.
- `<strong data-end="847" data-start="832">Public name</strong>`: display name for external users or limited-access users, often identical to the short name (e.g., "EUR", "HKD"); controls visibility in shared environments.
- `<strong data-end="1018" data-start="1009">Notes</strong>`: 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.