translate Englishattach_moneyUSDQuick AI Login
emoji_food_beverage Exploremaps Maps Listcurrency_exchange Live Currency Ratesfoggy Global Weather Forecastmonitor_heart Commodities Futures Marketapi API Docs

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

check_boxAllcheck_box_outline_blankCurrencycheck_box_outline_blankCryptocheck_box_outline_blankCommodity

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

JavaScript
Python
Php
Java
c#
Ruby
Go
Swift
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.util.HashMap;
import java.util.Map;
import com.fasterxml.jackson.databind.ObjectMapper;

public class ApiClient {
    private static final String BASE_URL = "https://exchangegrid.api.mapwale.com/v1";
    
    public static void main(String[] args) {
        try {
            String result = fetchData();
            System.out.println(result);
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
    
    private static String fetchData() throws Exception {
        // Create HTTP client
        HttpClient client = HttpClient.newHttpClient();
        ObjectMapper mapper = new ObjectMapper();
        
        // Build URL
        Map<String, String> params = new HashMap<>();
        params.put("region", "YOUR_REGION");  // Replace with actual region value
        
        StringBuilder urlBuilder = new StringBuilder(BASE_URL);
        ["region"].forEach(param -> 
            urlBuilder.append("/").append(params.get(param))
        );
        
        // Add query parameters
        Map<String, String> queryParams = {"show":"all","list":"USD,INR,JPY,BTC,DOGE"};
        urlBuilder.append("?");
        queryParams.forEach((key, value) -> 
            urlBuilder.append(key).append("=").append(value).append("&")
        );
        
        // Create request
        HttpRequest.Builder requestBuilder = HttpRequest.newBuilder()
            .uri(URI.create(urlBuilder.toString()))
            .header("Content-Type", "application/json")
            
        if ("GET".equals("POST") || "GET".equals("PUT")) {
            requestBuilder.method("GET", 
                HttpRequest.BodyPublishers.ofString(
                    mapper.writeValueAsString({})
                )
            );
        } else {
            requestBuilder.method("GET", HttpRequest.BodyPublishers.noBody());
        }
        
        // Send request
        HttpResponse<String> response = client.send(
            requestBuilder.build(),
            HttpResponse.BodyHandlers.ofString()
        );
        
        if (response.statusCode() >= 400) {
            throw new RuntimeException("HTTP error! status: " + response.statusCode());
        }
        
        return response.body();
    }
}

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

List parameter for Currency Rates

expand_more

List parameter for Crypto Rates

expand_more

List parameter for Commodity Rates

expand_more