CurrencyRateAPI
त्वरित लॉन्च टूल
क्या आप पूरे दस्तावेज़ को पढ़े बिना API का परीक्षण करना चाहते हैं? कंट्रोल पैनल पर जाएं, जहां आपको क्विक लॉन्च टूल मिलेगा - एक क्लिक में सभी उपलब्ध एंडपॉइंट्स को आज़माने का एक सरल तरीका।
नीचे दिए गए बटन पर क्लिक करके मुफ्त में पंजीकरण करें और क्विक लॉन्च टूल का उपयोग शुरू करें।
शुरू करना
करेंसी रेट एपीआई के साथ काम शुरू करने के लिए आपको जिन प्रमुख शब्दों और अवधारणाओं की आवश्यकता होगी:
| परिभाषा | विवरण |
|---|---|
| प्रतीक | तीन अक्षरों वाला मुद्रा कोड (जैसे, USD, EUR)। हम फिएट मुद्राओं के लिए ISO 4217 मानक कोड और क्रिप्टोकरेंसी के लिए विभिन्न कोड का समर्थन करते हैं। |
| आधार मुद्रा | वह मुद्रा जिससे रूपांतरण शुरू होता है। उदाहरण के लिए, यदि 1 USD = X EUR है, तो USD आधार मुद्रा है। डिफ़ॉल्ट आधार मुद्रा EUR है। |
| लक्ष्य मुद्रा | वह मुद्रा जिसमें आधार मुद्रा को परिवर्तित किया जाता है। उसी उदाहरण का उपयोग करते हुए, EUR लक्ष्य मुद्रा है। |
| क्रिप्टोकरेंसी | परंपरागत फिएट मुद्राओं के अलावा, हमारा एपीआई कई लोकप्रिय क्रिप्टोकरेंसी के लिए विनिमय दरों को संसाधित करता है और प्रदान करता है। |
| बेस यूआरएल | सभी API एंडपॉइंट्स के लिए उपयोग किया जाने वाला रूट URL। सभी अनुरोध इसी बेस पाथ पर भेजे जाते हैं। |
एपीआई प्रतिक्रिया
CurrencyRateAPI द्वारा प्रदान की गई विनिमय दरें डिफ़ॉल्ट रूप से यूरो में होती हैं। सभी डेटा मानक JSON प्रारूप में लौटाया जाता है और इसे किसी भी प्रोग्रामिंग भाषा का उपयोग करके आसानी से पार्स किया जा सकता है।
नमूना उत्तर:
नीचे आपको एक नमूना एपीआई प्रतिक्रिया मिलेगी जिसमें सामान्य विश्व मुद्राओं की एक श्रृंखला शामिल है, ये सभी मुद्राएं यूरो मुद्रा के सापेक्ष हैं और इनमें प्राप्त होने का समय भी दिया गया है।
{
"success": true,
"base": "eur",
"date": "2025-08-25",
"rates": {
"usd": "1.1697",
"gbp": "0.8659",
"cad": "1.6171"
},
"last_update_unix": "1769067006"
}
जैसा कि ऊपर दिखाया गया है, वास्तविक समय विनिमय दरों के लिए एपीआई प्रतिक्रिया में कई प्रमुख फ़ील्ड शामिल हैं:
- success यह दर्शाता है कि अनुरोध सफल रहा या नहीं।
- base यह अनुरोध के लिए उपयोग की जाने वाली आधार मुद्रा का 3-अक्षर का कोड लौटाता है।
- date यह विनिमय दरों की वास्तविक तिथि लौटाता है (प्रारूप YYYY-MM-DD)।
- rates इसमें अनुरोधित मुद्राओं की सूची और उनकी वर्तमान विनिमय दरें शामिल हैं।
- last_update_unix यह सिस्टम में उपलब्ध नवीनतम डेटा का टाइमस्टैम्प (यूनिक्स प्रारूप में) दिखाता है।
उपलब्ध एंडपॉइंट्स
CurrencyRateAPI में कई API एंडपॉइंट शामिल हैं, जिनमें से प्रत्येक विशिष्ट कार्यक्षमता प्रदान करता है। कुछ एंडपॉइंट की उपलब्धता आपकी सदस्यता योजना पर निर्भर करती है।
- मुद्राओं की सूची का अंतिम बिंदु। यह एंडपॉइंट सभी समर्थित मुद्राओं की पूरी सूची लौटाता है।
/api/codes(विकल्प:/api/currencies) - नवीनतम दरों का अंतिम बिंदु। यह एंडपॉइंट सभी समर्थित मुद्राओं के लिए वास्तविक समय विनिमय दर डेटा प्रदान करता है।
/api/latest - ऐतिहासिक दरों का अंतिम बिंदु। यह एंडपॉइंट एक विशिष्ट तिथि के लिए ऐतिहासिक विनिमय दर डेटा लौटाता है।
/api/YYYY-MM-DD(विकल्प:/api/history?date=YYYY-MM-DD). ऐतिहासिक आंकड़े 4 जनवरी, 1999 से उपलब्ध हैं।
विनिमय दर पद्धति
डेटा की सटीकता और एकरूपता सुनिश्चित करने के लिए, CurrencyRateAPI विनिमय दरों के प्रबंधन और वितरण के लिए एक सख्त कार्यप्रणाली का पालन करता है:
- मध्य-बाजार दरें: डिफ़ॉल्ट रूप से, एपीआई
midदरें लौटाता है। ये बाजार की खरीद (bid) और बिक्री (ask) कीमतों के बीच अंकगणितीय माध्य, या केंद्रीय बैंकों की आधिकारिक संदर्भ दरों का प्रतिनिधित्व करती हैं। - दिन के अंत में (ईओडी) अंतिम रूप देना: एपीआई द्वारा प्रदान की गई ऐतिहासिक दरें यूटीसी (समन्वित सार्वभौमिक समय) में दिन के अंत तक अंतिम रूप दी जाती हैं।
- क्रॉस-रेट गणना: जिन मुद्रा युग्मों की जानकारी हमारे स्रोतों से सीधे उपलब्ध नहीं है, उनके लिए सिस्टम स्वचालित रूप से प्रमुख वैश्विक मुद्राओं को एक सेतु (पिवट) के रूप में उपयोग करके अत्यधिक सटीक क्रॉस-रेट की गणना करता है।
- स्मार्ट फॉलबैक तंत्र: यदि अनुरोधित तिथि के लिए डेटा उपलब्ध नहीं है (उदाहरण के लिए, सप्ताहांत या छुट्टियों पर बाजार बंद होने के कारण), तो सिस्टम स्वचालित रूप से 8-दिन की अवधि के भीतर सबसे हाल ही में मान्य दर की खोज करता है।
- उच्चा परिशुद्धि: वित्तीय गणनाओं में राउंडिंग त्रुटियों को रोकने के लिए, विनिमय दरों को 18 दशमलव स्थानों तक संग्रहीत और संसाधित किया जाता है।
अंतिमबिंदुओं
समर्थित प्रतीक एंडपॉइंट
https://currencyrateapi.com/api/codes
यह एंडपॉइंट सभी समर्थित मुद्राओं की पूरी सूची लौटाता है। आप /api/currencies उपनाम का भी उपयोग कर सकते हैं।
सभी समर्थित मुद्राओं की एक आसानी से समझ में आने वाली सूची हमारे समर्थित मुद्राओं वाले पृष्ठ पर भी उपलब्ध है।
बुनियादी मुद्राएँ: डिफ़ॉल्ट रूप से, कुछ अन्य एंडपॉइंट (जैसे /latest और /{YYYY-MM-DD}) ट्रैफ़िक को कम करने के लिए प्रमुख वैश्विक मुद्राओं का एक सीमित सेट लौटाते हैं। ये "बुनियादी" मुद्राएँ हैं:
USD, EUR, GBP, CHF, JPY, CAD, AUD, NZD, SEK, NOK, DKK, ISK, PLN, CZK, HUF, RON, HRK, RSD,
MKD, MDL, TRY, SGD, HKD, KRW, TWD, ILS, AED, SAR, QAR, KWD, BHD, OMR, ZAR
एपीआई प्रतिक्रिया:
{
"success": true,
"currencies": {
"EUR": {
"entity": "EUROPEAN UNION",
"currency": "Euro",
"alphabetic_code": "EUR",
"numeric_code": 978,
"minor_unit": 2,
"title": "Euro",
"symbol": "€",
"data_from": "1999-01-04"
},
"BTC": {
"entity": "CRYPTOCURRENCY",
"currency": "Bitcoin",
"alphabetic_code": "BTC",
"title": "Bitcoin",
"symbol": "₿",
"is_crypto": true,
"data_from": "2024-03-02"
},
[...]
}
}
प्रतिक्रिया ऑब्जेक्ट:
| चाबी | विवरण |
|---|---|
| success | सफल अनुरोध के लिए true मान लौटाता है। यदि false मान लौटाता है, तो प्रतिक्रिया में एक त्रुटि ऑब्जेक्ट शामिल किया जाएगा। |
| currencies | यह प्रत्येक मुद्रा के बारे में विस्तृत जानकारी सहित सभी समर्थित मुद्राओं को लौटाता है। |
| entity | वह देश या क्षेत्र जहां मुद्रा का उपयोग किया जाता है, या डिजिटल परिसंपत्तियों के लिए "क्रिप्टोकरेंसी"। |
| currency | मुद्रा का पूरा आधिकारिक नाम। |
| alphabetic_code | मानक 3-अक्षर वाला वर्णमाला कोड (फिएट मुद्राओं के लिए ISO 4217)। |
| numeric_code | यदि लागू हो तो आईएसओ 4217 संख्यात्मक कोड। |
| minor_unit | मुद्रा में प्रयुक्त दशमलव स्थानों की संख्या। |
| withdrawal_date | यदि लागू हो, तो वह तिथि जब मुद्रा प्रचलन से वापस ली गई थी। |
| title | मुद्रा के लिए संक्षिप्त प्रदर्शन शीर्षक। |
| symbol | मुद्रा का चित्रात्मक चिह्न (जैसे, $, €, ₿)। |
| is_crypto | यदि मुद्रा क्रिप्टोकरेंसी है तो फ़्लैग ( true ) प्रदर्शित करें। |
| data_from | वह सबसे पहली तारीख जिसके लिए इस मुद्रा के विनिमय दर के आंकड़े उपलब्ध हैं। |
नवीनतम दरें एंडपॉइंट
https://currencyrateapi.com/api/latest?
base=USD&
quote=GBP,JPY,EUR
अनुरोध पैरामीटर:
| पैरामीटर | विवरण |
|---|---|
| base | [वैकल्पिक] रूपांतरण के लिए आधार मुद्रा निर्धारित करने हेतु तीन अक्षरों का आईएसओ मुद्रा कोड दर्ज करें। डिफ़ॉल्ट रूप से यह EUR है। |
| quote | [वैकल्पिक] विशिष्ट मुद्राओं तक ही प्रतिक्रिया सीमित करने के लिए मुद्रा कोडों की अल्पविराम से अलग की गई सूची दर्ज करें। (वैकल्पिक: codes) |
| extended_list | [वैकल्पिक] यदि इसे 1 पर सेट किया जाता है, तो API उपलब्ध मुद्राओं की पूरी सूची लौटाता है। डिफ़ॉल्ट रूप से, ट्रैफ़िक को कम करने के लिए केवल एक न्यूनतम सूची ही लौटाई जाती है। |
| precision | [वैकल्पिक] आउटपुट दरों में दशमलव स्थानों की संख्या (0-18) निर्धारित करता है। डिफ़ॉल्ट रूप से, वैज्ञानिक संकेतन के बिना पूर्ण उपलब्ध परिशुद्धता लौटाता है। |
एपीआई प्रतिक्रिया:
{
"success": true,
"base": "usd",
"date": "2026-01-22",
"rates": {
"gbp": "0.74350935478637",
"jpy": "158.00358051914",
"eur": "0.8518613169776"
},
"last_update_unix": "1769067006"
}
प्रतिक्रिया ऑब्जेक्ट:
| चाबी | विवरण |
|---|---|
| success | सफल अनुरोध के लिए true मान लौटाता है। यदि false मान लौटाता है, तो प्रतिक्रिया में एक त्रुटि ऑब्जेक्ट शामिल किया जाएगा। |
| base | यह आधार मुद्रा का 3-अक्षर वाला कोड लौटाता है। |
| date | यह उस वास्तविक तिथि को लौटाता है जिसके लिए विनिमय दरें प्रदान की गई हैं। |
| rates | अनुरोध में निर्दिष्ट मुद्राओं के लिए विनिमय दर डेटा लौटाता है। |
| last_update_unix | यह एक यूनिक्स टाइमस्टैम्प लौटाता है जो यह दर्शाता है कि लौटाए गए डेटा को अंतिम बार कब अपडेट किया गया था। |
ऐतिहासिक दरों का अंतिम बिंदु
https://currencyrateapi.com/api/2025-08-25?
base=EUR&
quote=USD,GBP,CAD
वैकल्पिक प्रारूप: /api/history?date=2025-08-25...
अनुरोध पैरामीटर:
| पैरामीटर | विवरण |
|---|---|
| date | [आवश्यक] वह ऐतिहासिक तिथि जिसके लिए विनिमय दरें मांगी जा रही हैं। प्रारूप: वर्ष-माह-दिन। इसे URL पथ (जैसे, /api/2025-08-25) में या क्वेरी पैरामीटर (जैसे, /api/history?date=2025-08-25) के रूप में प्रदान किया जा सकता है। |
| base | [वैकल्पिक] रूपांतरण के लिए आधार मुद्रा निर्धारित करने हेतु तीन अक्षरों का मुद्रा कोड दर्ज करें। डिफ़ॉल्ट रूप से EUR का उपयोग होता है। |
| quote | [वैकल्पिक] विशिष्ट मुद्राओं तक ही प्रतिक्रिया सीमित करने के लिए मुद्रा कोडों की अल्पविराम से अलग की गई सूची दर्ज करें। (वैकल्पिक: codes) |
| extended_list | [वैकल्पिक] यदि इसे 1 पर सेट किया जाता है, तो API उपलब्ध मुद्राओं की पूरी सूची लौटाता है। डिफ़ॉल्ट रूप से, ट्रैफ़िक को कम करने के लिए केवल एक न्यूनतम सूची ही लौटाई जाती है। |
| precision | [वैकल्पिक] आउटपुट दरों में दशमलव स्थानों की संख्या (0-18) निर्धारित करता है। डिफ़ॉल्ट रूप से, वैज्ञानिक संकेतन के बिना पूर्ण उपलब्ध परिशुद्धता लौटाता है। |
एपीआई प्रतिक्रिया:
{
"success": true,
"base": "eur",
"date": "2025-08-25",
"rates": {
"usd": "1.1697",
"gbp": "0.8659",
"cad": "1.6171"
},
"last_update_unix": "1769067006"
}
प्रतिक्रिया ऑब्जेक्ट:
| चाबी | विवरण |
|---|---|
| success | सफल अनुरोध के लिए true मान लौटाता है। यदि false मान लौटाता है, तो प्रतिक्रिया में एक त्रुटि ऑब्जेक्ट शामिल किया जाएगा। |
| base | यह आधार मुद्रा का 3-अक्षर वाला कोड लौटाता है। |
| date | यह उस वास्तविक तिथि को लौटाता है जिसके लिए विनिमय दरें प्रदान की गई हैं। |
| rates | यह अनुरोध में निर्दिष्ट तिथि पर मुद्राओं के लिए विनिमय दर डेटा लौटाता है। |
| last_update_unix | यह एक यूनिक्स टाइमस्टैम्प लौटाता है जो यह दर्शाता है कि लौटाए गए डेटा को अंतिम बार कब अपडेट किया गया था। |
नमूना कोड
पीएचपी (सीआरयूआरएल)
// Set API Endpoint (can be 'latest' or a date 'YYYY-MM-DD')
$endpoint = 'latest';
// Initialize CURL:
$ch = curl_init('https://currencyrateapi.com/api/'.$endpoint.'?base=USD"e=GBP,JPY');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
// Store the data:
$json = curl_exec($ch);
curl_close($ch);
// Decode JSON response:
$exchangeRates = json_decode($json, true);
// Access the exchange rate values, e.g. GBP:
echo $exchangeRates['rates']['GBP'];
जावास्क्रिप्ट (फ़ेच)
// Set endpoint (can be 'latest' or a date 'YYYY-MM-DD')
const endpoint = 'latest';
const params = '?base=USD"e=GBP,JPY';
// Get exchange rates via the selected endpoint:
fetch('https://currencyrateapi.com/api/' + endpoint + params)
.then(response => {
return response.json();
})
.then(json => {
// Exchange rate data is stored in json.rates
console.log(json.rates.GBP);
// Timestamp can be accessed in json.last_update_unix
console.log(json.last_update_unix);
})
.catch(error => {
console.error('Fetch error:', error);
});