Real Exchange Rates
powered by

Our REST API provides easy, seamless integration of accurate, real-time exchange rates directly into your applications, delivering transparent data that reflects the true free-market value of currencies.

API Status

If you have questions or special requests send us a message

Maximum requests per minute: 100

https://api.yadio.io

200: OK
400: invalid request
429: too many requests
500: generic internal server error

Unix time in milliseconds

All API responses are returned in JSON format, either as a JSON object or a JSON array, depending on the endpoint.

Endpoints

Retrieve current foreign exchange rates with an optional base currency.

GET https://api.yadio.io/exrates/{currency}

Permissions: public
Content-Type: application/json
CORS: enabled

URL Parameters:
• currency (string) optional
The ISO 4217 currency code to use as the base currency for all exchange rate calculations.
If not specified, the default base currency is USD.

# get exchange rates base: USD
curl --request GET --url  "https://api.yadio.io/exrates/USD" --header "accept: application/json"

/* get exchange rates base: USD */

const axios = require('axios')
var url = 'https://api.yadio.io/exrates/USD'
axios
  .get(url)
  .then(res => {
    console.log(res.data)
  })

# get exchange rates base: USD

import requests 
url = 'https://api.yadio.io/exrates/USD'
response = requests.get(url)
print(response.json())

Converts a specified amount from one currency to another using current exchange rates.

GET https://api.yadio.io/convert/{amount}/{source}/{target}

Permissions: public
Content-Type: application/json
CORS: enabled

URL Parameters:
• amount (number) required
The numeric amount to convert.
• source (string) required
The ISO 4217 currency code of the source currency.
• target (string) required
The ISO 4217 currency code of the target currency.

# convert 100 USD to ARS
curl --request GET --url  "https://api.yadio.io/convert/100/USD/ARS" --header "accept: application/json"

/* convert 100 USD to ARS */

const axios = require('axios')
var url = 'https://api.yadio.io/convert/100/USD/ARS'
axios
  .get(url)
  .then(res => {
    console.log(res.data)
  })

# convert 100 USD to ARS

import requests 
url = 'https://api.yadio.io/convert/100/USD/ARS'
response = requests.get(url)
print(response.json())

Returns the current exchange rate for a specific currency pair.

GET https://api.yadio.io/rate/{quote}/{base}

Permissions: public
Content-Type: application/json
CORS: enabled

URL Parameters:
• quote (string) required
The ISO 4217 currency code of the quote currency.
• base (string) required
The ISO 4217 currency code of the base currency.

# get exchange rate ARS/USD
curl --request GET --url  "https://api.yadio.io/rate/ARS/USD" --header "accept: application/json"

/* get exchange rate ARS/USD */

const axios = require('axios')
var url = 'https://api.yadio.io/rate/ARS/USD'
axios
  .get(url)
  .then(res => {
    console.log(res.data)
  })

# get exchange rate ARS/USD

import requests 
url = 'https://api.yadio.io/rate/ARS/USD'
response = requests.get(url)
print(response.json())

Lists available currencies

GET https://api.yadio.io/currencies

Permissions: public
Content-Type: application/json
CORS: enabled

# get available currencies
curl --request GET --url  "https://api.yadio.io/currencies" --header "accept: application/json"

/* get available currencies */

const axios = require('axios')
var url = 'https://api.yadio.io/currencies'
axios
  .get(url)
  .then(res => {
    console.log(res.data)
  })

# get available currencies

import requests 
url = 'https://api.yadio.io/currencies'
response = requests.get(url)
print(response.json())

Lists active exchanges

GET https://api.yadio.io/exchanges

Permissions: public
Content-Type: application/json
CORS: enabled

# get active exchanges
curl --request GET --url  "https://api.yadio.io/exchanges" --header "accept: application/json"

/* get active exchanges */

const axios = require('axios')
var url = 'https://api.yadio.io/exchanges'
axios
  .get(url)
  .then(res => {
    console.log(res.data)
  })

# get active exchanges

import requests 
url = 'https://api.yadio.io/exchanges'
response = requests.get(url)
print(response.json())

Returns rate information for specified currency and period of hours

GET https://api.yadio.io/today/{range}/{currency}

Permissions: public
Content-Type: application/json
CORS: enabled

URL Parameters:
• range (number) required
Time range in hours from 1 to 24.
• currency (string) required
The ISO 4217 currency code of the currency.

