allratestoday / sdk

v1.3.1 2026-04-09 20:01 UTC

Requires

• php: >=7.4
• ext-curl: *
• ext-json: *

MIT

• AllRatesToday

• api
• currency
• forex
• exchange-rate
• Reuters
• allratestoday

Published on Packagist.org on 2026-04-09 20:01 UTC

README

AllRatesToday is a free, fast, and reliable REST API for real-time and historical currency exchange rates. Sourced from institutional interbank market data.

• Website: allratestoday.com
• Free API key: allratestoday.com/register
• Docs: allratestoday.com/docs
• Overview: Exchange Rate API · Currency API

🚀 Features

• ⚡ Real-time rates — Live mid-market exchange rates updated on every request
• 🌍 160+ currencies — Major, emerging market, and popular currencies
• 📅 Historical data — Access historical rates with flexible date ranges (1d/7d/30d/1y)
• 📦 Official SDKs — JavaScript/TypeScript, Python, PHP, and React
• 🆓 Free tier — Get started at no cost
• 🛡️ Fast & reliable — Powered by Cloudflare's global edge network
• 📡 Data source — institutional interbank market data

📦 Official SDKs

JavaScript / TypeScript

npm install @allratestoday/sdk

import AllRatesToday from '@allratestoday/sdk';

const client = new AllRatesToday();
const rate = await client.getRate('USD', 'EUR');
console.log(`1 USD = ${rate.rate} EUR`);

// Convert amount
const result = await client.convert('USD', 'EUR', 100);
console.log(`$100 = €${result.result}`);

// With API key for higher limits & historical data
const auth = new AllRatesToday({ apiKey: 'art_live_...' });
const history = await auth.getHistoricalRates('USD', 'EUR', '30d');

Python

pip install allratestoday

from allratestoday import AllRatesToday

client = AllRatesToday()
rate = client.get_rate("USD", "EUR")
print(f"1 USD = {rate['rate']} EUR")

# Convert amount
result = client.convert("USD", "EUR", 100)
print(f"$100 = €{result['result']}")

# With API key for higher limits & historical data
auth = AllRatesToday(api_key="art_live_...")
history = auth.get_historical_rates("USD", "EUR", "30d")

PHP

composer require allratestoday/sdk

use AllRatesToday\AllRatesToday;

$client = new AllRatesToday();
$rate = $client->getRate('USD', 'EUR');
echo "1 USD = {$rate['rate']} EUR";

// Convert amount
$result = $client->convert('USD', 'EUR', 100);
echo "$100 = €{$result['result']}";

// With API key for higher limits & historical data
$auth = new AllRatesToday('art_live_...');
$history = $auth->getHistoricalRates('USD', 'EUR', '30d');

React

npm install react-currency-localizer-realtime

import { LocalizedPrice } from 'react-currency-localizer-realtime';

// Automatically detects the visitor's currency. No API key needed:
// keyless mode uses free daily ECB rates (~30 currencies) and renders a
// "Rates by AllRatesToday" link. Pass apiKey for real-time + 160 currencies.
function PricingCard() {
  return (
    <div>
      <h3>Pro Plan</h3>
      <LocalizedPrice basePrice={19.99} baseCurrency="USD" />
    </div>
  );
}

import { useCurrencyConverter } from 'react-currency-localizer-realtime';

// Hook-based API for full control
function ProductPrice({ price }: { price: number }) {
  const { convertedPrice, localCurrency, isLoading } = useCurrencyConverter({
    basePrice: price,
    baseCurrency: 'USD',
    apiKey: 'art_live_...',
  });

  if (isLoading) return <span>Loading...</span>;

  return (
    <span>
      {new Intl.NumberFormat(undefined, {
        style: 'currency',
        currency: localCurrency || 'USD',
      }).format(convertedPrice || price)}
    </span>
  );
}

import { useCurrencyLocalizer } from 'react-currency-localizer-realtime';

// Batch conversion for product lists
function ProductList({ products }) {
  const { convertAndFormat, isReady } = useCurrencyLocalizer({
    baseCurrency: 'USD',
    apiKey: 'art_live_...',
  });

  return (
    <ul>
      {products.map(p => (
        <li key={p.id}>{p.name}: {isReady ? convertAndFormat(p.price) : '...'}</li>
      ))}
    </ul>
  );
}

🏁 Quick Start (No SDK)

curl "https://allratestoday.com/api/v1/rates?source=USD&target=EUR" \
  -H "Authorization: Bearer YOUR_API_KEY"

Get your free API key at allratestoday.com/register.

📚 API Endpoints

Method	Endpoint	Auth	Description
GET	/api/v1/rates	Yes	Exchange rates (supports comma-separated targets)
GET	/api/v1/symbols	No	List all supported currencies
GET	/api/rate	Yes	Simple pair rate lookup
GET	/api/historical-rates	Yes	Historical rate data & time series

🌍 Supported Currencies

160+ currencies including:

Major: USD, EUR, GBP, JPY, CHF, CAD, AUD, NZD

Popular: INR, CNY, BRL, MXN, TRY, ZAR, SGD, HKD, KRW, THB, PHP, PKR, BDT, LKR, NGN, GHS, KES, AED, SAR, EGP, and more

🛡️ Error Handling

Code	Description
400	Bad request — missing or invalid parameters
401	Missing or invalid API key
429	Rate limit or monthly quota exceeded
500	Internal server error
503	Service temporarily unavailable

📄 API Specifications

For the complete technical reference, download the AllRatesToday Currency Data API Specifications document:

• Download PDF — Full 20-page API specification (endpoints, parameters, responses, error codes, SDKs)
• View Online — Browse the specification on our website

🔗 Links

• Website: allratestoday.com
• API Specs: allratestoday.com/api-specifications
• Exchange Rate API overview: allratestoday.com/exchange-rate-api
• API Docs: allratestoday.com/docs
• Developer Guide: allratestoday.com/developers
• Status: allratestoday.com/status
• Support: allratestoday.com/contact

📜 License

This project is licensed under the MIT License - see the LICENSE file for details.