---
title: "Retrieve current rates"
method: GET
path: "/v1/rates"
tags: ["rate"]
---

# Retrieve current rates

`GET /v1/rates`

{% admonition type="warning" %}
The `from`, `to`, and `group` parameters are not testable in our Sandbox environment at this time.
{% /admonition %}

`GET /v1/rates`<br>
Fetch latest exchange rates of all currencies.

`GET /v1/rates?source=EUR&target=USD`<br>
Fetch latest exchange rate of one currency pair.

`GET /v1/rates?source=EUR&target=USD&time=2019-02-13T14:53:01`<br>
Fetch exchange rate of specific historical timestamp.

`GET /v1/rates?source=EUR&target=USD&from=2019-02-13T14:53:01&to=2019-03-13T14:53:01&group=day`<br>
Fetch exchange rate history over period of time with daily interval.

`GET /v1/rates?source=EUR&target=USD&from=2019-02-13T14:53:01&to=2019-03-13T14:53:01&group=hour`<br>
Fetch exchange rate history over period of time with hourly interval.

`GET /v1/rates?source=EUR&target=USD&from=2019-02-13T14:53:01&to=2019-03-13T14:53:01&group=minute`<br>
Fetch exchange rate history over period of time with 1 minute interval.

{% admonition type="warning" %}
This endpoint only supports Bearer authentication for non-Affiliate partners.
{% /admonition %}

## Query parameters

- `source` string
- `target` string
- `time` string
- `from` string
- `to` string
- `group` 'day' | 'hour' | 'minute'

## Headers

- `X-External-Correlation-Id` string, uuid

## Response `200`

List of exchange rate values which meet your query criteria.

- object[]
  - `rate` number, double, required — Exchange rate value.
  - `source` string, required — Source (send) currency code.
  - `target` string, required — Target (receive) currency code.
  - `time` string, required — Timestamp for exchange rate.

## Other responses

- `400` — Invalid request.
- `429` — Rate limit exceeded. Retry after the number of seconds specified in the `Retry-After` header.

---

[API](https://skmtc.net/wise/apis/platform-api.md) · [All operations](https://skmtc.net/wise/apis/platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/wise/platform-api/revisions/4907a1d269ab/schema)