Create a Forex Booking
This API allows clients to book an FX trade by specifying the currency pair, amount, and type. It is currently supported for clients operating under a pre-agreed pricing model with the bank, allowing them to execute FX trades without needing to request an executable rate beforehand.
Authorization
authorization Set Your Secret API Key
In: header
Header Parameters
A unique value, eg. a UUID.
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
The trade amount in a positive integer value in the specified currency's smallest unit. e.g. for SGD, $10 would be represented as 1000 (cents).
int64A currency pair is two currency codes. The first is known as the base currency and the second as the quote currency. Each currency code is a three-letter ISO 4217 currency code in full uppercase. USDSGD with BUY type means you want to buy USD by selling SGD; USDSGD with SELL type means you want to sell USD to buy SGD.
^[A-Z]{6}$The tenor for the forex booking.
Value in
- "TODAY"
The type of the trade.
Value in
- "BUY"
- "SELL"
Response Body
*/*
application/json
application/json
curl -X POST "https://example.com/v1/forex/booking" \
-H "Content-Type: application/json" \
-d '{
"amount": 0,
"currencyPair": "string",
"tenor": "TODAY",
"type": "BUY"
}'{
"amount": 0,
"contraAmount": 0,
"createdAt": "string",
"currencyPair": "string",
"id": "string",
"rate": "string",
"resultCode": "string",
"sourceTraceId": "string",
"status": "string",
"tenor": "string",
"transactionReference": "string",
"type": "string",
"updatedAt": "string"
}