Google Sheets में CoinGecko से क्रिप्टो कीमतें ट्रैक करें

1. शीट बनाने से पहले तय करें कि कीमतों को कैसे ट्रैक करना है

Google Sheets में क्रिप्टो कीमतें कैसे ट्रैक करें, इसकी शुरुआत फ़ॉर्मूला बनाने से नहीं, बल्कि एक संक्षिप्त योजना से करें। उन कॉइन, कोट करेंसी और अपडेट शेड्यूल की सूची बनाएं जिन्हें आप ट्रैक करना चाहते हैं। यह भी तय करें कि आपको सिर्फ़ मौजूदा कीमत चाहिए, पुराने रिकॉर्ड चाहिए या दोनों। USD में BTC और ETH पर नज़र रखने वाली शीट का उद्देश्य EUR और GBP में मिले-जुले पोर्टफ़ोलियो का रिकॉर्ड रखने वाली शीट से अलग होगा।

पहला संस्करण छोटा रखें। उदाहरण के लिए, एक ही करेंसी में तीन कॉइन ट्रैक करें और हर घंटे डेटा अपडेट करें। पंक्तियां या करेंसी तभी बढ़ाएं, जब यह पुष्टि कर लें कि नतीजे CoinGecko पर दिखाए गए डेटा से मेल खाते हैं। ज़रूरी अनुरोधों की संख्या और उपलब्ध अपडेट विकल्प आपके चुने हुए तरीके और खाते की शर्तों पर निर्भर करते हैं, इसलिए शेड्यूल तय करने से पहले मौजूदा सीमाएं जांच लें।

अपनी शीट में “कीमत” का मतलब तय करें। मौजूदा भाव किसी एक समय का मूल्य होता है, यह पक्का नहीं कि उसी कीमत पर ट्रेड हो भी जाएगा। अगर आप इसकी तुलना किसी ट्रेड से करना चाहते हैं, तो भाव का टाइमस्टैम्प दर्ज करें और देरी से मिले या कैश किए गए डेटा को लाइव न मानें।

2. अपने सेटअप के मुताबिक API एक्सेस का तरीका चुनें

CoinGecko API को Google Sheets से कैसे जोड़ें, इसके तीन आम तरीके हैं: Sheets ऐड-ऑन, छोटा Apps Script या किसी तीसरे पक्ष का कनेक्टर। तकनीकी जानकारी कम रखने वाले उपयोगकर्ताओं के लिए ऐड-ऑन अक्सर सबसे तेज़ विकल्प होता है। स्क्रिप्ट से अनुरोध के फ़ॉर्मैट और डेटा सेव करने के तरीके पर ज़्यादा नियंत्रण मिलता है। कनेक्टर से कोडिंग की ज़रूरत कम हो सकती है, लेकिन अपडेट बंद होने पर आपको एक और सेवा की जांच करनी होगी।

तरीका चुनने से पहले प्रमाणीकरण, अनुरोधों की सीमाओं और रखरखाव की तुलना करें। पता करें कि API कुंजी चाहिए या नहीं, वह कहां सेव होगी, कितनी बार डेटा अपडेट किया जा सकता है और क्या उसकी सीमाएं आपके कॉइन और करेंसी की संख्या के लिए पर्याप्त हैं। CoinGecko के API एक्सेस विकल्प और शर्तें बदल सकती हैं; मौजूदा ज़रूरतों के लिए उसका दस्तावेज़ देखें।

Apps Script का इस्तेमाल कर रहे हैं, तो स्प्रेडशीट का स्क्रिप्ट एडिटर खोलें और ऐसा फ़ंक्शन बनाएं जो CoinGecko से डेटा मांगे, जवाब को पार्स करे और चुनी हुई जानकारी शीट में लिखे। एक काम करने वाली और साफ़ त्रुटि संदेश देने वाली बुनियादी स्क्रिप्ट की समस्या ढूंढना आसान होता है। निजी API कुंजी को ऐसे सेल में न रखें जिसे स्प्रेडशीट देखने वाला हर व्यक्ति देख सकता हो।

