Mapwale Developers - Exchange Rates API

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

All Currency Crypto Commodity

This endpoint provides the current exchange rates for the requested currencies.

const params = {
  region: 'YOUR_REGION'  // Replace with actual region value
};


async function fetchData() {
  try {
    let url = 'https://exchangegrid.api.mapwale.com/v1/:region';
    Object.entries(params).forEach(([key, value]) => {
      url = url.replace(`:${key}`, value);
    });
    
    url += '?show=all&list=USD,INR,JPY,BTC,DOGE';

    const response = await fetch(url);
    
    if (!response.ok) {
      throw new Error('HTTP error! status: ' + response.status);
    }
    
    return await response.json();
  } catch (error) {
    console.error('Fetch error:', error);
    return null;
  }
}

// Example usage:
fetchData().then(console.log);

Query 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").