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)

get

/quotes/{sourceCountry}//{sourceCurrency}//{destinationCountry}//{destinationCurrency}//{amountCurrency}//{amount}

Path parameters

sourceCountrystringrequired

2-letter country code for the Source Country

Example: SG

sourceCurrencystringrequired

3-letter currency code for the Source Currency

Example: SGD

destinationCountrystringrequired

2-letter country code for the Destination Country

Example: TH

destinationCurrencystringrequired

3-letter currency code for the Destination Currency

Example: THB

amountCurrencystringrequired

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

amountnumberrequired

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

finInstIdTypestringrequired

Type ID of the financial institution.

finInstIdstringrequired

ID of the financial institution.

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'http://localhost:3000/quotes/{sourceCountry}/{sourceCurrency}/{destinationCountry}/{destinationCurrency}/{amountCurrency}/{amount}?finInstIdType=text&finInstId=text'

200

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,
      "intermediaryAgent1Account": {
        "id": "2345678901"
      },
      "intermediaryAgent2Account": {
        "id": "8881234569"
      },
      "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
          }
        }
      },
      "intermediaryAgent2": {
        "finInstId": {
          "name": "Kasikornbank Public Company Limited",
          "BICFI": "KASITHBK",
          "LEI": null,
          "clearingSystemMemberId": {
            "clearingSystemId": null,
            "memberId": null
          },
          "other": {
            "id": null
          }
        }
      },
      "creditorAgent": {
        "creditorAccountAmount": 23900,
        "interbankSettlementAmount": {
          "amount": 24000,
          "currency": "THB",
          "cappedToMaxAmount": false
        },
        "chargesInformation": {
          "amount": {
            "amount": 100,
            "currency": "THB"
          }
        }
      }
    }
  ]
}

Quotes retrieved successfully