Quotes

Get quotes for a specific currency pair and amount

Retrieves a list of quotes for currency exchange based on the specified country/currency pair and the amount (denominated in either the source currency or destination currency)

GEThttp://localhost:3000/quotes/{sourceCountry}/{sourceCurrency}/{destinationCountry}/{destinationCurrency}/{amountCurrency}/{amount}

Path parameters

sourceCountry*string

2-letter country code for the Source Country

Example: "SG"

sourceCurrency*string

3-letter currency code for the Source Currency

Example: "SGD"

destinationCountry*string

2-letter country code for the Destination Country

Example: "TH"

destinationCurrency*string

3-letter currency code for the Destination Currency

Example: "THB"

amountCurrency*string

Source Currency if the Sender defined the amount to be sent. Destination Currency if the Sender defined the amount to be received by the Recipient.

Example: "SGD"

amount*number

The amount to be exchanged. If the Sender defined the amount to be sent in the source currency, the amount here must be the amount set by the Sender MINUS any Source PSP Deducted Fee. If the Sender defined the amount for the Recipient to receive, then the amount here is the amount that will be credited to the Recipient's account.

Example: 1000

Query parameters

Response

200

Quotes retrieved successfully

Body

application/json

quoteRequestIdstring

A universally unique ID for the overall quote request. (Each individual quote in this response has its own unique Quote Id)

Example: "d302cc08-323b-4ac6-897e-579a9abe0c88"

sourceCountrystring

2-letter country code for the Source Country

Example: "SG"

sourceCurrencystring

3-letter country code for the Source Country

Example: "SGD"

destinationCountrystring

2-letter country code for the Destination Country

Example: "TH"

destinationCurrencystring

3-letter country code for the Destination Country

Example: "THB"

amountCurrencystring

Source Currency if the Sender defined the amount to be sent. Destination Currency if the Sender defined the amount to be received by the Recipient.

Example: "SGD"

amountnumber

The amount to be exchanged. If the Sender defined the amount to be sent in the source currency, the amount here must be the amount set by the Sender MINUS any Source PSP Deducted Fee. If the Sender defined the amount for the Recipient to receive, then the amount here is the amount that will be credited to the Recipient's account.

Example: 1000

quotesarray of object

Request

JavaScriptCurlPython

const response = await fetch('http://localhost:3000/quotes/{sourceCountry}/{sourceCurrency}/{destinationCountry}/{destinationCurrency}/{amountCurrency}/{amount}?finInstIdType=text&finInstId=text', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

{
  "quoteRequestId": "d302cc08-323b-4ac6-897e-579a9abe0c88",
  "sourceCountry": "SG",
  "sourceCurrency": "SGD",
  "destinationCountry": "TH",
  "destinationCurrency": "THB",
  "amountCurrency": "SGD",
  "amount": 1000,
  "quotes": [
    {
      "quoteId": "855cd802-8c7b-4fd2-8ce7-a456c1e12509",
      "issuedDateTime": "2024-10-22T12:00:00Z",
      "fxpfinInstIdType": "BICFI",
      "fxpfinInstId": "FXSGAAAA",
      "exchangeRate": 25,
      "debtorAgent": {
        "interbankSettlementAmount": {
          "currency": "SGD",
          "amount": 960,
          "cappedToMaxAmount": false
        },
        "nexusSchemeFee": {
          "amount": 1.5,
          "currency": "SGD"
        }
      },
      "intermediaryAgent1": {
        "finInstId": {
          "name": "DBS Bank Ltd",
          "BICFI": "DBSSSGSG",
          "LEI": "ATUEL7OJR5057F2PV266",
          "clearingSystemMemberId": {
            "clearingSystemId": null,
            "memberId": null
          },
          "other": {
            "id": null
          }
        }
      },
      "intermediaryAgent1Account": {
        "id": "2345678901"
      },
      "intermediaryAgent2": {
        "finInstId": {
          "name": "Kasikornbank Public Company Limited",
          "BICFI": "KASITHBK",
          "LEI": null,
          "clearingSystemMemberId": {
            "clearingSystemId": null,
            "memberId": null
          },
          "other": {
            "id": null
          }
        }
      },
      "intermediaryAgent2Account": {
        "id": "8881234569"
      },
      "creditorAgent": {
        "interbankSettlementAmount": {
          "amount": 24000,
          "currency": "THB",
          "cappedToMaxAmount": false
        },
        "chargesInformation": {
          "amount": {
            "amount": 100,
            "currency": "THB"
          }
        },
        "creditorAccountAmount": 23900
      }
    }
  ]
}