Commodities 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": {
"commodities": [
{
"symbol": "HEUSX",
"name": "Lean Hogs Futures",
"price": 88.6,
"changesPercentage": -0.02820874,
"change": -0.025,
"dayLow": 93.4,
"dayHigh": 94.8,
"yearHigh": 113.7,
"yearLow": 75.1,
"priceAvg50": 106.01,
"priceAvg200": 92.30113,
"volume": 29830,
"avgVolume": 11280,
"open": 88,
"previousClose": 93.9,
"timestamp": 1756317900
},
{
"symbol": "ZCUSX",
"name": "Corn Futures",
"price": 406,
"changesPercentage": 0,
"change": 0,
"dayLow": 405.25,
"dayHigh": 406.75,
"yearHigh": 504.5,
"yearLow": 363.75,
"priceAvg50": 400.89,
"priceAvg200": 443.11874,
"volume": 6977,
"avgVolume": 128955,
"open": 406,
"previousClose": 406,
"timestamp": 1756354080
},
{
"symbol": "ALIUSD",
"name": "Aluminum Futures",
"price": 2540.25,
"changesPercentage": -0.12778,
"change": -3.25,
"dayLow": 2526.75,
"dayHigh": 2547.25,
"yearHigh": 2694,
"yearLow": 2155,
"priceAvg50": 2493.9,
"priceAvg200": 2490.795,
"volume": 82,
"avgVolume": 3,
"open": 2579.5,
"previousClose": 2543.5,
"timestamp": 1756349750
}
]
}
}This endpoint provides the current exchange rates for the requested currencies.
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="commodities"|"stocks"|"index"). - list Comma-separated list of tickers codes
(e.g., list="GCUSD,ZCUSX,ALIUSD").
List parameter for Commodity Rates
