1. 3.3 Foreign Exchange Services
EurewaX Open API
  • Basic Conventions
    • Global Conventions
    • Message Structure
    • Signature
    • Encryption
  • Interaction Flow
    • Business Application Flow
  • Business APIs
    • 1 Common Services
      • 1.1 Event Notifications
        • Configure NotificationURL
      • 1.2 File Service
        • Upload File
        • supplementary business Document
      • 1.3 Authentication Service
        • Get Merchant Token
    • 2 Onboarding Services
      • 2.1 Merchant Onboarding
        • Register Merchant
        • KYCApply for
        • KYBApply for
        • Query KYCReview Result
        • KYCReview ResultNotification
        • Query KYBReview Result
        • KYBReview ResultNotification
        • Get can open through Product List
    • 3 Fiat Services
      • 3.1 Collection Services
        • 3.1.1 Collection Store Management
          • Get Platform Site
          • Add Store Owner
          • Bind Store
          • Query Store Information
        • 3.1.2 VA Account Services
          • Apply for VAAccount Number
          • Download Account OpeningCertificate
          • Query VAAccount Number
          • VAAccount NumberChange Notification
        • 3.1.3 Collection Transaction Processing
          • Collection Crediting Notification
      • 3.2 Payment Services
        • 3.2.1 Payee Management
          • Add Payee
          • Delete Payee
          • Query Payee Review Result
          • Payee Review ResultNotification
        • 3.2.2 Payment Transaction Processing
          • Single Payment
          • Payment ResultNotification
        • 3.2.3 Settlement Quota Management
          • Query FX Settlement Quota
          • Upload FX Settlement Document
          • Query FX Settlement Document Review Result
          • FX Settlement Document Review ResultNotification
      • 3.3 Foreign Exchange Services
        • Query Merchant Exchange Rate
          POST
        • Merchant FX Quote
          POST
        • Real-time FX
          POST
      • 3.4 Account Services
        • 3.4.1 Account Management
          • Account Query
          • Account Authorization
          • Cancel authorization
        • 3.4.2 Account Transactions
          • Account Transfer
          • Batch Transfer
          • Funds Pooling
          • Funds PoolingResultNotification
          • Batch TransferResultNotification
          • Per-transaction TransferResultNotification
      • 3.5 Transaction Queries
        • 3.5.1 Transaction Details
          • Funds PoolingTransaction Details
          • Payment Transaction Details
          • Collection Transaction Details
          • TransferTransaction Details
          • FX Exchange Transaction Details
        • Download Transaction Certificate
        • Query Transaction Details
    • 4 Crypto Services
      • 4.1 Basic Functions
        • Query Exchange Rate
        • Query Supported of asset
      • 4.2 Account Management
        • Query Account List
      • 4.3 Collection Instrument Management
        • Query Collection Instrument
      • 4.4 Payee Management
        • Add Payee
        • Delete Payee
        • Query Payee List
        • Payee Review ResultNotification
      • 4.5 Transaction Management
        • Fiat Deposit
          • Fiat Deposit
        • Fiat Withdrawal
          • Fiat Withdrawal
        • Crypto Deposit
          • Crypto Deposit
        • Crypto Withdrawal
          • Crypto Withdrawal
        • Crypto Buy
          • Get Crypto Buy Quote
          • Buy Crypto
        • Crypto Sell
          • Get Crypto Sell Quote
          • Sell Crypto
        • Fiat convert Crypto
          • Get fiat-to-cryptoQuote
          • Fiat convert Crypto
        • Crypto convert Fiat
          • Get crypto-to-fiatQuote
          • Crypto convert Fiat
        • Deposit/WithdrawalTransaction Fee estimate
        • Query Transaction Details
        • Query Transaction record
        • Transaction ResultNotification
    • 5 VCC Services
      • 5.1 Card Application Services
        • Query Product List
        • Virtual Card Apply for
        • Query Apply for Details
        • Card Apply for ResultNotification
      • 5.2 Card Information Query Services
        • Query Card CVV
        • Query Card Information
        • Query Card Balance
      • 5.3 Card Management Services
        • Unfreeze Card
        • Activate Card
        • Cancel Card
        • Freeze Card
        • Update Card Limit
        • Update Cardholder
        • Card StatusChange Notification
      • 5.4 Card Transaction Services
        • Funds Transfer In
        • Funds Transfer Out
        • Query non-authorization Transaction Details
        • Query Transaction List
        • Query Card Funds Details
        • Card Transaction ResultNotification
        • Card 3DSVerificationNotification
    • 6 Unified Checkout
      • Create Order
      • Query Order Details
      • Payment ResultNotification
  • Integration Testing
    • Overall Flow
    • Environment Parameters
  • Appendix
    • Enum Type
    • KYCtemplate
    • KYBtemplate
  • Schemas
    • TransferOrder
  1. 3.3 Foreign Exchange Services

Query Merchant Exchange Rate

POST
/api/v1/ex/fx/rate/query
Queries the merchant's real-time exchange rate without locking it.

Request

Header Params

Body Params application/json

Example
{
    "merchantNo": "25120114253938",
    "productCode": "PAY-EXC09",
    "sellCurrency": "USD",
    "sellAmount": "10",
    "buyCurrency": "EUR",
    "buyAmount": ""
}

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location '/api/v1/ex/fx/rate/query' \
--header 'x-app-id;' \
--header 'x-request-id;' \
--header 'x-signature;' \
--header 'Content-Type: application/json' \
--data '{
    "merchantNo": "25120114253938",
    "productCode": "PAY-EXC09",
    "sellCurrency": "USD",
    "sellAmount": "10",
    "buyCurrency": "EUR",
    "buyAmount": ""
}'

Responses

🟢200Success
application/json
Bodyapplication/json

Example
{
    "code": "string",
    "message": "string",
    "data": {
        "sellCurrency": "string",
        "buyCurrency": "string",
        "sellAmount": "string",
        "buyAmount": "string",
        "rate": 0
    }
}
Modified at 2026-08-08 08:08:06
Previous
FX Settlement Document Review ResultNotification
Next
Merchant FX Quote
Built with