# Retrieve current rates

The `from`, `to`, and `group` parameters are not testable in our Sandbox environment at this time.
`GET /rates`
Fetch latest exchange rates of all currencies.
`GET /rates?source=EUR&target=USD`
Fetch latest exchange rate of one currency pair.
`GET /rates?source=EUR&target=USD&time=2019-02-13T14:53:01`
Fetch exchange rate of specific historical timestamp.
`GET /rates?source=EUR&target=USD&from=2019-02-13T14:53:01&to=2019-03-13T14:53:01&group=day`
Fetch exchange rate history over period of time with daily interval.
`GET /rates?source=EUR&target=USD&from=2019-02-13T14:53:01&to=2019-03-13T14:53:01&group=hour`
Fetch exchange rate history over period of time with hourly interval.
`GET /rates?source=EUR&target=USD&from=2019-02-13T14:53:01&to=2019-03-13T14:53:01&group=minute`
Fetch exchange rate history over period of time with 1 minute interval.
This endpoint only supports Bearer authentication for non-Affiliate partners.

Endpoint: GET /rates
Security: UserToken, PersonalToken

## Query parameters:

  - `source` (string)
    Source (send) currency code.

  - `target` (string)
    Target (receive) currency code.

  - `time` (string)
    Timestamp to get historic exchange rate. <br>Supports only Timestamp (combined date and time). Timezone offset is supported but optional. <br>Supported examples: `2019-03-13T14:53:01` or `2019-03-13T14:53:01+0100`.

  - `from` (string)
    Period start date/time to get exchange rate history. <br>Supports Timestamp (combined date and time) or Date (date only). <br>Supported examples: `2019-03-13T14:53:01` or `2019-03-13`.

  - `to` (string)
    Period end date/time to get exchange rate history. <br>Supports Timestamp (combined date and time) or Date (date only). <br>Timezone offset is supported but optional. <br>Supported examples: `2019-03-13T14:53:01+0100` or `2019-03-13+0100`.

  - `group` (string)
    Interval for history grouping.

## Header parameters:

  - `X-External-Correlation-Id` (string)
    Optional UUID for correlating requests across systems. If provided, Wise echoes it back in the response. Maximum 36 characters. [Learn more](/guides/developer/headers/correlation-id).

## Response 200 fields (application/json):

  - `rate` (number, required)
    Exchange rate value.
    Example: 1.166

  - `source` (string, required)
    Source (send) currency code.
    Example: EUR

  - `target` (string, required)
    Target (receive) currency code.
    Example: USD

  - `time` (string, required)
    Timestamp for exchange rate.
    Example: 2018-08-31T10:43:31+0000

