आपकी API कुंजियाँ वो माध्यम हैं जिनसे Freya आपके एक्सचेंज पर आपकी तरफ़ से ट्रेड करता है। एक बार एक्सचेंज कनेक्ट करने के बाद, आपकी सभी कुंजियाँ एक जगह दिखती हैं जहाँ आप उन्हें देख सकते हैं, हर कुंजी की अनुमतियाँ जान सकते हैं, नई कुंजी जोड़ सकते हैं, या जिनकी ज़रूरत नहीं रही उन्हें हटा सकते हैं। इस गाइड में हम इन्हीं बातों को समझेंगे।
अगर आप पहली बार एक्सचेंज कनेक्ट कर रहे हैं, तो पहले अपना एक्सचेंज कैसे कनेक्ट करें पढ़ें। यह लेख उन कुंजियों के प्रबंधन के बारे में है जो आपने पहले से जोड़ी हैं।
मुख्य बातें
- आपकी सभी कनेक्टेड एक्सचेंज API कुंजियाँ सेटिंग्स → API Keys में दिखती हैं, जिसमें एक्सचेंज, लेबल, कब जोड़ी गई, और स्थिति शामिल होती है।
- हर कुंजी अपनी अनुमतियाँ दिखाती है: पढ़ना, ट्रेड, और (Futures के लिए) Futures access, ताकि आप ठीक से जान सकें कि वह क्या करने देती है।
- आप कभी भी नई कुंजी जोड़ सकते हैं, या जो अब काम नहीं आती उसे हटा सकते हैं।
- Freya उस कुंजी को नहीं हटाएगा जिसे कोई Bot अभी उपयोग कर रहा है। पहले उन Bots को रोकें या pause करें; हटाना वापस नहीं किया जा सकता, और कुंजी हटने पर आपको सूचना मिलती है।
- आपकी API क्रेडेंशियल एन्क्रिप्टेड रूप में संग्रहित होती हैं, और Freya को आपकी कुंजियों पर कभी भी निकासी (withdrawal) की अनुमति की ज़रूरत नहीं होती।
चरणों का संक्षिप्त अवलोकन
- अपनी कुंजी सूची खोलें: सेटिंग्स → API Keys पर जाएं, जहाँ हर कनेक्टेड एक्सचेंज अपने लेबल, जोड़ने की तारीख़ और स्थिति के साथ दिखाई देता है।
- हर कुंजी की अनुमतियाँ जाँचें: सुनिश्चित करें कि पढ़ना और ट्रेड (और अगर आप Futures trade करते हैं तो Futures) दिख रही हैं, और withdrawal access कभी नहीं।
- ज़रूरत पड़ने पर कुंजी जोड़ें: API कुंजी जोड़ें बटन से दूसरा एक्सचेंज या अतिरिक्त कुंजी कनेक्ट करें, वही प्रक्रिया जो आपके पहले कनेक्शन में थी।
- जो कुंजियाँ काम नहीं आतीं उन्हें हटाएं: हटाएं चुनें और पुष्टि करें। अगर कोई Bot अभी उस कुंजी का उपयोग कर रहा है, तो Freya हटाने से मना कर देगा और बताएगा कि कितने Bots प्रभावित हैं; पहले उन्हें रोकें या pause करें।
अपनी API कुंजियाँ कहाँ ढूँढें
सेटिंग्स → API Keys पर जाएं। आपको आपकी API कुंजियाँ दिखाई देगा, जो आपके खाते पर हर एक्सचेंज कनेक्शन की सूची है। हर कुंजी के लिए Freya दिखाता है:
- एक्सचेंज (Binance, OKX, या Bybit)।
- कुंजी का लेबल, ताकि आप कई कुंजियों को अलग पहचान सकें।
- कुंजी कब जोड़ी गई (तारीख़)।
- कुंजी की स्थिति (सक्रिय)।
अगर आपने अभी तक कुछ कनेक्ट नहीं किया है, तो इसकी जगह अपनी पहली API कुंजी जोड़ें का प्रॉम्प्ट दिखाई देगा।
कुंजी अनुमतियों को समझना
हर कुंजी उन अनुमतियों को दिखाती है जिनके साथ वह बनाई गई थी, ताकि कभी कोई संदेह न रहे कि वह क्या कर सकती है:
- पढ़ना: Freya को आपकी बैलेंस और पोज़ीशन देखने देती है (हर काम के लिए ज़रूरी)।
- ट्रेड: Freya को ऑर्डर प्लेस और मैनेज करने देती है (आपके Bots इसी से trade करते हैं)।
- Futures: तब दिखती है जब कुंजी में Futures trading access भी चालू हो।
यह पारदर्शिता महत्वपूर्ण है: Freya की कुंजी सिर्फ़ पढ़ने और trading के लिए होती है। इसमें withdrawal की अनुमति नहीं होती, और होनी भी नहीं चाहिए, इसलिए आपके फंड Freya के ज़रिए कभी भी आपके एक्सचेंज से बाहर नहीं जा सकते। पूरी जानकारी के लिए देखें क्या मेरा पैसा Freya Finance पर सुरक्षित है?।
दूसरी कुंजी जोड़ना
आप उसी स्क्रीन से API कुंजी जोड़ें का उपयोग करके एक से ज़्यादा एक्सचेंज (या एक से ज़्यादा कुंजी) कनेक्ट कर सकते हैं। सेटअप की प्रक्रिया वही है जो आपके पहले कनेक्शन में थी। स्टेप-बाय-स्टेप गाइड और OKX passphrase की जानकारी के लिए अपना एक्सचेंज कैसे कनेक्ट करें देखें।
कुंजी हटाना
किसी कनेक्शन को हटाने के लिए, कुंजी पर हटाएं चुनें और पुष्टि करें। कुछ ज़रूरी बातें:
- इसे वापस नहीं किया जा सकता। दोबारा कनेक्ट करने के लिए आपको कुंजी शुरू से जोड़नी होगी।
- Freya हटाने से पहले जाँच करता है। अगर कोई Bot उस कुंजी से चल रहा है, या arm होकर trade के लिए तैयार है, तो हटाने से मना कर दिया जाएगा और बताया जाएगा कि कितने Bots शामिल हैं। पहले डैशबोर्ड से उन्हें रोकें या pause करें, फिर दोबारा कोशिश करें। जो Bot बीच trade में अपनी कुंजी खो देता है, वह पहले से खोली गई पोज़ीशन को मैनेज नहीं कर पाएगा।
- आपको सूचना मिलती है जब कोई कुंजी हटाई जाती है। यह एक सुरक्षा उपाय है ताकि आपको हमेशा पता रहे कि access में कब बदलाव हुआ।
आपकी कुंजियाँ सुरक्षित रूप से संग्रहित हैं
Freya आपकी API क्रेडेंशियल एन्क्रिप्टेड रूप में संग्रहित करता है। API Keys स्क्रीन पर भी "सुरक्षित रूप से संग्रहीत" लिखा दिखता है। इसके साथ यह तथ्य कि कुंजियों में withdrawal की अनुमति नहीं होती, इसका मतलब है कि सबसे ख़राब स्थिति में भी कोई Freya के ज़रिए आपके एक्सचेंज खाते से फंड बाहर नहीं निकाल सकता।
अक्सर पूछे जाने वाले सवाल
मैं अपनी एक्सचेंज API कुंजियाँ कहाँ प्रबंधित करूँ?
सेटिंग्स → API Keys में। इस स्क्रीन पर हर कनेक्टेड कुंजी अपने एक्सचेंज, लेबल, जोड़ने की तारीख़ और स्थिति के साथ दिखती है, और यहीं से आप नई कुंजी जोड़ सकते हैं या मौजूदा कुंजी हटा सकते हैं।
पढ़ना, ट्रेड, और Futures लेबल का क्या मतलब है?
ये दिखाते हैं कि हर कुंजी को क्या करने की अनुमति है। पढ़ना Freya को आपकी बैलेंस और पोज़ीशन देखने देता है; ट्रेड उसे ऑर्डर प्लेस और मैनेज करने देता है (आपके Bots इसी का उपयोग करते हैं); और Futures तब दिखता है जब कुंजी में Futures trading access भी चालू है। Freya की कुंजी को कभी withdrawal अनुमति की ज़रूरत नहीं होती।
मैं दूसरा एक्सचेंज या कुंजी कैसे जोड़ूँ?
उसी स्क्रीन पर API कुंजी जोड़ें का उपयोग करें। यह वही कनेक्शन प्रक्रिया चलाता है जो आपकी पहली कुंजी के लिए थी। पूरी वॉकथ्रू और OKX के अतिरिक्त passphrase की जानकारी के लिए "अपना एक्सचेंज कैसे कनेक्ट करें" गाइड देखें।
जब मैं कोई API कुंजी हटाता हूँ तो क्या होता है?
Freya जाँच करता है कि कोई चीज़ अभी भी उस कुंजी पर निर्भर है या नहीं। अगर कोई Bot उस कुंजी से चल रहा है, या arm होकर सिग्नल का इंतज़ार कर रहा है, तो हटाने से मना कर दिया जाएगा और आपको दिखेगा कि कितने Bots शामिल हैं। पहले उन्हें रोकें या pause करें, फिर हटाएं। जब कोई चीज़ उस कुंजी पर निर्भर नहीं रहती, तो कनेक्शन हटा दिया जाता है और इसे वापस नहीं किया जा सकता। आपको कुंजी हटने की पुष्टि करने वाली सूचना भी मिलेगी।
क्या मेरी API कुंजियाँ सुरक्षित रूप से संग्रहित हैं?
हाँ। आपकी क्रेडेंशियल एन्क्रिप्टेड रूप में संग्रहित हैं, और आप जो कुंजियाँ कनेक्ट करते हैं उनमें सिर्फ़ trading access होता है, withdrawal अनुमति कभी नहीं। इसका मतलब है कि Freya के ज़रिए आपके एक्सचेंज से फंड निकाला नहीं जा सकता।
क्या Freya मेरी API कुंजी से मेरे फंड निकाल सकता है?
नहीं। कुंजियाँ सिर्फ़ read और trade access के साथ बनाई जाती हैं, withdrawal के साथ नहीं। अगर कुछ ग़लत भी हो जाए, तो भी कोई Freya की कुंजी से आपके फंड एक्सचेंज से बाहर नहीं निकाल सकता।
मैं किसी API कुंजी की अनुमतियाँ कैसे बदलूँ, उसे rotate या disable कैसे करूँ?
कनेक्टेड कुंजी को "संपादित" करने का कोई विकल्प नहीं है। अनुमतियाँ बदलने, rotate, या कुंजी बदलने के लिए, आपको Freya से उसे हटाना होगा और नई कुंजी जोड़नी होगी। अपने एक्सचेंज पर अपडेटेड कुंजी बनाएं, फिर उसे दोबारा कनेक्ट करें। पुरानी कुंजी का उपयोग करने वाले Bots को पहले रोकें या pause करें, क्योंकि Freya उस कुंजी को नहीं हटाएगा जो अभी उपयोग में है; नई कुंजी कनेक्ट होने के बाद, उन Bots को नई कुंजी से जोड़ें और फिर शुरू करें। अगर आप कुंजी को बिना हटाए बंद करना चाहते हैं, तो कुंजी हटाने की बजाय उस पर निर्भर Bots को pause कर दें।