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

- ExchangeRateListResponse
  - `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
    - `sendingAmount` integer, required — The sending amount in the smallest unit of the source currency (e.g., cents for USD). Echoed back from the request if provided.
    - `minSendingAmount` integer, required — The minimum supported sending amount in the smallest unit of the source currency.
    - `maxSendingAmount` integer, required — The maximum supported sending amount in the smallest unit of the source currency.
    - `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` 'ACH' | 'BANK_TRANSFER' | 'FAST' | 'FASTER_PAYMENTS' | 'FEDNOW' | 'MOBILE_MONEY' | 'PAYNOW' | 'PIX' | 'RTP' | 'SEPA' | 'SEPA_INSTANT' | 'SPEI' | 'SWIFT' | 'UPI' | 'WIRE', 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 sending currency units per receiving 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-05-28** `d0bce562bffd` — 6 warning
  - added the new `REQUEST_ID_MISSING` enum value to the `code` response property for the response status `401`
  - added the new `SWIFT` enum value to the `data/items/destinationPaymentRail/allOf[#/components/schemas/PaymentRail]/` response property for the response status `200`
  - added the new `WALLET_SIGNATURE_BODY_MISMATCH` enum value to the `code` response property for the response status `401`
  - added the new `WALLET_SIGNATURE_INVALID` enum value to the `code` response property for the response status `401`
  - …2 more
- **2026-04-27** `5b8a8161eeb3` — 1 breaking, 8 warning, 1 info
  - the `data/items/destinationPaymentRail` response's property type/format changed from `string`/`` to ``/`` for status `200`
  - added the new `DATA_MISMATCH` enum value to the `code` response property for the response status `400`
  - added the new `EMAIL_OTP_CREDENTIAL_ALREADY_EXISTS` enum value to the `code` response property for the response status `400`
  - added the new `EXPIRED` enum value to the `code` response property for the response status `400`
  - …6 more
- …earlier changes not shown

[Full 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/d0bce562bffd/schema)