---
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' | 'ACH_COLOMBIA' | 'BANK_TRANSFER' | 'BRE_B' | 'CIPS' | 'FAST' | 'FASTER_PAYMENTS' | 'FEDNOW' | 'INSTAPAY' | 'MOBILE_MONEY' | 'NEFT' | 'PAYNOW' | 'PESONET' | 'PIX' | 'RTGS' | 'RTP' | 'SEPA' | 'SEPA_INSTANT' | 'SPEI' | 'SWIFT' | 'UNIONPAY' | '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)
      - `total` integer — Total fees in the smallest unit of the sending currency (e.g., cents for USD). This value may change depending on the sending amount used; if no sending amount is specified, it falls back to the default.
    - `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

---

[API](https://skmtc.net/stainless-api/apis/grid-api.md) · [All operations](https://skmtc.net/stainless-api/apis/grid-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/stainless-api/grid-api/revisions/151f2d9bad9c/schema)