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 rateforward: Future date ratehistorical: 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
See individual endpoint documentation for detailed request/response formats and examples.
