API डॉक्यूमेंटेशन

रियल-टाइम मुद्रा विनिमय दरों को अपने एप्लिकेशन में इंटीग्रेट करने के लिए आपको जो कुछ भी चाहिए।

अवलोकन

AllRatesToday API एक सरल REST इंटरफ़ेस के माध्यम से रियल-टाइम और ऐतिहासिक मुद्रा विनिमय दरें प्रदान करता है। सभी प्रतिक्रियाएं JSON में होती हैं। बेस URL है:

https://allratestoday.com

हम एक मुफ्त सार्वजनिक एंडपॉइंट (कोई प्रमाणीकरण आवश्यक नहीं) और उच्च दर सीमाओं के साथ प्रमाणित एंडपॉइंट्स दोनों प्रदान करते हैं।

प्रमाणीकरण

सार्वजनिक एंडपॉइंट (/api/public/rates) को किसी प्रमाणीकरण की आवश्यकता नहीं है — बस इसे कॉल करें।

प्रमाणित एंडपॉइंट्स के लिए, अपनी API कुंजी को Bearer टोकन के रूप में शामिल करें:

Authorization: Bearer YOUR_API_KEY

साइन इन करने के बाद अपने प्रोफ़ाइल पेज से अपनी API कुंजी प्राप्त करें।

दर सीमाएं

दर सीमा हेडर सभी प्रतिक्रियाओं में दर सीमा हेडर शामिल होते हैं: X-RateLimit-Limit, X-RateLimit-Remaining, और X-RateLimit-Reset।

प्लान	सीमा	प्रमाणीकरण
सार्वजनिक (मुफ्त)	100 अनुरोध / प्रति घंटा प्रति IP	कोई नहीं
प्रमाणित (मुफ्त)	100 अनुरोध / प्रति मिनट प्रति कुंजी	Bearer टोकन

सार्वजनिक दरें

GET /api/public/rates

मुफ्त, सार्वजनिक एंडपॉइंट — कोई प्रमाणीकरण आवश्यक नहीं। AI चैटबॉट्स, त्वरित एकीकरण, और प्रोटोटाइपिंग के लिए आदर्श।

पैरामीटर	प्रकार	विवरण
fromआवश्यक	string	स्रोत मुद्रा कोड (जैसे USD, EUR)
toआवश्यक	string	लक्ष्य मुद्रा कोड (जैसे GBP, INR)
amountवैकल्पिक	number	रूपांतरित करने की राशि (डिफ़ॉल्ट: 1)

उदाहरण अनुरोध:

curl "https://allratestoday.com/api/public/rates?from=USD&to=EUR&amount=100"

उदाहरण प्रतिक्रिया:

{
  "success": true,
  "from": { "currency": "USD", "amount": 100 },
  "to": { "currency": "EUR", "amount": 92.15 },
  "rate": 0.9215,
  "inverse_rate": 1.0852,
  "timestamp": "2026-04-03T12:00:00Z",
  "source": "AllRatesToday.com",
  "type": "mid-market rate",
  "disclaimer": "This is the mid-market rate. Actual transfer rates may vary.",
  "rateLimit": { "remaining": 99, "limit": 100 }
}

CORS सक्षम यह एंडपॉइंट क्रॉस-ऑरिजिन अनुरोधों का समर्थन करता है — आप इसे सीधे ब्राउज़र से कॉल कर सकते हैं।

प्रमाणित दरें

GET /api/v1/rates

उच्च दर सीमाओं के साथ प्रमाणित एंडपॉइंट। Bearer टोकन आवश्यक है।

पैरामीटर	प्रकार	विवरण
sourceवैकल्पिक	string	स्रोत मुद्रा कोड (जैसे USD)
targetवैकल्पिक	string	लक्ष्य मुद्रा कोड (जैसे EUR)
timeवैकल्पिक	ISO 8601	किसी विशिष्ट समय पर दर
fromवैकल्पिक	YYYY-MM-DD	ऐतिहासिक श्रेणी के लिए प्रारंभ तिथि
toवैकल्पिक	YYYY-MM-DD	ऐतिहासिक श्रेणी के लिए समाप्ति तिथि
groupवैकल्पिक	string	इसके अनुसार समूहित करें: day, hour, minute

