020 7898 0500Call this API to book multiple spot deals at once. You will need to submit a CSV file to this endpoint using form data, a summary CSV file is then returned.
Request URL #
https://api-sandbox.smartcurrencyexchange.com/v4/Trade/BookBatchForwardDeals
| Field | In | Format | Description | Required |
| Authorization | header | string | Authentication token | Mandatory |
| Forward.csv | Body | Form-data file | The file containing the details of the spot contracts to be booked | Mandatory |
| Date | File | String | Format: DD/MM/YYYY Date of booking | Mandatory |
| Source Currency | File | String | Selling currency’s three-digit code | Mandatory |
| Target Currency | File | String | Buying currency’s three-digit code | Mandatory |
| SourceAmount | File | Decimal | Enter desired selling amount | Either source amount or target amount |
| TargetAmount | File | Decimal | Enter desired buying amount | Either source amount or target amount |
| Value Date | body | String | Format: DD/MM/YYYY | Mandatory |
Request Sample (CSV) #
Date,Source Currency,Target Currency,Source Amount,Target Amount,Value Date
17/06/2022,GBP,EU,18000,0,29/07/2022
17/06/2022,GBP,USD,0,5000,29/07/2022
17/06/2022,GBP,NOK,8000,0,29/07/2022Response Sample (CSV) #
Date Created, SourceCurrency, TargetCurrency, SourceAmount, TargetAmount, Rate, Trade Booked?, Reason for Failure,
17/06/2022, GBP, EU, 18000, 0, , Parameters passed are not valid please check again: TargetCurrency must be a string with a length of 3.,
17/06/2022, GBP, USD, 4172.6500000, 5000.0000000, 1.1982804, Trade Booked,
17/06/2022, GBP, NOK, 8000.0000000, 96526.4100000, 12.0658017, Your transfer has been saved as QUOTE only. Please get in touch with your trader if you want to convert it to a trade,Response Codes #
| HTTP Status | Description | Message |
| 200 | Success | Success |
| 401 | Token Expired or invalid token | Token is no longer valid, please login again. |
| 401 | Missing token | Please add ‘Authorization’ to your request header. |
| 400 | No file uploaded | Please upload one CSV file to do the batch booking via form data |
| 400 | Multiple files uploaded | Please upload only one CSV file |
| 400 | Non-CSV file uploaded | Please pass a .csv file to process |
