Get exchange rates

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

GET /exchange-rates

Get exchange rates

cURL

curl --request GET \
  --url https://api.lightspark.com/grid/2025-10-13/exchange-rates \
  --header 'Authorization: Basic <encoded-value>'

200

{
  "data": [
    {
      "sourceCurrency": {
        "code": "USD",
        "decimals": 2,
        "name": "US Dollar",
        "symbol": "$"
      },
      "sendingAmount": 10000,
      "minSendingAmount": 100,
      "maxSendingAmount": 10000000,
      "destinationCurrency": {
        "code": "INR",
        "decimals": 2,
        "name": "Indian Rupee",
        "symbol": "₹"
      },
      "destinationPaymentRail": "UPI",
      "receivingAmount": 825000,
      "exchangeRate": 82.5,
      "fees": {
        "fixed": 100
      },
      "updatedAt": "2025-02-05T12:00:00Z"
    },
    {
      "sourceCurrency": {
        "code": "USD",
        "decimals": 2,
        "name": "US Dollar",
        "symbol": "$"
      },
      "sendingAmount": 10000,
      "minSendingAmount": 100,
      "maxSendingAmount": 10000000,
      "destinationCurrency": {
        "code": "EUR",
        "decimals": 2,
        "name": "Euro",
        "symbol": "€"
      },
      "destinationPaymentRail": "SEPA_INSTANT",
      "receivingAmount": 18500,
      "exchangeRate": 0.925,
      "fees": {
        "fixed": 10
      },
      "updatedAt": "2025-02-05T12:00:00Z"
    }
  ]
}

Authorizations

Authorization · string · header · required

API token authentication using format <api token id>:<api client secret>

Query Parameters

sourceCurrency · string

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

destinationCurrency · string[]

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

sendingAmount · integer<int64> · default: 10000

Sending amount in the smallest unit of the source currency (e.g., cents for USD). If no amount is provided, the default is 10000 in the sending currency smallest unit.

Required range: x >= 0

Response

200

application/json

Successful operation

data · object[] · required

List of exchange rates matching the filter criteria

Show child attributes