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

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

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": 0.012121,
      "fees": {
        "fixed": 100,
        "total": 150
      },
      "updatedAt": "2025-02-05T12:00:00Z",
      "isAvailable": true
    },
    {
      "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": 9250,
      "exchangeRate": 1.081081,
      "fees": {
        "fixed": 10,
        "total": 15
      },
      "updatedAt": "2025-02-05T12:00:00Z",
      "isAvailable": false
    }
  ]
}

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 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

200

application/json

Successful operation

data · object[] · required

List of exchange rates matching the filter criteria

Show child attributes