---
title: "Get exchange rates"
method: GET
path: "/exchange-rates"
tags: ["Exchange Rates"]
---

# Get exchange rates

`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

## Query parameters

- `sourceCurrency` string
- `destinationCurrency` string[]
- `sendingAmount` integer

## Response `200`

Successful operation

- object
  - `data` ExchangeRate[], required — List of exchange rates matching the filter criteria
    - `sourceCurrency` Currency, required
      - `code` string — Three-letter currency code (ISO 4217) for fiat currencies. Some cryptocurrencies may use their own ticker symbols (e.g. "BTC" for Bitcoin, "USDC" for USDC, etc.)
      - `name` string — Full name of the currency
      - `symbol` string — Symbol of the currency
      - `decimals` integer — Number of decimal places for the currency
    - `sourcePaymentRail` string — The payment rail used for the source (e.g., ACCOUNT, RTP)
    - `sendingAmount` integer — The sending amount in the smallest unit of the source currency (e.g., cents for USD). Echoed back from the request if provided.
    - `destinationCurrency` Currency, required
      - `code` string — Three-letter currency code (ISO 4217) for fiat currencies. Some cryptocurrencies may use their own ticker symbols (e.g. "BTC" for Bitcoin, "USDC" for USDC, etc.)
      - `name` string — Full name of the currency
      - `symbol` string — Symbol of the currency
      - `decimals` integer — Number of decimal places for the currency
    - `destinationPaymentRail` string, required — The payment rail used for the destination (e.g., UPI, SEPA_INSTANT, MOBILE_MONEY, FASTER_PAYMENTS)
    - `receivingAmount` integer, required — The receiving amount in the smallest unit of the destination currency
    - `exchangeRate` number, required — Number of destination currency units per sending currency unit
    - `fees` ExchangeRateFees, required — Fees associated with an exchange rate
      - `fixed` integer — Fixed fee in the smallest unit of the sending currency (e.g., cents for USD)
    - `updatedAt` string, date-time, required — Timestamp when this exchange rate was last refreshed

## Other responses

- `400` — Bad request - Invalid parameters
- `401` — Unauthorized
- `500` — Internal service error

## Changes

- **2026-02-06** `9d1655bef82d` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/lightsparkdev/apis/grid-api/changes/exchange-rates/get.md)

---

[API](https://skmtc.dev/lightsparkdev/apis/grid-api.md) · [All operations](https://skmtc.dev/lightsparkdev/apis/grid-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/lightsparkdev/grid-api/revisions/9d1655bef82d/schema)