अगर आप अभी भी अलग-अलग टूल की तुलना कर रहे हैं, तो सबसे अच्छा क्रिप्टो एक्सचेंज किसे कहेंगे वाली गाइड एक अलग फैसले के बारे में है: डेटा स्रोत के बजाय ट्रेडिंग प्लेटफ़ॉर्म चुनने के बारे में। इन दोनों फैसलों को अलग रखने से API फ़ीड को एक्सचेंज खाते समझने की गलती नहीं होगी।

3. कॉइन और करेंसी की लुकअप टेबल बनाएं

अनुरोधों में सिर्फ़ टिकर सिंबल के बजाय CoinGecko coin ID इस्तेमाल करें। एक ही टिकर अलग-अलग प्रोजेक्ट का हो सकता है, जबकि ID API को बताती है कि किस खास एसेट की जानकारी चाहिए। “Lookup” नाम का टैब बनाएं और उसमें डिस्प्ले नाम, CoinGecko ID, टिकर और टारगेट करेंसी के कॉलम रखें।

डिस्प्ले नाम	CoinGecko ID	टिकर	करेंसी
बिटकॉइन	bitcoin	BTC	usd
एथेरियम	ethereum	ETH	usd
उदाहरण एसेट	[ID की पुष्टि करें]	[टिकर की पुष्टि करें]	eur

पहली दो पंक्तियां दिखाती हैं कि किस तरह के पहचानकर्ता दर्ज करने हैं; किसी भी ID पर भरोसा करने से पहले उसे CoinGecko पर जांच लें। टिकर लेबल के लिए काम का है, लेकिन अनुरोध में ID की जगह इसका इस्तेमाल न करें। यह खास तौर पर तब ज़रूरी है, जब पोर्टफ़ोलियो में कोई ऐसा छोटा टोकन हो जिसका सिंबल किसी दूसरे प्रोजेक्ट के सिंबल से मिलता-जुलता हो।

करेंसी कोड एक ही फ़ॉर्मैट में रखें, जैसे छोटे अक्षरों में usd या eur—अगर चुने हुए एंडपॉइंट में यही फ़ॉर्मैट अपेक्षित है। Google Sheets में डेटा वैलिडेशन का नियम लगाकर करेंसी कॉलम को आपके सेटअप में समर्थित करेंसी तक सीमित किया जा सकता है। इससे usdd जैसी टाइपिंग की गलती API तक पहुंचने से रुकती है।

4. मौजूदा कीमतें एक साफ़-सुथरी डेटा टेबल में लाएं

Google Sheets में Bitcoin और Ethereum की कीमत कैसे देखें, इसके लिए कच्चे API डेटा को उस शीट से अलग रखें जिसमें लोग कीमतें देखते हैं। “Raw” टैब में जवाब या हाल ही में इंपोर्ट की गई वैल्यू रखी जा सकती हैं; “Prices” टैब में कॉइन का नाम, टिकर, करेंसी, कीमत और टाइमस्टैम्प दिखाए जा सकते हैं। इन्हें अलग रखने से अनुरोध वाला लॉजिक बिगाड़े बिना फ़ॉर्मैट बदलना आसान होता है।

मौजूदा कीमत पाने के लिए आम तौर पर अनुरोध में चुने हुए coin ID और कोट करेंसी को CoinGecko के प्राइस एंडपॉइंट पर भेजा जाता है। सटीक URL, पैरामीटर, प्रमाणीकरण का तरीका और जवाब में मिलने वाले फ़ील्ड आपके API प्रोडक्ट और एक्सेस के तरीके पर निर्भर करते हैं, इसलिए एंडपॉइंट की जानकारी के लिए CoinGecko का दस्तावेज़ देखें। नतीजों को टेबल में रखते समय, लौटाई गई वैल्यू को सही ID से जोड़ें—यह न मानें कि जवाब का क्रम हमेशा आपकी लिखी पंक्तियों जैसा ही होगा।

उदाहरण के लिए, आपकी डिस्प्ले टेबल में “Bitcoin | BTC | USD | कीमत | अपडेट का समय” दिख सकता है। कीमत वाले कॉलम को उचित दशमलव वाली संख्या के रूप में फ़ॉर्मैट करें, लेकिन ट्रैक किए जा रहे एसेट के लिए पर्याप्त सटीकता बनाए रखें। दिखाई जाने वाली वैल्यू को राउंड करना सिर्फ़ दिखावट का फैसला है; सेव की गई वैल्यू को राउंड करने से आगे की गणनाओं में गड़बड़ी हो सकती है।

