URL: /baas/api/capabilities/sct09-multi-currency

---
title: "SCT09 - Multi-Currency Financial Operation"
description: "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
GET /api/v1/fx/rates?from=EUR&to=USD
Authorization: Bearer {access_token}
```

**Response:**
```json
{
  "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
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
{
  "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
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="banknote" 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 |