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

# SCT09 - Multi-Currency Financial Operation

> Support for operations across multiple currencies with exchange capabilities via API

# SCT09 - Multi-Currency Financial Operation

Support for operations across multiple currencies with exchange capabilities, enabling global financial services through the API.

## Overview

This capability enables your platform to operate across multiple currencies via API, providing foreign exchange services, multi-currency accounts, and international payment processing.

## Features

| Feature                      | Description                          |
| ---------------------------- | ------------------------------------ |
| **Multi-Currency Accounts**  | Hold balances in multiple currencies |
| **Foreign Exchange**         | Real-time currency conversion        |
| **International Payments**   | Cross-border payment processing      |
| **FX Reporting**             | Currency conversion reporting        |
| **Exchange Rate Management** | Competitive rate sourcing            |

## Configuration Options

| Level        | Currencies                | Features                        |
| ------------ | ------------------------- | ------------------------------- |
| **Basic**    | Major currencies only (8) | Standard FX rates               |
| **Standard** | Extended (30+)            | Competitive rates, FX reporting |
| **Advanced** | Global (100+)             | Real-time FX, rate locking      |

## API Usage

### Get Exchange Rate

```bash theme={null}
GET /api/v1/fx/rates?from=EUR&to=USD
Authorization: Bearer {access_token}
```

**Response:**

```json theme={null}
{
  "from_currency": "EUR",
  "to_currency": "USD",
  "rate": 1.0850,
  "inverse_rate": 0.9217,
  "timestamp": "2024-01-15T10:30:00Z",
  "valid_until": "2024-01-15T10:31:00Z"
}
```

### Execute Currency Conversion

```bash theme={null}
POST /api/v1/fx/convert
Content-Type: application/json
Authorization: Bearer {access_token}

{
  "source_account_id": "acc_eur_123",
  "destination_account_id": "acc_usd_456",
  "source_amount": 1000.00,
  "source_currency": "EUR",
  "destination_currency": "USD"
}
```

**Response:**

```json theme={null}
{
  "conversion_id": "fx_abc789",
  "source_amount": 1000.00,
  "source_currency": "EUR",
  "destination_amount": 1085.00,
  "destination_currency": "USD",
  "rate_applied": 1.0850,
  "fee": 5.00,
  "status": "COMPLETED"
}
```

### Create Multi-Currency Account

```bash theme={null}
POST /api/v1/accounts
Content-Type: application/json
Authorization: Bearer {access_token}

{
  "customer_id": "cust_123456",
  "account_type": "MULTI_CURRENCY",
  "currencies": ["EUR", "USD", "GBP"],
  "primary_currency": "EUR"
}
```

## Supported Currencies

### Major Currencies

USD, EUR, GBP, JPY, CHF, CAD, AUD, NZD

### European Currencies

SEK, NOK, DKK, PLN, CZK, HUF, RON, BGN

### Other Currencies

AED, SAR, ZAR, BRL, MXN, SGD, HKD, and 100+ more

## Integration with Other Capabilities

| Capability                    | Integration                      |
| ----------------------------- | -------------------------------- |
| **SCT03 - Country**           | Available currencies per country |
| **SCT04 - Instant Payment**   | Cross-currency instant transfers |
| **SCT12 - Financial Network** | International payment rails      |

## Related API Reference

<Card title="FX APIs" icon="money-bill-transfer" href="/baas/api/reference/financial-operations/transfers">
  View detailed FX API specifications
</Card>

## Subscription Tier Availability

| Tier         | Configuration Level |
| ------------ | ------------------- |
| Starter      | Not included        |
| Professional | Standard            |
| Enterprise   | Advanced            |
| Custom       | Configurable        |