# get ARS rate and volume info for last hour
curl --request GET --url  "https://api.yadio.io/today/1/ARS" --header "accept: application/json"

/* get ARS rate and volume info for last hour */

const axios = require('axios')
var url = 'https://api.yadio.io/today/1/ARS'
axios
  .get(url)
  .then(res => {
    console.log(res.data)
  })

# get ARS rate and volume info for last hour

import requests 
url = 'https://api.yadio.io/today/1/ARS'
response = requests.get(url)
print(response.json())

Returns historical rate information

GET https://api.yadio.io/hist/{range}/{currency}

Permissions: public
Content-Type: application/json
CORS: enabled

URL Parameters:
• range (number) required
Time range in days from 1 to 365.
• currency (string) required
The ISO 4217 currency code of the currency.

# get ARS rate and volume info for last 2 days
curl --request GET --url  "https://api.yadio.io/hist/2/ARS" --header "accept: application/json"

/* get ARS rate and volume info for last 2 days */

const axios = require('axios')
var url = 'https://api.yadio.io/hist/2/ARS'
axios
  .get(url)
  .then(res => {
    console.log(res.data)
  })

# get ARS rate and volume info for last 2 days

import requests 
url = 'https://api.yadio.io/hist/2/ARS'
response = requests.get(url)
print(response.json())

Returns comparison information for specified currency and period of days

GET https://api.yadio.io/compare/{range}/{currency}

Permissions: public
Content-Type: application/json
CORS: enabled

URL Parameters:
• range (number) required
Time range in days from 1 to 365.
• currency (string) required
The ISO 4217 currency code of the currency.

# get ARS comparison info for last 2 days
curl --request GET --url  "https://api.yadio.io/compare/2/ARS" --header "accept: application/json"

/* get ARS comparison info for last 2 days */

const axios = require('axios')
var url = 'https://api.yadio.io/compare/2/ARS'
axios
  .get(url)
  .then(res => {
    console.log(res.data)
  })

# get ARS comparison info for last 2 days

import requests 
url = 'https://api.yadio.io/compare/2/ARS'
response = requests.get(url)
print(response.json())

Returns P2P market ads

GET https://api.yadio.io/market/ads

Permissions: public
Content-Type: application/json
CORS: enabled

URL Parameters:
• currency (string) required
The ISO 4217 currency code of the currency.
• side (string) required
Trade side: buy or sell
• limit (number) optional
Number of ads to return (default=20)

# get ads currency=ARS side=buy limit=5
curl --request GET --url  "https://api.yadio.io/market/ads?currency=ARS&side=buy&limit=5" --header "accept: application/json"

/* get ads currency=ARS side=buy limit=5 */

const axios = require('axios')
var url = 'https://api.yadio.io/market/ads?currency=ARS&side=buy&limit=5'
axios
  .get(url)
  .then(res => {
    console.log(res.data)
  })

# get ads currency=ARS side=buy limit=5

import requests 
url = 'https://api.yadio.io/market/ads?currency=ARS&side=buy&limit=5'
response = requests.get(url)
print(response.json())

Returns P2P market statistics

GET https://api.yadio.io/market/stats

Permissions: public
Content-Type: application/json
CORS: enabled

URL Parameters:
• currency (string) required
The ISO 4217 currency code of the currency.
• side (string) required
Trade side: buy or sell

# get market stats currency=ARS side=buy
curl --request GET --url  "https://api.yadio.io/market/stats?currency=ARS&side=buy" --header "accept: application/json"

/* get market stats currency=ARS side=buy */

const axios = require('axios')
var url = 'https://api.yadio.io/market/stats?currency=ARS&side=buy'
axios
  .get(url)
  .then(res => {
    console.log(res.data)
  })

# get market stats currency=ARS side=buy

import requests 
url = 'https://api.yadio.io/market/stats?currency=ARS&side=buy'
response = requests.get(url)
print(response.json())

Checks server status

GET https://api.yadio.io/ping

Permissions: public
Content-Type: application/json
CORS: enabled

# get server status
curl --request GET --url  "https://api.yadio.io/ping" --header "accept: application/json"

/* get server status */

const axios = require('axios')
var url = 'https://api.yadio.io/ping'
axios
  .get(url)
  .then(res => {
    console.log(res.data)
  })

# get server status

import requests 
url = 'https://api.yadio.io/ping'
response = requests.get(url)
print(response.json())