अगर आप CoinGecko API की मदद से Google Sheets में क्रिप्टो की कीमतें ट्रैक करना चाहते हैं, तो एक कॉइन और एक करेंसी से शुरुआत करें। फिर पुष्टि करें कि मिला हुआ ID, करेंसी और भाव स्रोत के डेटा से मेल खाते हैं। यह काम करने लगे, तो लुकअप टेबल में और पंक्तियां जोड़ें और हर नई पंक्ति को जांचें। बड़ा डैशबोर्ड बनाने जितना रोमांचक तो नहीं, लेकिन इससे गलत ID जल्दी पकड़ में आ जाती हैं।

गणनाओं के लिए फ़ॉर्मूले इस्तेमाल करें, गायब डेटा को छिपाने के लिए नहीं। अनुरोध विफल हो जाए, तो “Request error” जैसा साफ़ संकेत दिखाएं या त्रुटि की स्थिति सामने रखें। शून्य को ऐसे न दिखाएं मानो एसेट की कीमत बेकार हो गई हो। शून्य से पोर्टफ़ोलियो का कुल मूल्य बदल सकता है और ऐसे फैसले लिए जा सकते हैं जिनका बाज़ार से कोई लेना-देना न हो।

5. अपडेट शेड्यूल करें और अनुरोधों की सीमाएं ध्यान में रखें

अपने API एक्सेस के तहत अनुमति मिलने वाले अंतराल पर ही ऑटोमैटिक अपडेट उपयोगी होता है। ऐड-ऑन के अपडेट कंट्रोल, Apps Script ट्रिगर और कनेक्टर के शेड्यूल अलग-अलग तरीके से काम करते हैं। अंतराल तय करने से पहले चुने हुए तरीके की मौजूदा कोटा और अपडेट के नियम जांच लें; सटीक सीमाएं प्लान के मुताबिक अलग हो सकती हैं और बदल भी सकती हैं।

कम अनुरोधों और लंबे अंतराल से शुरुआत करें। अगर आप पांच एसेट ट्रैक करते हैं, तो हर सेल के लिए अलग अनुरोध न भेजें, जबकि एक ही अनुरोध से ज़रूरी सारी वैल्यू मिल सकती हों। कम अनुरोधों से शीट को संभालना आसान हो सकता है, लेकिन पहले पुष्टि कर लें कि एंडपॉइंट एक साथ भेजे गए ID और करेंसी को सपोर्ट करता है।

गड़बड़ियों के लिए पहले से तैयारी रखें। API त्रुटि दे सकता है, सेवा उपलब्ध नहीं हो सकती या अनुरोधों की सीमा पूरी हो सकती है। पिछली बार सफल अपडेट का टाइमस्टैम्प दिखाते रहें और जब तक पुराना डेटा हटाना आपका इरादा न हो, खाली जवाब से सही पुराने डेटा को न बदलें। पुराना भाव फिर भी पुराना ही होता है, इसलिए उसे मौजूदा बताने के बजाय साफ़ तौर पर चिह्नित करें।

Apps Script ट्रिगर तय समय पर चल सकते हैं, लेकिन उन पर Google की अपनी निष्पादन सीमाएं और अनुमति की शर्तें लागू होती हैं। सेटअप के बाद ट्रिगर की स्थिति देखें और अपडेट रुकने पर निष्पादन लॉग जांचें। Google और CoinGecko की सीमाएं अलग-अलग हैं; एक की सीमा में रहने से यह गारंटी नहीं मिलती कि दूसरा हर अनुरोध स्वीकार करेगा।

6. टाइमस्टैम्प जोड़ें और कीमतों के पुराने रिकॉर्ड सहेजें

अगर किसी टेबल में कल की कीमत को आज की कीमत से बदल दिया जाता है, तो उसमें बदलाव नहीं देखा जा सकता। एक “History” टैब बनाएं और हर कॉइन और हर अपडेट के लिए अलग पंक्ति रखें। इसमें टाइमस्टैम्प, coin ID, करेंसी और कीमत के कॉलम हों। हर सफल जवाब को पिछला रिकॉर्ड हटाने के बजाय नई पंक्ति के रूप में लिखें।