उदाहरण:

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

प्रतिक्रिया:

[
  {
    "rate": 0.9215,
    "source": "USD",
    "target": "EUR",
    "time": "2026-04-03T12:00:00Z"
  }
]

सरल दर

GET /api/rate

एकल जोड़ी दर प्राप्त करने के लिए हल्का एंडपॉइंट।

पैरामीटर	प्रकार	विवरण
sourceआवश्यक	string	स्रोत मुद्रा कोड
targetआवश्यक	string	लक्ष्य मुद्रा कोड

curl "https://allratestoday.com/api/rate?source=GBP&target=USD"

{ "rate": 1.2634, "source": "wise" }

ऐतिहासिक दरें

GET /api/historical-rates

चार्टिंग और विश्लेषण के लिए ऐतिहासिक विनिमय दर डेटा प्राप्त करें।

पैरामीटर	प्रकार	विवरण
sourceआवश्यक	string	स्रोत मुद्रा कोड
targetआवश्यक	string	लक्ष्य मुद्रा कोड
periodवैकल्पिक	string	1d, 7d, 30d, या 1y (डिफ़ॉल्ट: 7d)

curl "https://allratestoday.com/api/historical-rates?source=USD&target=EUR&period=30d"

{
  "source": "USD",
  "target": "EUR",
  "data": [
    { "date": "2026-03-04", "rate": 0.9198, "timestamp": 1741046400000 },
    { "date": "2026-03-05", "rate": 0.9210, "timestamp": 1741132800000 }
  ],
  "source_api": "wise",
  "period": "30d"
}

त्रुटि कोड

स्थिति	अर्थ
`400`	खराब अनुरोध — गायब या अमान्य पैरामीटर
`401`	अनधिकृत — गायब या अमान्य API कुंजी
`429`	दर सीमा पार — `Retry-After` हेडर जांचें
`500`	आंतरिक सर्वर त्रुटि
`503`	सेवा अस्थायी रूप से अनुपलब्ध

समर्थित मुद्राएं

160+ मुद्राएं जिनमें शामिल हैं:

प्रमुख मुद्राएं USD, EUR, GBP, JPY, CHF, CAD, AUD, NZD

लोकप्रिय मुद्राएं INR, CNY, BRL, MXN, RUB, TRY, ZAR, SGD, HKD, KRW, THB, PHP, PKR, BDT, LKR, NGN, GHS, KES, AED, SAR, EGP, और अधिक

पूरी सूची OpenAPI विनिर्देश के माध्यम से उपलब्ध है।

कोड उदाहरण

JavaScript / Node.js

const response = await fetch(
  'https://allratestoday.com/api/public/rates?from=USD&to=EUR'
);
const data = await response.json();
console.log(`1 USD = ${data.rate} EUR`);

Python

import requests

response = requests.get(
    'https://allratestoday.com/api/public/rates',
    params={'from': 'USD', 'to': 'EUR'}
)
data = response.json()
print(f"1 USD = {data['rate']} EUR")

PHP

$response = file_get_contents(
    'https://allratestoday.com/api/public/rates?from=USD&to=EUR'
);
$data = json_decode($response, true);
echo "1 USD = " . $data['rate'] . " EUR";

cURL

# Public endpoint (no auth)
curl "https://allratestoday.com/api/public/rates?from=USD&to=EUR&amount=500"

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

इंटीग्रेट करने के लिए तैयार?

अपनी मुफ्त API कुंजी प्राप्त करें और सेकंडों में अनुरोध करना शुरू करें।

मुफ्त API कुंजी प्राप्त करें