Get Merchant Currencies
curl -X GET "https://api.example.com/v1/api/v1/currencies/" \
-H "Content-Type: application/json" \
-H "X-Api-Key: YOUR_API_KEY"
import requests
import json
url = "https://api.example.com/v1/api/v1/currencies/"
headers = {
"Content-Type": "application/json",
"X-Api-Key": "YOUR_API_KEY"
}
response = requests.get(url, headers=headers)
print(response.json())
const response = await fetch("https://api.example.com/v1/api/v1/currencies/", {
method: "GET",
headers: {
"Content-Type": "application/json",
"X-Api-Key": "YOUR_API_KEY"
}
});
const data = await response.json();
console.log(data);
package main
import (
"fmt"
"net/http"
"bytes"
)
func main() {
req, err := http.NewRequest("GET", "https://api.example.com/v1/api/v1/currencies/", nil)
if err != nil {
panic(err)
}
req.Header.Set("Content-Type", "application/json")
req.Header.Set("X-Api-Key", "YOUR_API_KEY")
client := &http.Client{}
resp, err := client.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
fmt.Println("Response Status:", resp.Status)
}
require 'net/http'
require 'json'
uri = URI('https://api.example.com/v1/api/v1/currencies/')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
request = Net::HTTP::Get.new(uri)
request['Content-Type'] = 'application/json'
request['X-Api-Key'] = 'YOUR_API_KEY'
response = http.request(request)
puts response.body
{
"data": [
{
"currency": "UAH",
"decimal": 2,
"name": "Ukrainian Hryvnia",
"rate": "41.32",
"symbol": "₴"
},
{
"currency": "KZT",
"decimal": 2,
"name": "Kazakhstani Tenge",
"rate": "489.50",
"symbol": "₸"
}
],
"successful": true
}
{
"successful": false,
"request_id": "a1b2c3d4-...",
"error": {
"code": "API_KEY_MISSING",
"message": "Missing X-Api-Key header"
}
}
{
"successful": false,
"request_id": "a1b2c3d4-...",
"error": {
"code": "API_KEY_INVALID",
"message": "Invalid or inactive API key"
}
}
{
"successful": false,
"request_id": "a1b2c3d4-...",
"error": {
"code": "RATE_NOT_FOUND",
"message": "Rate not found"
}
}
{
"successful": false,
"request_id": "a1b2c3d4-...",
"error": {
"code": "RATE_INVALID",
"message": "Invalid rate"
}
}
{
"successful": false,
"request_id": "a1b2c3d4-...",
"error": {
"code": "RATES_UNAVAILABLE",
"message": "Exchange rates are temporarily unavailable"
}
}
/api/v1/currencies/
Request Preview
Response
Response will appear here after sending the request
Authentication
API Key for authentication. Merchant API Key.
Responses
Whether the request was successful
Currency code in upper-case
Number of decimal places
Currency symbol
Human-readable currency name
Current buy rate (USDT → fiat), rounded down to 2 decimals
Unique request ID for debugging
Machine-readable error code
Human-readable description
Extra context (varies by error)
Unique request ID for debugging
Machine-readable error code
Human-readable description
Extra context (varies by error)
Unique request ID for debugging
Machine-readable error code
Human-readable description
Extra context (varies by error)
Unique request ID for debugging
Machine-readable error code
Human-readable description
Extra context (varies by error)
Unique request ID for debugging
Machine-readable error code
Human-readable description
Extra context (varies by error)
Last updated Feb 26, 2026
Built with Documentation.AI