Exchange Rates

Get exchange rates

Changed on

Retrieve cached exchange rates for currency corridors. Returns FX rates that are cached for approximately 5 minutes. Rates include fees specific to your platform for authenticated requests.

Filtering Options:

  • Filter by source currency to get all available destination corridors
  • Filter by specific destination currency or currencies
  • Provide a sending amount to get calculated receiving amounts

Each rate reports whether its corridor is paying out now (isAvailable).

get/exchange-rates

Request

  • Base URL
    https://api.lightspark.com/grid/2025-10-13
  • URL
    https://api.lightspark.com/grid/2025-10-13/exchange-rates
  • Auth
    HTTP basic

Query parameters

sourceCurrencystring

Filter by source currency code (e.g., USD)

destinationCurrencystring[]

Filter by destination currency code(s). Can be repeated for multiple currencies (e.g., &destinationCurrency=INR&destinationCurrency=GBP)

sendingAmountinteger

Sending amount in the smallest unit of the source currency (e.g., cents for USD). If omitted, USD and USD-pegged currencies default to $100 (10000 USD cents, scaled to the source currency's precision; e.g., 100000000 for USDC, which is 100 USDC). Other currencies default to 10000 in the source currency's smallest unit.

Response

Successful operation

Example response

{
  "data": [
    {
      "sourceCurrency": {
        "code": "USD",
        "name": "United States Dollar",
        "symbol": "$",
        "decimals": 2
      },
      "sendingAmount": 10000,
      "minSendingAmount": 100,
      "maxSendingAmount": 10000000,
      "destinationCurrency": {
        "code": "USD",
        "name": "United States Dollar",
        "symbol": "$",
        "decimals": 2
      },
      "destinationPaymentRail": "UPI",
      "receivingAmount": 1650000,
      "exchangeRate": 0.012121,
      "fees": {
        "fixed": 100,
        "total": 100
      },
      "updatedAt": "2025-02-05T12:00:00Z",
      "isAvailable": true
    }
  ]
}

Changes

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the required property // to the response with the status