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, 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
GET /api/v1/fx/rates?from=EUR & to = USD
Authorization: Bearer {access_token}
Response:
{
"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
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:
{
"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
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
FX APIs View detailed FX API specifications
Subscription Tier Availability
Tier Configuration Level Starter Not included Professional Standard Enterprise Advanced Custom Configurable