जब आप कोई exchange API key जोड़ते हैं, तो Freya उसे सहेजने से पहले जाँचता है — और अगर कुछ गड़बड़ हो, तो वह बताता है कि क्या ठीक करना है। यह गाइड आपको वह नतीजा पढ़ने और ठीक करने में मदद करती है। (अगर आपकी key पहले ठीक से कनेक्ट हो गई थी लेकिन बाद में कोई bot रुक गया, तो यह अलग समस्या है — देखें मेरा Bot क्यों रुका या बंद हुआ?।)
पहली बार सेटअप के चरणों के लिए, अपना Exchange कैसे कनेक्ट करें से शुरू करें; यह लेख इस बारे में है कि जब वह कनेक्शन विफल हो जाए तब क्या करें।
मुख्य बातें
- जब आप कोई key जोड़ते हैं, तो Freya उसे सहेजने से पहले जाँचता है कि वह कनेक्ट होती है और उसके पास सही permissions हैं — अगर कुछ विफल होता है, तो एरर बताता है कि क्या ठीक करना है।
- “Invalid API Key/Secret” का मतलब आमतौर पर copy/paste की चूक या दोबारा जेनरेट की गई key होता है; “IP” एरर का मतलब है कि key का IP restriction वह नहीं है जो Freya को चाहिए।
- आपकी key के पास read और trade permissions होनी चाहिए (कभी withdrawal नहीं) और वह सही मार्केट — spot या futures — के लिए सक्षम होनी चाहिए ताकि वह आपके bot से मेल खाए।
- OKX keys के लिए एक passphrase ज़रूरी है जो बिलकुल मेल खाना चाहिए; futures keys के लिए, Freya आपके खाते को अपने आप तैयार कर देता है ताकि bot सही तरीके से ट्रेड कर सके।
- एक सामान्य “Connection Failed” अक्सर पल-भर की network या exchange अड़चन होती है — बस दोबारा कोशिश करें।
जब कोई Key कनेक्ट नहीं होती
Key जोड़ना कोई अंधाधुंध सेव नहीं है — Freya पहले यह सत्यापित करता है कि key काम करती है और उसके पास सही permissions हैं, फिर उसे एन्क्रिप्ट करके सहेजा जाता है। अगर कुछ गड़बड़ हो, तो एरर सीधे कारण की ओर इशारा करता है — आमतौर पर key या secret, IP restriction, या कोई गायब permission। नीचे के सेक्शन हर एरर और उसे ठीक करने का तरीका बताते हैं।
"Invalid API Key" या "Invalid Secret Key"
सबसे आम कनेक्शन एरर, और आमतौर पर सबसे सरल:
- Copy/paste की चूक — कोई फालतू स्पेस या कोई गायब कैरेक्टर। key और secret, दोनों को ध्यान से दोबारा कॉपी करें।
- Secret सिर्फ़ एक बार दिखाया जाता है। Exchanges secret key को बनाते समय केवल एक बार दिखाते हैं। अगर आपने उसे सहेजा नहीं, तो आप उसे वापस नहीं पा सकते — एक नई key बनाएँ।
- Key exchange पर डिलीट या दोबारा जेनरेट कर दी गई, इसलिए अब वह मेल नहीं खाती।
समाधान: key और secret बिलकुल दोबारा दर्ज करें, या एक नई key बनाकर फिर कोशिश करें।
IP Restriction एरर
Freya अपने खुद के servers से कनेक्ट होता है, इसलिए key की IP settings मायने रखती हैं। दो अलग-अलग स्थितियाँ हैं:
- "IP Not Whitelisted" — आपकी key IP-प्रतिबंधित है, लेकिन Freya के server का पता उसकी allow-list में नहीं है। Add API Key स्क्रीन आपको जोड़ने के लिए IP पता (या पते) दिखाती है (एक copy बटन के साथ) — उन्हें exchange पर key की whitelist में जोड़ें।
- "Unrestricted" — आपकी key पर कोई IP restriction है ही नहीं। आपकी सुरक्षा के लिए, Freya आपसे IP restriction चालू करने और दिखाया गया पता जोड़ने के लिए कहता है, फिर दोबारा कोशिश करें।
दोनों मामलों में समाधान का विचार एक ही है: key को उस IP तक सीमित करें जो Freya modal में दिखाता है।
Permission एरर
Key कनेक्ट हो गई, लेकिन वह वह नहीं कर सकती जो आपके bot को चाहिए:
- Reading बंद है — key पर read/view permission सक्षम करें।
- Trade permission गायब है — trading सक्षम करें (spot और/या futures, आपके bot से मेल खाते हुए)।
- Spot बनाम Futures बेमेल — एक futures bot को ऐसी key चाहिए जिसमें futures trading सक्षम हो; एक spot bot को spot trading चाहिए। अगर आपने futures bot के लिए spot-only key जोड़ी (या इसका उल्टा), तो Freya इसे चिह्नित करता है। सुनिश्चित करें कि key का सक्षम मार्केट उस bot से मेल खाता है जिसे आप बना रहे हैं।
याद रखें: Freya को हमेशा केवल read और trade permissions चाहिए — कभी withdrawal नहीं। बिना withdrawal permission वाली key ठीक वही है जो आप चाहते हैं।
Exchange-विशिष्ट बारीकियाँ
- OKX को passphrase चाहिए। जब आप कोई OKX key बनाते हैं, तो आप एक passphrase सेट करते हैं — वही passphrase Freya में दर्ज करें, बिलकुल वैसे ही जैसे आपने सेट किया था। गलत passphrase एक आम OKX कनेक्शन विफलता है।
- OKX futures सेटअप। OKX futures trading को एक ख़ास account mode चाहिए, जिसे Freya आपके लिए अपने आप सेट कर देता है — आपको इसे हाथ से कॉन्फ़िगर करने की ज़रूरत नहीं।
- Hedge mode (futures)। Freya futures खातों के लिए hedge mode इस्तेमाल करता है। अगर आपके पास पहले से खुली one-way positions हैं जो टकराती हैं, तो आपको विफलता की जगह एक चेतावनी दिख सकती है — key फिर भी सहेजी जाती है, और वे मौजूदा positions बंद होने के बाद आपका bot ट्रेड कर सकता है।
- Binance और Bybit passphrase इस्तेमाल नहीं करते — उनके लिए कोई passphrase फ़ील्ड नहीं होता।
बिना किसी स्पष्ट कारण के "Connection Failed"
एक सामान्य कनेक्शन विफलता अक्सर आपकी गलती नहीं होती — पल-भर की network झिलमिलाहट या exchange का थोड़ी देर व्यस्त होना। एक पल रुकें और दोबारा कोशिश करें। अगर कुछ कोशिशों के बाद भी विफल होता रहे, तो ऊपर दी गई key/secret और IP settings दोबारा जाँचें।
अभी भी अटके हैं? एक झटपट चेकलिस्ट
- Exchange पर key दोबारा बनाएँ — केवल read + trade के साथ (कभी withdrawal नहीं)।
- उसे उस IP तक सीमित करें जो Freya Add API Key स्क्रीन में दिखाता है।
- मार्केट मिलाएँ — spot bot के लिए spot key, futures bot के लिए futures key।
- OKX: बिलकुल सही passphrase दर्ज करें।
- अभी भी विफल हो रहा है? [email protected] से संपर्क करें।
अक्सर पूछे जाने वाले सवाल
Freya कहता है "Invalid API Key" पर मुझे पक्का यकीन है कि मैंने इसे सही कॉपी किया — क्या गड़बड़ है?
आमतौर पर कोई छिपा हुआ कैरेक्टर या स्पेस key या secret में घुस जाता है, या key exchange पर दोबारा जेनरेट/डिलीट कर दी गई थी इसलिए वह अब मेल नहीं खाती। दोनों फ़ील्ड ध्यान से दोबारा कॉपी करें, और याद रखें कि secret बनाते समय केवल एक बार दिखाया जाता है — अगर वह आपके पास नहीं है, तो एक नई key बनाएँ।
"IP Not Whitelisted" और "Unrestricted" में क्या फ़र्क है?
"IP Not Whitelisted" का मतलब है कि आपकी key IP-प्रतिबंधित है लेकिन Freya के server का पता अभी अनुमत नहीं है — Freya जो पता दिखाता है उसे key की whitelist में जोड़ें। "Unrestricted" का मतलब है कि key पर कोई IP restriction है ही नहीं; सुरक्षा के लिए, Freya आपसे सहेजने से पहले IP restriction चालू करने और उसका पता जोड़ने के लिए कहता है।
मेरी OKX key कनेक्ट नहीं हो रही — क्या मुझे passphrase चाहिए?
हाँ। OKX keys में एक passphrase होता है जिसे आप key बनाते समय सेट करते हैं। आपको वही बिलकुल सही passphrase Freya में दर्ज करना होगा — गलत या गायब passphrase एक आम OKX कनेक्शन विफलता है। Binance और Bybit इसका इस्तेमाल नहीं करते।
Freya कहता है कि मेरी key ट्रेड नहीं कर सकती — मैं इसे कैसे ठीक करूँ?
आपकी key में उस मार्केट के लिए trading सक्षम नहीं है जिसे आपका bot इस्तेमाल करता है। Exchange पर trade permission सक्षम करें — spot bot के लिए spot trading, futures bot के लिए futures trading — फिर दोबारा कनेक्ट करें। Freya को read और trade permissions चाहिए, कभी withdrawal नहीं।
मेरी futures key को अतिरिक्त सेटअप चाहिए (account mode / hedge mode) — क्या यह कोई समस्या है?
नहीं। Futures trading को एक ख़ास account mode और hedge mode चाहिए, जिसे Freya आपके लिए अपने आप सेट कर देता है। अगर आपके पास मौजूदा one-way positions हैं, तो आपको एरर की जगह एक hedge-mode चेतावनी दिख सकती है — key फिर भी सहेजी जाती है, और वे positions बंद होने के बाद आपका bot ट्रेड कर सकता है।
मैंने एक spot key जोड़ी पर मेरा futures bot उसे इस्तेमाल नहीं करेगा (या इसका उल्टा) — क्यों?
एक key किसी ख़ास मार्केट के लिए सक्षम होती है। एक futures bot को ऐसी key चाहिए जिसमें futures trading सक्षम हो, और एक spot bot को spot trading चाहिए। अगर वे मेल नहीं खाते, तो Freya इसे चिह्नित करता है। ऐसी key कनेक्ट करें जिसका सक्षम मार्केट उस bot से मेल खाता हो जिसे आप बना रहे हैं।
कनेक्शन बस बिना किसी स्पष्ट कारण के "failed" हो गया — यह मेरी वजह से है या exchange की?
अक्सर यह आपकी settings के बजाय पल-भर की network या exchange अड़चन होती है। एक पल में दोबारा कोशिश करें। अगर यह विफल होता रहे, तो key और secret में copy की गलतियाँ दोबारा जाँचें और पक्का करें कि IP restriction उस पते से मेल खाता है जो Freya दिखाता है।