Endpoints

Each API endpoint has the following format:

https://web-services.oanda.com/rates/api/v1/:endpoint.:output_format

OR for the Rates endpoint and Currencies endpoint:

https://web-services.oanda.com/rates/api/v1/rates/:base_currency.:output_format[?parameter=value…]

output_format

The :output_format parameter determines how information is returned. It can take on one of the following values:

  • json – Javascript Object Notation
    • All real numbers in JSON responses are returned as strings to prevent JSON parsers from damaging the precision of the quotes.
  • xml – Well-formed XML document
  • csv – Comma Separated Values
    • Can be imported into most spreadsheet and financial applications
    • Note that CSV format provides standard Unix-like line endings (Unix, Linux, *BSD, MacOS > 9 among others) via an LF character (hex: 0x0A; dec: 10)
    • Due to the limitations of this format, it will often not return as much information as is available in other serializations formats; particularly the metadata associated with the request

data_set

For Rates endpoint and Currencies endpoint, the data_set parameter determines which data set to query. It can take one of the following values depending on your plan:

  • OANDA – Rates obtained and aggregated by OANDA Corporation
  • EUCB – European Central Bank rates
  • AECB – The Central Bank of the United Arab Emirates
  • ALCB – Bank of Albania rates
  • AUCB – Reserve Bank of Australia rates
  • BGCB – Bulgarian National Bank rates
  • BRCB – Banco Central do Brasil rates
  • CACB – Bank of Canada rates
  • CNCB – People’s Bank of China
  • COCB – Central Bank of Colombia
  • CZCB – Czech National Bank rates
  • DKCB – Danmarks Nationalbank rates
  • GBCB – United Kingdom
  • GHCB – Bank of Ghana rates
  • GYCB – Bank Of Guyana rates
  • HKCB – Treasury Market Association, Hong Kong rates
  • HRCB – Croatian National Bank rates
  • HUCB – Hungarian National Bank rates
  • IDCB – Bank of Indonesia rates
  • INCB – Reserve Bank of India rates
  • ISCB – Central Bank of Iceland rates
  • MNCB – Central Bank of Mongolia
  • MXCB – Banco de Mexico rates
  • MYCB – Bank Negara Malaysia rates
  • NOCB – Norges Bank rates
  • PKCB – State Bank of Pakistan rates
  • PLCB – Narodowy Bank Polski rates
  • RSCB – National Bank of Serbia rates
  • VECB-DICOM – The Banco Central de Venezuela rates
  • VNCB – The State Bank of Vietnam rates
  • ZWCB – Reserve Bank of Zimbabwe rates

NOTE: Central Bank rates are available for our Advanced and Custom Plan. For more information, or to upgrade your subscription plan, please contact us at fxdata@oanda.com.

NOTE: All examples in the endpoint documentation omit authentication, though they do require it.