> ## Documentation Index
> Fetch the complete documentation index at: https://docs.corebanq.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Currencies overview

> Currency management and exchange rate functionality

## Overview

The Currencies API provides functionality for managing:

* Currency definitions (ISO 4217)
* Exchange rates and conversions
* Historical rate tracking
* Currency formatting

## Core Concepts

### Currency Properties

| Field            | Description       | Format         |
| ---------------- | ----------------- | -------------- |
| `code`           | Currency code     | ISO 4217       |
| `name`           | Currency name     | String         |
| `symbol`         | Currency symbol   | String         |
| `decimal_places` | Decimal precision | Integer        |
| `format`         | Display format    | String pattern |

### Exchange Rate Types

* `spot`: Current market rate
* `forward`: Future date rate
* `historical`: Past date rate

### Rate Components

| Component | Description     |
| --------- | --------------- |
| `mid`     | Mid-market rate |
| `buy`     | Buy-side rate   |
| `sell`    | Sell-side rate  |
| `margin`  | Applied margin  |

## Validation Rules

### Currency Codes

* Must be valid ISO 4217 code
* Exactly 3 uppercase letters
* Must be active currency

### Amount Constraints

* Non-negative values
* Within min/max limits
* Proper decimal places

## Security Requirements

* Rate updates require elevated access
* Conversion limits may apply
* Rate changes are audited
* Source must be authorized

<Note>
  See individual endpoint documentation for detailed request/response formats and examples.
</Note>