API

Your source for free-market exchange rates


Our REST API allows you to seamlessly integrate accurate exchange rate data into your applications.

API Status

If you have questions or special requests send us a message

Rate Limits

Maximum requests per minute: 100

Base Endpoint

https://api.yadio.io

Status Codes

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

Timestamp Format

Unix time in milliseconds


Endpoints
/exrates/{currency}

Returns exchange rates

Base Endpoint: https://api.yadio.io
Method: GET
Permissions: public
Response: application/json
CORS: enabled
currency: 3-letter currency code (optional. default=USD)

# get exchange rates base: USD
curl -X GET "https://api.yadio.io/exrates/USD"
/* 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())
/convert/{amount}/{from}/{to}

Converts amount from one currency to another

Base Endpoint: https://api.yadio.io
Method: GET
Permissions: public
Response: application/json
CORS: enabled
amount: amount to be converted (required)
from: 3-letter currency code (required)
to: 3-letter currency code (required)

# convert 100 USD to ARS
curl -X GET "https://api.yadio.io/convert/100/USD/ARS"
/* 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())
/rate/{currency0}/{currency1}

Returns exchange rate for specified currency pair

Base Endpoint: https://api.yadio.io
Method: GET
Permissions: public
Response: application/json
CORS: enabled
currency0: 3-letter currency code
currency1: 3-letter currency code

# get exchange rate ARS/USD
curl -X GET "https://api.yadio.io/rate/ARS/USD"
/* 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())
/currencies

Lists available currencies

Base Endpoint: https://api.yadio.io
Method: GET
Permissions: public
Response: application/json
CORS: enabled

# get available currencies
curl -X GET "https://api.yadio.io/currencies"
/* 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())
/exchanges

Lists active exchanges

Base Endpoint: https://api.yadio.io
Method: GET
Permissions: public
Response: application/json
CORS: enabled

# get active exchanges
curl -X GET "https://api.yadio.io/exchanges"
/* 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())
/today/{range}/{currency}

Returns rate information for specified currency and period of hours

Base Endpoint: https://api.yadio.io
Method: GET
Permissions: public
Response: application/json
CORS: enabled
range: number of hours to include from 1 to 24 (required)
currency: 3-letter currency code

# get ARS rate and volume info for last hour
curl -X GET "https://api.yadio.io/today/1/ARS"
/* 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())
/hist/{range}/{currency}

Returns historical rate information

Base Endpoint: https://api.yadio.io
Method: GET
Permissions: public
Response: application/json
CORS: enabled
range: number of days to include from 1 to 365 (required)
currency: 3-letter currency code

# get ARS rate and volume info for last 2 days
curl -X GET "https://api.yadio.io/hist/2/ARS"
/* 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())
/compare/{range}/{currency}

Returns comparison information for specified currency and period of days

Base Endpoint: https://api.yadio.io
Method: GET
Permissions: public
Response: application/json
CORS: enabled
range: number of days to include from 1 to 365 (required)
currency: 3-letter currency code

# get ARS comparison info for last 2 days
curl -X GET "https://api.yadio.io/compare/2/ARS"
/* 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())
/market/ads

Returns P2P market ads

Base Endpoint: https://api.yadio.io
Method: GET
Permissions: public
Response: application/json
CORS: enabled
Query Parameters: currency, side, limit
currency: 3-letter currency code (required)
side: buy or sell (required)
limit: max number of ads (optional. default=20)

# get ads currency=ARS side=buy limit=5
curl -X GET "https://api.yadio.io/market/ads?currency=ARS&side=buy&limit=5"
/* 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())
/market/stats

Returns P2P market statistics

Base Endpoint: https://api.yadio.io
Method: GET
Permissions: public
Response: application/json
CORS: enabled
Query Parameters: currency, side
currency: 3-letter currency code (required)
side: buy or sell (required)

# get market stats currency=ARS side=buy
curl -X GET "https://api.yadio.io/market/stats?currency=ARS&side=buy"
/* 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())
/ping

Checks server status

Base Endpoint: https://api.yadio.io
Method: GET
Permissions: public
Response: application/json
CORS: enabled

# get server status
curl -X GET "https://api.yadio.io/ping"
/* 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())