FXMacroData GraphQL API अब चालू है. मौजूदा REST एंडपॉइंट के साथ, प्रत्येक कोर डेटा सतह संकेतक समय श्रृंखला, डेटा कैटलॉग क्वेरी, और रिलीज कैलेंडर लुकअप अब एक एकल, टाइप किए गए GraphSQL स्कीमा के माध्यम से उपलब्ध है. एक रेंड-ट्रिप में आपको आवश्यक फ़ील्ड ठीक से प्राप्त करें, एक एकल अनुरोध शरीर में बहु-मुद्रा क्वेरियों को लिखें, और अंतर्निहित GraphiQL IDE के माध्यम سے इंटरैक्टिव रूप से पूरी स्कीम का अन्वेषण करें.
क्या नया है
GraphQL अंत बिंदु पर माउंट किया गया है POST /api/v1/graphql और तीन रूट क्वेरी फ़ील्ड को उजागर करता है जो उत्पादन REST सतह को दर्शाता हैः
announcements
किसी भी समर्थित मुद्रा और सूचक स्लग के लिए ऐतिहासिक मैक्रोइकॉनॉमिक सूचक डेटा प्राप्त करें। वही लौटाता है date, val, और
announcement_datetime REST अंत बिंदु के रूप में फ़ील्ड, प्लस वैकल्पिक
pct_change और pct_change_12m खेतों।
dataCatalogue
किसी मुद्रा के लिए उपलब्ध सभी संकेतकों की सूची, जिसमें संकेतकों का स्लग, मानव-पठनीय नाम, इकाई, अद्यतन आवृत्ति और क्या केंद्रीय बैंक का आधिकारिक पूर्वानुमान उपलब्ध है, शामिल है।
calendar
किसी भी समर्थित मुद्रा के लिए आगामी आर्थिक रिलीज समयमुद्रों की क्वेरी, एक वैकल्पिक संकेतक फ़िल्टर के साथ। यूनिक्स युग समयमुद्राओं को लौटाता है ताकि आप सटीक रूप से अनुवर्ती डेटा फ़ेचिंग शेड्यूल कर सकें।
प्रमाणीकरण उसी एपीआई कुंजी का उपयोग करता है जो REST सतह के रूप में इसे पास करता है api_key
अनुरोध URL पर क्वेरी पैरामीटर। स्कीमा को दृढ़ता से टाइप किया गया हैः प्रत्येक क्षेत्र, तर्क और वापसी वस्तु को सीधे स्कीम में प्रलेखित किया गया है, इसलिए आत्मनिरीक्षण और आईडीई ऑटोपूर्ति बॉक्स से बाहर काम करती है।
व्यापारियों और डेवलपर्स के लिए यह क्यों मायने रखता है
REST अंत बिंदु एकल-निर्देशक खोजों के लिए कुशल हैं. GraphQL उस क्षण मूल्यवान हो जाता है जब आपका वर्कफ़्लो एक ही विश्लेषणात्मक चक्र में कई मुद्राओं, कई संकेतकों या कई डेटा सतहों को कवर करता है.
एक क्रॉस-मुद्रा स्प्रेड मॉडल पर विचार करें जिसमें छह जी 10 मुद्राओं के लिए एक साथ मुद्रास्फीति और नीति दर इतिहास की आवश्यकता होती है। REST के साथ आप बारह अनुक्रमिक HTTP अनुरोध जारी करते हैं। GraphQL के साथ आपको छह युक्त एक अनुरोध निकाय भेजते हैं। announcements क्षेत्र उपनामों को प्राप्त करें और एक ही यात्रा में संयुक्त प्रतिक्रिया प्राप्त करें विलंबता में कटौती, कनेक्शन ओवरहेड को कम करें, और क्लाइंट कोड रैखिक रखें।
सटीक क्षेत्र चयन
केवल आपके मॉडल का उपयोग करने वाले क्षेत्रों के लिए पूछें. यदि आप की जरूरत है
date और val लेकिन प्रतिशत परिवर्तन के संवर्धन नहीं, उन्हें छोड़ दो. सर्वर आपके चयन सेट में नहीं है कुछ भी गणना छोड़ देता है.
एकल अंत बिंदु एकीकरण
एक आधार यूआरएल, एक प्रमाणीकरण तंत्र, एक प्रतिक्रिया लिफाफा. उपकरण जो पहले से ही GraphQL Apollo क्लाइंट, graphql-अनुरोध, पायथन के gql, R के ghql को किसी भी कस्टम REST एडाप्टर परत के बिना एकीकृत करता है।
स्कीमा-पहली खोज
प्रत्येक उपलब्ध मुद्रा, संकेतक और क्षेत्र प्रकार को प्रोग्रामेटिक रूप से सूचीबद्ध करने के लिए एक आत्मनिरीक्षण क्वेरी को फायर करें कोई अलग प्रलेखन स्क्रैपिंग की आवश्यकता नहीं है।
केंद्रीय बैंक लक्ष्य संदर्भ
announcements क्वेरी एक वैकल्पिक लौटाता है
cbTarget आपको वर्तमान केंद्रीय बैंक लक्ष्य सीमा, प्रभावी तिथि और स्रोत उसी उत्तर में देते हुए।
व्यावहारिक उदाहरणः बहु मुद्रा मुद्रास्फीति क्वेरी
मान लीजिए कि आप एक जी 3 मुद्रास्फीति डैशबोर्ड बना रहे हैं और एक शॉट में अमरीकी डालर, यूरो और GBP के लिए पिछले बारह महीनों के सीपीआई डेटा की आवश्यकता है।
announcements एक ही GraphQL दस्तावेज़ के भीतर तीन बार क्षेत्रः
curl -X POST "https://fxmacrodata.com/api/v1/graphql?api_key=YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"query": "{ usd: announcements(currency: \"USD\", indicator: \"inflation\", startDate: \"2025-04-01\") { currency indicator data { date val announcementDatetime } } eur: announcements(currency: \"EUR\", indicator: \"inflation\", startDate: \"2025-04-01\") { currency indicator data { date val announcementDatetime } } gbp: announcements(currency: \"GBP\", indicator: \"inflation\", startDate: \"2025-04-01\") { currency indicator data { date val announcementDatetime } } }"
}'प्रतिनिधि प्रतिक्रियाः
{
"data": {
"usd": {
"currency": "USD",
"indicator": "inflation",
"data": [
{ "date": "2026-03-01", "val": 2.8, "announcementDatetime": 1743253200 },
{ "date": "2026-02-01", "val": 3.0, "announcementDatetime": 1740747600 }
]
},
"eur": {
"currency": "EUR",
"indicator": "inflation",
"data": [
{ "date": "2026-03-01", "val": 2.3, "announcementDatetime": 1743340800 },
{ "date": "2026-02-01", "val": 2.4, "announcementDatetime": 1740834000 }
]
},
"gbp": {
"currency": "GBP",
"indicator": "inflation",
"data": [
{ "date": "2026-03-01", "val": 2.6, "announcementDatetime": 1743253200 },
{ "date": "2026-02-01", "val": 2.8, "announcementDatetime": 1740747600 }
]
}
}
}
तीन मुद्राओं, एक HTTP राउंड-ट्रिप। announcementDatetime प्रत्येक डेटा बिंदु पर युग आपको सटीक सेकंड देता है जब प्रिंट जारी किया गया था, इसलिए आप बाजार प्रतिक्रियाओं को मॉडलिंग करते समय कैलेंडर महीने के बजाय घटना समय पर श्रृंखला को संरेखित कर सकते हैं।
अमरीकी डालर नीतिगत दर का अंतिम बिंदु
और इसके यूरो और GBP समकक्षों को दर अंतर परत जोड़ने के लिए।
व्यावहारिक उदाहरण: उपलब्ध संकेतकों की खोज करें
नया मॉडल बनाने से पहले आप GraphQL के माध्यम से डेटा कैटलॉग में प्रश्न पूछ सकते हैं, जिसमें किसी मुद्रा के लिए उपलब्ध प्रत्येक संकेतक की सूची दी गई है, जिसमें इसकी अद्यतन आवृत्ति और क्या आधिकारिक केंद्रीय बैंक का पूर्वानुमान जारी किया गया है, शामिल हैः
curl -X POST "https://fxmacrodata.com/api/v1/graphql?api_key=YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"query": "{ dataCatalogue(currency: \"AUD\") { currency indicators { slug name unit frequency hasOfficialForecast } } }"
}'प्रतिनिधि प्रतिक्रिया (ट्रिंक):
{
"data": {
"dataCatalogue": {
"currency": "AUD",
"indicators": [
{
"slug": "policy_rate",
"name": "Cash Rate Target",
"unit": "%",
"frequency": "irregular",
"hasOfficialForecast": false
},
{
"slug": "inflation",
"name": "CPI Inflation",
"unit": "%",
"frequency": "quarterly",
"hasOfficialForecast": false
},
{
"slug": "unemployment",
"name": "Unemployment Rate",
"unit": "%",
"frequency": "monthly",
"hasOfficialForecast": false
}
]
}
}
}
वापस लौटी गोले सीधे के लिए नक्शे indicator तर्क का
announcements प्रश्न कोई अलग प्रलेखन पास की आवश्यकता नहीं है. आप खोज चरण स्क्रिप्ट कर सकते हैं और स्वचालित रूप से आपके मॉडल की आवश्यकता है जो भी संकेतकों के लिए एक अनुरोध बैच का निर्माण.
एडीयू एपीआई दस्तावेज. .
व्यावहारिक उदाहरणः रिलीज कैलेंडर खोज
यह जानना कि अगली उच्च प्रभाव वाली प्रिंट कब होनी है, घटना जोखिम के आसपास स्थिति आकार के लिए महत्वपूर्ण है। calendar क्वेरी किसी भी समर्थित मुद्रा के लिए आगामी रिलीज टाइमस्टैम्प को प्रकट करती है, परिणामों को संकुचित करने के लिए एक वैकल्पिक संकेतक फ़िल्टर के साथः
curl -X POST "https://fxmacrodata.com/api/v1/graphql?api_key=YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"query": "{ calendar(currency: \"CAD\", indicator: \"policy_rate\") { currency indicator data { release announcementDatetime } } }"
}'प्रतिनिधि प्रतिक्रियाः
{
"data": {
"calendar": {
"currency": "CAD",
"indicator": "policy_rate",
"data": [
{
"release": "policy_rate",
"announcementDatetime": 1747400400
},
{
"release": "policy_rate",
"announcementDatetime": 1752580800
}
]
}
}
}
announcementDatetime मान यूनिक्स युग पूर्णांक हैं उन्हें सीधे किसी भी तिथि-पार्सिंग चरण के बिना एक शेड्यूलर या अलर्ट सिस्टम में छोड़ दें। एक बार में कई मुद्राओं को स्कैन करने के लिए, उर्फ calendar क्षेत्र में बस के रूप में आप करेंगे उपनाम announcements: सीएडी, एयूडी और एनजेडडी नीतिगत दरों की तारीखों को कवर करने वाली एक क्वेरी लिखें और एक एकल समेकित कैलेंडर प्रतिक्रिया प्राप्त करें। पूर्ण देखें
सीएडी नीतिगत दर संदर्भ
REST के समकक्ष के लिए।
GraphQL बनाम REST: प्रत्येक का उपयोग कब करें
दोनों इंटरफेस एक ही फायरस्टोर समर्थित डेटा स्टोर से आकर्षित करते हैं और समान ले जाते हैं
announcement_datetime सटीकता. विकल्प एक कार्यप्रवाह निर्णय हैः
| परिदृश्य | अनुशंसित इंटरफ़ेस |
|---|---|
| एकल संकेतक, एकल मुद्रा | REST सरल URL, कर्ल-अनुकूल |
| एक अनुरोध में कई मुद्राएं या संकेतक | GraphQL क्षेत्र उपनाम कई राउंड-ट्रिप को समाप्त करता है |
| मजबूत टाइप क्लाइंट (टाइपस्क्रिप्ट, कोटलिन, स्विफ्ट) | GraphQL स्वचालित रूप से आत्मनिरीक्षण से प्रकार उत्पन्न |
| नोटबुक या स्क्रिप्टिंग वातावरण | REST या GraphQL दोनों एकल हैं curl या requests.get() कॉल करना |
| योजना अन्वेषण/कैटलॉग खोज | GraphQL आत्मनिरीक्षण डॉक्स स्क्रैपिंग के बिना पूर्ण स्कीमा लौटाता है |
| मौजूदा REST आधारित पाइपलाइन | REST कोई माइग्रेशन की आवश्यकता नहीं; दोनों सतहों समानांतर में बनाए रखा जाता है |
शुरू करो
GraphQL अंत बिंदु REST सतह के लिए उपयोग की जाने वाली उसी API कुंजी पर सभी ग्राहकों के लिए उपलब्ध है. कोई अतिरिक्त विन्यास की आवश्यकता नहीं है.
प्रथम कदम
- अपनी पहली क्वेरी चलाएँ:
curl -X POST "https://fxmacrodata.com/api/v1/graphql?api_key=YOUR_API_KEY" -H "Content-Type: application/json" -d '{"query":"{ dataCatalogue(currency: \"USD\") { indicators { slug name } } }"}' - का उपयोग कर लाइव स्कीमा का अन्वेषण करें एपीआई प्रलेखन केंद्र
- पर मुद्रा के अनुसार सभी समर्थित संकेतकों को देखें एपीआई दस्तावेज
- अभी तक कोई एपीआई कुंजी नहीं? आरंभ करने के लिए सदस्यता लें एक निःशुल्क स्तर उपलब्ध है।
