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.
Authorization:
- privateId *Specify privateId for site
(e.g., "Bearer example^com-SomeIdString").
Query Parameters:
- show Specify which rates to show
(e.g., "all"|"rates"|"crypto"). - list Comma-separated list of currency codes
(e.g., "USD,INR,BTC").
Route Parameters:
- :region *Please check location table here
(e.g., "WEST_3|ARAB_1|EAST_3|NORD_6").
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 } } }
This endpoint provides the current exchange rates for the requested currencies.
import Foundation struct APIClient { static let baseURL = "https://exchangegrid.api.mapwale.com/v1" static let privateId = "<privateId>" static func fetchData() async throws -> [String: Any] { // API configuration let params = [ "region": "YOUR_REGION" // Replace with actual region value ] // Build URL var urlComponents = URLComponents(string: baseURL)! // Add path parameters let pathParams = ["region"] let pathItems = pathParams.map { params[$0]! } urlComponents.path += "/" + pathItems.joined(separator: "/") // Add query parameters let queryParams: [String: String] = {"show":"all","list":"USD,INR,JPY,BTC,DOGE"} urlComponents.queryItems = queryParams.map { URLQueryItem(name: $0.key, value: $0.value) } guard let url = urlComponents.url else { throw URLError(.badURL) } // Create request var request = URLRequest(url: url) request.httpMethod = "GET" request.setValue("application/json", forHTTPHeaderField: "Content-Type") request.setValue("Bearer \(privateId)", forHTTPHeaderField: "Authorization") // Add body for POST/PUT requests if ["POST", "PUT"].contains("GET") { let bodyData = {} request.httpBody = try JSONSerialization.data(withJSONObject: bodyData) } // Send request let (data, response) = try await URLSession.shared.data(for: request) guard let httpResponse = response as? HTTPURLResponse else { throw URLError(.badServerResponse) } guard httpResponse.statusCode < 400 else { throw URLError(.badServerResponse) } guard let result = try JSONSerialization.jsonObject(with: data) as? [String: Any] else { throw URLError(.cannotParseResponse) } return result } } // Example usage @main struct APIExample { static func main() async { do { let result = try await APIClient.fetchData() let prettyJSON = try JSONSerialization.data(withJSONObject: result, options: .prettyPrinted) if let jsonString = String(data: prettyJSON, encoding: .utf8) { print(jsonString) } } catch { print("Error: \(error)") } } }