# Currency
Currency is composed of a canonical Symbol and Decimals. This Decimals value is used to convert an Amount.Value from atomic units (Satoshis) to standard units (Bitcoins).
## Example Usage
```typescript
import { Currency } from "icpmcp-rosetta-api";
let value: Currency = {
symbol: "BTC",
decimals: 8,
metadata: {},
};
```
## Fields
| Field | Type | Required | Description | Example |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `symbol` | *string* | :heavy_check_mark: | Canonical symbol associated with a currency. | BTC |
| `decimals` | *number* | :heavy_check_mark: | Number of decimal places in the standard unit representation of the amount. For example, BTC has 8 decimals. Note that it is not possible to represent the value of some currency in atomic units that is not base 10. | 8 |
| `metadata` | [models.CurrencyMetadata](../models/currencymetadata.md) | :heavy_minus_sign: | Any additional information related to the currency itself. For example, it would be useful to populate this object with the contract address of an ERC-20 token. | {<br/>"Issuer": "Satoshi"<br/>} |
