Trade Management

POST Book Spot Deal

Request Sample

{
    "sourceCurrency": "GBP",
    "targetCurrency": "EUR",
    "sourceAmount": 500.00,
    "targetAmount": 0,
    "rateId": 1757807,
    "transferReasonId": 0
}

Response Sample

{
    "fxId": 1234567,
    "status": "NEW",
    "fxContractId": "FX2021-xxx",
    "sourceCurrency": "GBP",
    "targetCurrency": "EUR",
    "sourceAmount": 500.00,
    "targetAmount": 568.70
}

Call this API to book a spot contract with the rate ID retrieved from Spot Rate API Call.

Request URL

https://api.scestaging.com/v3/Trade/BookSpotDeal

Field	In	Format	Description	Required
token	header	string	Authentication token	Mandatory
sourceCurrency	body	string	Selling currency’s three-digit code	Mandatory
targetCurrency	body	string	Buying currency’s three-digit code	Mandatory
sourceAmount	body	Number	Enter desired selling amount	Either source amount or target amount
targetAmount	body	Number	Enter desired buying amount	Either source amount or target amount
rateId	body	number	Id retrieved from Spot Rate quote	Mandatory
extRefID	body	string	Client can add an external reference for each payment	Optional
transferReasonID	body	number		Optional

Response codes

HTTP Status	Description	Message
200	Success	Success
400	Incorrect credentials	Not authorized, Please Login again.

 

 

POST Book Forward Deal

Request Sample

{
    "rateId": 1234,
    "sourceCurrency": "GBP",
    "targetCurrency": "USD",
    "sourceAmount": 3000,
    "targetAmount": 0,
    "valueDate": "24/03/2022",
    "rate": 1.3823587,
    "transferReasonId": 0
}

Response Sample

{
    "fxId": 123456,
    "status": "NEW",
    "fxContractId": "FX2021-xxx",
    "sourceCurrency": "GBP",
    "targetCurrency": "USD",
    "sourceAmount": 3000,
    "targetAmount": 4147.08
}

Call this API to book a forward contract with the rate ID retrieved from Forward Rate API Call.

 

Request URL

https://api.scestaging.com/v3/Trade/BookForwardDeal

Field	In	Format	Description	Required
token	header	string	Authentication token	Mandatory
rateId	body	number	Id retrieved from Forward Rate quote	Mandatory
sourceCurrency	body	string	Selling currency three-digit code	Mandatory
targetCurrency	body	string	Buying currency three-digit code	Mandatory
sourceAmount	body	Number	Enter desired selling amount	Either source amount or target amount
targetAmount	body	Number	Enter desired buying amount	Either source amount or target amount
valueDate	body	String	Format: DD/MM/YYYY	Mandatory
extRefID	body	String	Client can add an external reference for each payment	Optional
transferReasonID	body	Number		Optional

 

Response codes

HTTP Status	Description	Message
200	Success	Success
400	Incorrect credentials	Not authorized, Please Login again.
400	Incorrect RateID	The rateId you entered doesn’t match with other details. Please double check

 

 

POST Book Same Currency

Request Sample

{
    "beneficiaryId": 1234,
    "currency": "GBP",
    "amount": 500.00,
    "transferDate": ”27/02/2021”
}

Response Sample

Payment request has been saved successfully into our system. Our team will get in touch if we need any more information from you

This API call allows you to book a  Same currency transfer. (GBP payment is only allowed for now)

Request URL

https://api.scestaging.com/v3/Trade/BookSameCurrencyTransfer

Field	In	Format	Description	Required
token	header	string	Authentication token	Mandatory
beneficiaryId	text	integer	Beneficiary’s ID	Mandatory
beneficiaryReference	text	string	Reference associated to beneficiary	Optional
amount	body	Number	Amount to be entered	Mandatory
currency	body	string	Three-digit currency code	Mandatory
transferDate	body	string	Format: DD/MM/YYYY	Mandatory

Response codes

HTTP Status	Description	Message
200	Success	Success
400	Incorrect credentials	Not authorized, Please Login again.