Open Exchange Rates/getLatestRates

Loading the complete reference automatically…

Open Exchange RatesOpen Exchange Rates API

GET/latest.json

Get latest rates

Returns the latest rates available to the caller's plan.

Query latest, historical, time-series, and OHLC rates, supported currencies, conversions, and plan usage. Supplier terms restrict providing the data through Hub, so callers use their own App ID through the local SDK or CLI.

Request

operationId
getLatestRates
Server
https://openexchangerates.org/api
Authentication
appId

Request parameters

base

querystring

Optional three-letter base-currency code; the supplier uses USD when omitted.

USD

symbols

querystring

Optional comma-separated list of three-letter currency codes.

EUR,GBP

prettyprint

queryboolean

Whether to return debug-friendly formatted JSON.

false

show_alternative

queryboolean

Whether to include alternative, black-market, and digital-currency rates.

false

Responses

200

StandardRatesResponseapplication/json

The request succeeded.

Properties: disclaimerlicensetimestampbaserates

400

ApiErrorapplication/json

The request parameters are invalid.

Properties: errorstatusmessagedescription

401

ApiErrorapplication/json

The App ID is missing or invalid.

Properties: errorstatusmessagedescription

403

ApiErrorapplication/json

The request was denied by an access restriction.

Properties: errorstatusmessagedescription

404

ApiErrorapplication/json

The requested route does not exist.

Properties: errorstatusmessagedescription

429

ApiErrorapplication/json

The caller exceeded plan permission or a service limit.

Properties: errorstatusmessagedescription

{
  "disclaimer": "https://openexchangerates.org/terms/",
  "license": "https://openexchangerates.org/license/",
  "timestamp": 1449877801,
  "base": "USD",
  "rates": {}
}