Exchange Rates API Documentation
Access real-time exchange rates for currencies & crypto. This API provides accurate, up-to-date rates for integrating into your financial applications.
Below are the endpoints for accessing exchange rates. Learn how to integrate the API into your application.
Route Parameters:
- :region *Please check location table here
(e.g., "SOUTH|ARAB|EAST|NORD").
Response based on params:
{
"success": true,
"data": {
"rates": {
"USD": 1,
"INR": 83.540592,
"JPY": 143.662125,
"BTC": 0.000015737383
},
"crypto": {
"BTC": 63478.467340116214,
"DOGE": 0.012578131058644222
},
"commodity": {
"HEUSX": 91.275,
"ZCUSX": 415.5,
"ALIUSD": 2540.75,
"ZOUSX": 326.5,
"PLUSD": 1363.2,
"ZMUSD": 292.9,
"GCUSD": 3412.1,
"ZLUSX": 54.88,
"KEUSX": 522.5,
"SILUSD": 38.905,
"HGUSD": 4.4815,
"MGCUSD": 3412.1,
"SBUSX": 16.44,
"SIUSD": 38.905,
"CTUSX": 67.73,
"ZSUSX": 1056.5,
"LBUSD": 659,
"LEUSX": 240.1,
"NGUSD": 2.765,
"CLUSD": 63.68,
"OJUSX": 243.3,
"KCUSX": 378,
"PAUSD": 1134.5,
"GFUSX": 362.325,
"ZRUSD": 11.865,
"CCUSD": 7781,
"BZUSD": 67.74,
"DCUSD": 18.22,
"RBUSD": 1.9866,
"HOUSD": 2.3068
}
}
}GET
This endpoint provides the current exchange rates for the requested currencies.
require 'net/http'
require 'uri'
require 'json'
def fetch_data
# API configuration
base_url = 'https://exchangegrid.api.mapwale.com/v1'
params = {
'region' => 'YOUR_REGION' # Replace with actual region value
}
headers = {
'Content-Type' => 'application/json',
}
query_params = {"show":"all","list":"USD,INR,JPY,BTC,DOGE"}
begin
# Build URL
url = base_url
["region"].each do |param|
url += "/#{URI.encode_www_form_component(params[param])}"
end
# Add query parameters
uri = URI(url)
uri.query = URI.encode_www_form(query_params)
# Create HTTP client
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == 'https'
# Create request
request = case 'GET'
when 'POST'
Net::HTTP::Post.new(uri)
when 'PUT'
Net::HTTP::Put.new(uri)
when 'DELETE'
Net::HTTP::Delete.new(uri)
else
Net::HTTP::Get.new(uri)
end
# Set body for POST/PUT requests
if ['POST', 'PUT'].include?('GET')
request.body = {}.to_json
end
# Send request
response = http.request(request)
# Check for errors
unless response.is_a?(Net::HTTPSuccess)
raise "HTTP error! status: #{response.code}"
end
JSON.parse(response.body)
rescue StandardError => e
puts "Error: #{e.message}"
nil
end
end
# Example usage
result = fetch_data
puts JSON.pretty_generate(result) if resultQuery Parameters:
- authorization *Specify authorization for site
(e.g., authorization="<API-KEY>"). - show Specify which rates to show
(e.g., show="all"|"currency"|"crypto"|"commodity"). - list Comma-separated list of currency codes
(e.g., list="USD,INR,BTC").
List parameter for Currency Rates
List parameter for Crypto Rates
List parameter for Commodity Rates