उदाहरण के लिए, किसी रिकॉर्ड की पंक्ति कुछ ऐसी हो सकती है: “2026-11-12 10:00 | bitcoin | usd | [मिली हुई वैल्यू]”। अपने कनेक्शन या स्क्रिप्ट से मिला असली समय इस्तेमाल करें और यह भी बताएं कि वह UTC समय है या स्थानीय समय। दिखाई गई कीमत के साथ उसी अपडेट का टाइमस्टैम्प होना चाहिए, न कि वह समय जब किसी ने आखिरी बार शीट खोली थी।

History टैब में रिकॉर्ड बढ़ने से पहले डेटा कितने समय तक रखना है, यह तय करें। अपने इस्तेमाल और अनुरोधों की सीमा के मुताबिक लंबे समय के निजी ट्रैकर के लिए रोज़ाना का रिकॉर्ड रख सकते हैं या कम समय की निगरानी के लिए ज़्यादा बार रिकॉर्ड कर सकते हैं। सिर्फ़ इसलिए यह न मानें कि API जवाब में ऐतिहासिक डेटा भी है क्योंकि आपकी शीट में पुराने रिकॉर्ड जमा हो गए हैं—ये डेटा के अलग-अलग स्रोत हैं।

तारीख वाली पंक्तियों से दो रिकॉर्ड किए गए भावों के बीच का बदलाव निकाला जा सकता है, बशर्ते coin ID और कोट करेंसी एक ही हों। BTC/USD की पंक्ति की तुलना BTC/EUR से करने पर कीमत में बदलाव के साथ करेंसी का असर भी दिखेगा। इसलिए चार्ट बनाने से पहले दोनों डेटा सीरीज़ को साफ़ तौर पर लेबल करें।

7. नतीजे जांचें और कनेक्शन को चालू रखें

डैशबोर्ड पर भरोसा करने से पहले कुछ जांच कर लें। पुष्टि करें कि coin ID सही है, करेंसी का लेबल अनुरोध से मेल खाता है, मिली हुई कीमत संख्यात्मक है और टाइमस्टैम्प उसी अपडेट का है। इसके बाद एक नमूना नतीजा CoinGecko की साइट से मिलाएं और ध्यान रखें कि दोनों जगहों का डेटा अलग-अलग समय पर अपडेट हो सकता है।

जांच के दौरान त्रुटि के जवाब दिखने दें। अनुरोध विफल होने पर अमान्य कुंजी, गलत पैरामीटर, कोटा की समस्या या कुछ समय के लिए सेवा बंद होने जैसी वजहें सामने आ सकती हैं। त्रुटि का संदेश और उसका समय लिख लें; एक साथ कई सेटिंग बदलने पर असली वजह ढूंढना मुश्किल हो जाता है। एक ही त्रुटि बार-बार आए, तो एंडपॉइंट का दस्तावेज़ और अपना एक्सेस प्लान देखें।

लिखकर रखें कि स्क्रिप्ट या कनेक्टर का ज़िम्मेदार कौन है, क्रेडेंशियल कहां रखे गए हैं और किन टैब में बदलाव करना सुरक्षित है। अगर कोई स्क्रिप्ट के ज़रूरी कॉलम का नाम बदल दे, तो CoinGecko में कोई बदलाव न होने पर भी कनेक्शन बंद हो सकता है। Lookup और raw-data टैब को बिना सोचे-समझे किए जाने वाले बदलावों से सुरक्षित रखने पर ऐसी दिक्कत से बचा जा सकता है।

CoinGecko की API शर्तों, प्रमाणीकरण, उपलब्ध एंडपॉइंट या कोटा में बदलाव होने पर सेटअप की समीक्षा करें। किसी लाइव शीट में बदलाव करने से पहले मौजूदा जानकारी जांच लें। हर बदलाव के बाद एक कॉइन के साथ टेस्ट करना आम तौर पर गलत पैरामीटर को हर पंक्ति पर असर डालने से पहले पकड़ने के लिए काफी है। इस टेस्ट को वर्कबुक में रखें, ताकि अगला व्यक्ति भी इसे दोहरा सके।