Currency

GET /currency
GET /currency?codes={currency_codes}
GET /currency/rate?symbols={target_currencies}&base={base_currency}&date={YYYYMMDD}
GET /currency/info

[
  {
    "code": "USD",
    "name": "US Dollar",
    "num": "840",
    "decimals": 2
  },
  {
    "code": "EUR",
    "name": "Euro",
    "num": "978",
    "decimals": 2
  }
]

curl -X GET "https://api.boxapi.com/currency" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

curl -X GET "https://api.boxapi.com/currency?codes=USD,EUR,GBP,JPY" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

{
  "success": true,
  "date": "2025-11-26",
  "base": "USD",
  "rates": {
    "EUR": 0.85,
    "GBP": 0.73,
    "JPY": 110.25
  },
  "credits_used": 3
}

curl -X GET "https://api.boxapi.com/currency/rate?symbols=EUR" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

curl -X GET "https://api.boxapi.com/currency/rate?symbols=EUR,GBP,JPY" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

curl -X GET "https://api.boxapi.com/currency/rate?date=20251101&base=EUR&symbols=USD" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

curl -X GET "https://api.boxapi.com/currency/rate?date=20251115&base=GBP&symbols=USD,EUR,JPY,CHF" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

// Get all currencies
const allCurrencies = await fetch('https://api.boxapi.com/currency', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  }
});

const currencies = await allCurrencies.json();
console.log(`Total currencies: ${currencies.length}`);

// Get specific currencies
const specificCurrencies = await fetch('https://api.boxapi.com/currency?codes=USD,EUR,GBP', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  }
});

const filteredCurrencies = await specificCurrencies.json();
filteredCurrencies.forEach(currency => {
  console.log(`${currency.code}: ${currency.name} (decimals: ${currency.decimals})`);
});

// Get exchange rates
const ratesResponse = await fetch('https://api.boxapi.com/currency/rate?symbols=EUR,GBP,JPY', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  }
});

const ratesData = await ratesResponse.json();
console.log(`Exchange rates for ${ratesData.date}:`);
console.log(`Base: ${ratesData.base}`);
Object.entries(ratesData.rates).forEach(([currency, rate]) => {
  console.log(`${currency}: ${rate}`);
});
console.log(`Credits used: ${ratesData.credits_used}`);

import requests

headers = {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
}

# Get all currencies
response = requests.get('https://api.boxapi.com/currency', headers=headers)
currencies = response.json()
print(f"Total currencies: {len(currencies)}")

# Get specific currencies
specific_response = requests.get(
    'https://api.boxapi.com/currency?codes=USD,EUR,GBP',
    headers=headers
)
filtered_currencies = specific_response.json()
for currency in filtered_currencies:
    print(f"{currency['code']}: {currency['name']} (decimals: {currency['decimals']})")

# Get exchange rates
rates_response = requests.get(
    'https://api.boxapi.com/currency/rate?symbols=EUR,GBP,JPY',
    headers=headers
)
rates_data = rates_response.json()
print(f"Exchange rates for {rates_data['date']}:")
print(f"Base: {rates_data['base']}")
for currency, rate in rates_data['rates'].items():
    print(f"{currency}: {rate}")
print(f"Credits used: {rates_data['credits_used']}")

# Get historical rates
historical_response = requests.get(
    'https://api.boxapi.com/currency/rate?date=20251101&base=EUR&symbols=USD,GBP',
    headers=headers
)
historical_data = historical_response.json()
print(f"\nHistorical rates for {historical_data['date']}:")
print(f"Base: {historical_data['base']}")
for currency, rate in historical_data['rates'].items():
    print(f"{currency}: {rate}")

<?php
$apiKey = 'YOUR_API_KEY';

// Get all currencies
$ch = curl_init('https://api.boxapi.com/currency');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer ' . $apiKey,
    'Content-Type: application/json'
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
$currencies = json_decode($response, true);

echo "Total currencies: " . count($currencies) . "\n";

// Get specific currencies
$ch = curl_init('https://api.boxapi.com/currency?codes=USD,EUR,GBP');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer ' . $apiKey,
    'Content-Type: application/json'
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
$filteredCurrencies = json_decode($response, true);

foreach ($filteredCurrencies as $currency) {
    echo "{$currency['code']}: {$currency['name']} (decimals: {$currency['decimals']})\n";
}

// Get exchange rates
$ch = curl_init('https://api.boxapi.com/currency/rate?symbols=EUR,GBP,JPY');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer ' . $apiKey,
    'Content-Type: application/json'
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
$ratesData = json_decode($response, true);

echo "\nExchange rates for {$ratesData['date']}:\n";
echo "Base: {$ratesData['base']}\n";
foreach ($ratesData['rates'] as $currency => $rate) {
    echo "{$currency}: {$rate}\n";
}
echo "Credits used: {$ratesData['credits_used']}\n";
?>

{
  "error": "Missing required parameter: symbols",
  "statusCode": 400
}

{
  "error": "Invalid date format. Use YYYYMMDD",
  "statusCode": 400
}

{
  "error": "Unauthorized"
}

{
  "error": "Internal server error"
}

{
  "description": "This API provides access to international currency information and exchange rates based on ISO 4217 standard.",
  "endpoints": {
    "list": {
      "path": "/currency",
      "description": "Get list of all available currencies or filter by currency codes",
      "params": {
        "codes": {
          "type": "string",
          "description": "Comma-separated list of currency codes to filter (optional)",
          "example": "USD,EUR,GBP",
          "required": false
        }
      },
      "pricing": {
        "description": "1 credit per request",
        "credits": 1
      }
    },
    "rates": {
      "path": "/currency/rate",
      "description": "Get exchange rates for specified currency pairs",
      "params": {
        "date": {
          "type": "string",
          "format": "YYYYMMDD",
          "description": "Date for exchange rates (8 digits, no separators)",
          "example": "20251126",
          "default": "today's date",
          "required": false
        },
        "base": {
          "type": "string",
          "description": "Base currency code (ISO 4217 alpha-3)",
          "example": "USD",
          "default": "USD",
          "required": false
        },
        "symbols": {
          "type": "string",
          "description": "Comma-separated list of target currency codes (ISO 4217 alpha-3)",
          "example": "EUR,GBP,JPY",
          "required": true
        }
      },
      "pricing": {
        "description": "1 credit per currency pair",
        "example": "USD to EUR,GBP,JPY = 3 credits (3 pairs)"
      }
    }
  },
  "currencyFormat": {
    "description": "All currency codes follow ISO 4217 standard",
    "codeFormat": "3-letter alphabetic code (e.g., USD, EUR, GBP)",
    "numericFormat": "3-digit numeric code (e.g., 840, 978, 826)"
  },
  "commonCurrencies": [
    { "code": "USD", "name": "US Dollar", "num": "840" },
    { "code": "EUR", "name": "Euro", "num": "978" },
    { "code": "GBP", "name": "British Pound", "num": "826" },
    { "code": "JPY", "name": "Japanese Yen", "num": "392" }
  ]
}