इससे पहले कि कोई bot आपके लिए trade करे, Freya को उस exchange से कनेक्शन चाहिए जहाँ आपके फंड हैं: Binance, OKX, या Bybit। इसके लिए आपको न अपने फंड कहीं भेजने पड़ते हैं, न अपना पासवर्ड शेयर करना पड़ता है। इसकी जगह आप एक API key बनाते हैं: एक प्रतिबंधित credential जो Freya को आपकी ओर से trade लगाने देती है, जबकि आपके पैसे आपके अपने exchange अकाउंट में ही रहते हैं।
यह गाइड विस्तार से बताती है कि कौन सी permissions देनी हैं (और कौन सी कभी नहीं देनी), Freya में key कैसे जोड़ें, और अगर connection validate न हो तो क्या करें। अगर आप बड़ी तस्वीर समझना चाहते हैं कि यह सुरक्षित क्यों है, तो पहले क्या Freya Finance पर मेरा पैसा सुरक्षित है? पढ़ें।
मुख्य बातें
- आप exchange को API key से कनेक्ट करते हैं, एक प्रतिबंधित credential के ज़रिए, न कि फंड भेजकर या अपना exchange पासवर्ड शेयर करके।
- Key में Reading और Spot और/या Futures trading permissions होनी चाहिए। इसमें कभी भी withdrawal permission नहीं होनी चाहिए।
- OKX keys में एक passphrase ज़रूरी है जो आप बनाते समय सेट करते हैं; Binance और Bybit में passphrase नहीं होता।
- Freya में key जोड़ने के लिए Settings → API Keys → Add API Key पर जाएँ, Freya तुरंत उसे validate करता है।
- अगर validation फ़ेल होता है, तो Freya बिल्कुल सही बताता है कि क्या गड़बड़ है: invalid key, IP whitelisted नहीं, या कोई permission गायब है, और हर समस्या का आसान हल है।
कनेक्ट करने के दो तरीके
दो रास्ते हैं, और आपको कौन से दिखेंगे यह इस बात पर निर्भर करता है कि आप कौन सा exchange चुनते हैं।
Fast Connection (Bybit). एक क्लिक। आप Bybit की अपनी साइट पर Freya को approve करते हैं, और key अपने आप बनकर सीधे Freya को पहुँच जाती है। आप कोई credential देखते, कॉपी करते, या पेस्ट नहीं करते, और न ही आपको कुछ whitelist करना पड़ता है। यह इसलिए उपलब्ध है क्योंकि Freya एक registered Bybit broker है, जिससे Bybit सही permissions के साथ key जारी कर सकता है।
Manual Connection (सभी exchanges). आप exchange पर खुद API key बनाते हैं, permissions चुनते हैं, Freya का IP address whitelist करते हैं, और key तथा secret Freya में पेस्ट करते हैं। कुछ ज़्यादा स्टेप्स हैं, लेकिन यह हर जगह काम करता है और हर सेटिंग पर आपका सीधा नियंत्रण रहता है।
अगर आप Bybit पर हैं, तो Fast Connection इस्तेमाल करें। नीचे permissions और validation के बारे में जो भी लिखा है वह लागू होता ही है; Fast Connection बस वे स्टेप्स आपके लिए खुद करता है।
📘 विशेष रूप से Bybit के लिए, दो समर्पित गाइड इस पेज से आगे की जानकारी देती हैं: Bybit को Freya से कनेक्ट करें में दोनों तरीके और key बदलने का तरीका बताया गया है, और Bybit से Fast Connection में समझाया गया है कि एक-क्लिक approval क्या एक्सेस देता है।
Manual Steps का संक्षिप्त अवलोकन
- अपने exchange पर API key बनाएँ reading और trading permissions के साथ, लेकिन withdrawal के बिना।
- Credentials कॉपी करें: API key, secret, और (OKX के लिए) passphrase।
- Freya में key जोड़ें Settings → API Keys → Add API Key पर जाकर, और अपना exchange चुनें।
- Freya को validate करने दें: Freya तुरंत connection और permissions जाँचता है।
- कोई error आए तो ठीक करें: validation फ़ेल होने पर Freya बिल्कुल सटीक बताता है कि क्या गलत है।
Fast Connection, स्टेप बाय स्टेप
Bybit पर, Settings → API Keys → Add API Key खोलें, Fast Connection टैब चुना रहने दें, और Connect with Bybit पर क्लिक करें। एक Bybit विंडो खुलेगी।
- Bybit में साइन इन करें: अगर आपका अकाउंट नहीं है तो वहीं नया बना सकते हैं।
- देखें कि आप क्या approve कर रहे हैं। Bybit आपको दिखाता है कि Freya क्या एक्सेस माँग रहा है।
- Approve करें। विंडो अपने आप बंद हो जाती है और आपकी keys Freya में दिखने लगती हैं।
एक ही approval Spot और Futures दोनों सेट अप कर देता है, इसलिए आपको हर market के लिए यह प्रक्रिया दोहरानी नहीं पड़ती।
तीन बातें जानने योग्य हैं:
- मना करना पूरी तरह सुरक्षित है। अगर आप Bybit की स्क्रीन पर मन बदलते हैं, तो कुछ भी नहीं बनता और Freya में कुछ भी नहीं बदलता।
- दोबारा कनेक्ट करने से keys नहीं बढ़तीं। Bybit हर प्लेटफ़ॉर्म, हर अकाउंट के लिए एक ही key जारी करता है, इसलिए दोबारा कनेक्ट करने पर मौजूदा key अपडेट होती है, डुप्लिकेट नहीं बनता।
- IP whitelisting की ज़रूरत नहीं। Bybit key को Freya के servers से खुद बाँधता है। इसीलिए यह key उस तरह expire नहीं होती जैसे manually बनाई गई key हो सकती है।
API Key क्या है, और Freya को कौन सी Permissions चाहिए
API key credentials की एक जोड़ी है (एक key और एक secret) जो किसी ऐप को आपके exchange अकाउंट से सीमित तरीके से बात करने देती है। आप तय करते हैं कि उस key को क्या करने की अनुमति है। Freya के लिए, सिर्फ़ ये enable करें:
- Reading: ताकि Freya आपके balances, positions, और order status देख सके।
- Spot trading और/या Futures trading: ताकि आपका bot ज़रूरी orders लगा सके। जो भी आपके बॉट्स से match करता हो, वह enable करें।
Freya trades लगाता है; उसे कभी आपके अकाउंट से पैसे बाहर निकालने की ज़रूरत नहीं होती। जो key आप कनेक्ट करते हैं उस पर withdrawal permission हमेशा बंद रखें। यह एक ऐसी permission है जो आप exchange पर कंट्रोल करते हैं। इसके बंद रहने पर न Freya, न कोई और जो key हासिल कर ले, आपके फंड निकाल सकता है। किसी भी bot प्लेटफ़ॉर्म को जोड़ते समय यह सबसे ज़रूरी आदत है।
स्टेप 1: अपने Exchange पर API Key बनाएँ
अपने exchange के API management सेक्शन में एक नई API key बनाएँ:
- Binance: API Management में key बनाएँ, reading और Spot और/या Futures trading enable करें, और withdrawals बंद रखें।
- OKX: key बनाएँ और एक passphrase सेट करें (Freya में इसकी ज़रूरत होगी); reading और trading enable करें, withdrawals नहीं।
- Bybit: आप जो products इस्तेमाल करेंगे उनके लिए read और trade permissions के साथ key बनाएँ, और withdrawals बंद रखें।
अगर आपका exchange IP whitelisting की सुविधा देता है, तो key को Freya के IP addresses तक सीमित रखना एक अच्छी प्रैक्टिस है। अगर आप ऐसा करते हैं, तो Freya के IPs ज़रूर whitelist करें, नहीं तो connection refuse हो जाएगा (नीचे errors टेबल देखें)।
जब आप key बनाते हैं, तो exchange secret सिर्फ़ एक बार दिखाता है। उसे तुरंत कॉपी कर लें और सुरक्षित रखें। अगर आप इसे खो दें, तो इसे वापस पाना संभव नहीं है। आपको key डिलीट करके नई बनानी होगी।
स्टेप 2: Freya में Key जोड़ें
Freya में, Settings → API Keys पर जाएँ और Add API Key चुनें। फिर:
- अपना exchange चुनें (Binance, OKX, या Bybit)।
- API key और secret पेस्ट करें। OKX के लिए, आपने जो passphrase सेट किया था वह भी दर्ज करें।
- Key को एक नाम दें ताकि बाद में आप इसे पहचान सकें।
आप एक से ज़्यादा exchange कनेक्ट कर सकते हैं, और इसी पेज से कभी भी अपनी keys manage या delete कर सकते हैं।
स्टेप 3: Freya आपकी Key को Validate करता है
जैसे ही आप key जोड़ते हैं, Freya connection और permissions की जाँच करता है। कोई अनुमान लगाने की ज़रूरत नहीं। अगर सब सही है, तो key verified हो जाती है और इस्तेमाल के लिए तैयार होती है। अगर कुछ गलत है, तो Freya एक स्पष्ट संदेश दिखाता है जो बिल्कुल सटीक बताता है कि क्या ठीक करना है।
Validation Errors को समझें
अगर validation फ़ेल हो जाए, तो Freya जो message दिखाता है उसे नीचे दिए गए fix से मिलाएँ:
| Freya क्या दिखाता है | इसका मतलब क्या है | कैसे ठीक करें |
|---|---|---|
| Invalid API Key | Key गलत तरीके से कॉपी हुई या exchange पर डिलीट हो गई | API key सही से दोबारा कॉपी करें, या नई बनाएँ |
| Invalid Secret Key | Secret, key से match नहीं करता | Secret दोबारा कॉपी करें; अगर खो गया है तो नई key बनाएँ |
| IP Address Not Whitelisted | Key IP-restricted है और Freya का address allow नहीं है | Key पर Freya के IPs whitelist करें, या IP restriction हटा दें |
| Missing Permissions | Key में reading या trading permission नहीं है | Key पर reading और Spot/Futures trading enable करें |
| Reading Permission Disabled | Freya आपका अकाउंट पढ़ नहीं सकता | Key पर read/view permission enable करें |
| Spot/Futures Permission Disabled | Key आपके bot के लिए ज़रूरी orders नहीं लगा सकती | अपने bot से match करने वाला trading type (Spot या Futures) enable करें |
| Connection Failed | अस्थायी network या exchange समस्या | कुछ देर रुकें और key दोबारा जोड़ने की कोशिश करें |
Freya ऐसी key को भी flag करता है जो "Unrestricted" mode में हो, यानी जिस पर कोई IP restriction नहीं है। आपकी सुरक्षा के लिए, Freya आपसे कहता है कि IP restriction चालू करें और जो address दिखाया गया है उसे जोड़ें, उसके बाद ही key save होगी। सिर्फ़ reading और trading enable करें (कभी withdrawal नहीं), और key को Freya के IP तक सीमित रखें। (Connection errors के बारे में और जानें: Exchange कनेक्ट नहीं हो रहा?)
आपकी Keys कैसे सुरक्षित रहती हैं
चाहे आप किसी भी तरीके से कनेक्ट करें, Freya तक पहुँचने के बाद credential को एक ही तरह से संभाला जाता है।
- Store होने से पहले encrypt होती है। आपकी key और secret आते ही encrypt हो जाते हैं। उन्हें कभी readable फ़ॉर्म में save नहीं किया जाता।
- आपको कभी वापस नहीं दिखाई जाती। एक बार save होने के बाद, Freya की कोई भी स्क्रीन आपका secret दोबारा नहीं दिखा सकती: न आपको, न support को। अगर आप इसे खो दें, तो key replace करनी होगी, recover करना संभव नहीं है।
- Withdrawal कभी इसका हिस्सा नहीं है। Freya withdrawal permission नहीं माँगता और इसे इस्तेमाल नहीं कर सकता। आपके फंड सिर्फ़ आपके अपने हाथों से, आपके अपने exchange अकाउंट से ही move हो सकते हैं।
- Delete करना तुरंत होता है। Freya में key हटाएँ और stored credential भी उसी के साथ चला जाता है। Exchange पर key रिवोक करने से भी उस तरफ़ से एक्सेस बंद हो जाता है। दोनों में से कोई भी एक काफ़ी है।
Fast Connection में सुरक्षा एक कदम पहले से शुरू हो जाती है: credential Bybit बनाता है और सीधे Freya के servers को भेजता है। यह कभी आपके browser, clipboard, या screenshot से होकर नहीं गुज़रता, जिससे keys लीक होने का सबसे आम तरीका ही खत्म हो जाता है।
कुछ आदतें आपकी तरफ़ से भी connection को सुरक्षित रखती हैं:
- Withdrawal हमेशा बंद: Freya को इसकी कभी ज़रूरत नहीं।
- IP whitelisting इस्तेमाल करें जब key manually बनाएँ। (Fast Connection यह खुद करता है।)
- एक key, एक काम: जो keys इस्तेमाल नहीं हो रहीं उन्हें delete कर दें।
आपके फंड और keys कैसे सुरक्षित रहते हैं, इसकी पूरी जानकारी के लिए देखें: क्या Freya Finance पर मेरा पैसा सुरक्षित है? और Exchange API Security और Risk Mitigation।
अक्सर पूछे जाने वाले सवाल
Fast Connection क्या है, और क्या यह सुरक्षित है?
Fast Connection आपको Bybit की अपनी साइट पर Freya को approve करने देता है, बजाय इसके कि आप हाथ से API key बनाएँ। यह इसलिए उपलब्ध है क्योंकि Freya एक registered Bybit broker है। यह manual तरीके जितना ही सुरक्षित है, बल्कि कुछ मायनों में ज़्यादा: credential Bybit generate करता है और सीधे Freya के servers को भेजता है, इसलिए यह कभी आपके browser या clipboard से होकर नहीं गुज़रता। आप इसे Bybit की स्क्रीन पर approve करते हैं, और वहीं से मना भी कर सकते हैं, कुछ भी बनाए बिना।
क्या Fast Connection के साथ भी मुझे IP whitelist करना होगा?
नहीं। Bybit key जारी करते समय उसे Freya के servers से खुद बाँध देता है। इसीलिए इस तरह बनाई गई key उस तरह expire नहीं होती जैसे manually बनाई गई key हो सकती है।
क्या मैं Fast Connection को Spot और Futures दोनों के लिए इस्तेमाल कर सकता हूँ?
हाँ। एक ही approval दोनों सेट अप कर देता है। हर market के लिए अलग से प्रक्रिया दोहराने की ज़रूरत नहीं।
अगर मैं Bybit से दूसरी बार कनेक्ट करूँ तो क्या होगा?
कुछ भी नहीं टूटता और कोई duplicate नहीं बनता। Bybit हर प्लेटफ़ॉर्म, हर अकाउंट के लिए एक ही key जारी करता है, इसलिए दूसरी बार कनेक्ट करने पर मौजूदा key refresh हो जाती है। यह उसी Bybit खाते के लिए है। दूसरा Bybit खाता कनेक्ट करने के लिए पहले मौजूदा Bybit Spot और Bybit Futures keys हटाएँ, फिर दोबारा कनेक्ट करें।
Freya को मेरी API key पर कौन सी permissions चाहिए?
Reading (ताकि आपके balances, positions, और orders देखे जा सकें) और Spot और/या Futures trading (ताकि आपके bot के orders लगाए जा सकें)। जो trading type आपके बॉट्स से match करता हो वह enable करें। Freya को withdrawal permission की कभी ज़रूरत नहीं होती, इसलिए इसे हमेशा बंद रखें।
क्या Freya को मेरे फंड निकालने की permission चाहिए?
नहीं। Freya सिर्फ़ trades लगाता और manage करता है; यह आपके exchange से फंड बाहर भेजने में सक्षम नहीं है और होना भी नहीं चाहिए। जो key आप कनेक्ट करते हैं उस पर withdrawal permission हमेशा बंद रखें। यह एक ऐसी permission है जो आप exchange पर कंट्रोल करते हैं।
Freya "IP Address Not Whitelisted" क्यों कह रहा है?
आपकी API key विशिष्ट IP addresses तक सीमित है, और Freya का address उस list में नहीं है। या तो अपने exchange पर key की whitelist में Freya के IP addresses जोड़ें, या key से IP restriction हटा दें। अपडेट करने के बाद, Freya में key दोबारा जोड़ें।
"Invalid API Key" या "Invalid Secret Key" क्यों दिख रहा है?
आमतौर पर key या secret गलत तरीके से कॉपी हुई होती है, या key exchange पर delete या regenerate हो चुकी होती है। दोनों values बिल्कुल सही से दोबारा कॉपी करें। चूँकि secret key बनाते समय सिर्फ़ एक बार दिखता है, अगर अब आपके पास नहीं है, तो exchange पर key delete करें और नई बनाएँ।
Passphrase क्या है, और OKX इसे क्यों माँगता है?
OKX API keys में एक passphrase शामिल होता है जो आप key बनाते समय खुद सेट करते हैं। यह key और secret के साथ एक अतिरिक्त credential है। OKX key जोड़ते समय Freya में वही passphrase दर्ज करें। Binance और Bybit passphrase इस्तेमाल नहीं करते।
क्या मैं एक से ज़्यादा exchange कनेक्ट कर सकता हूँ?
हाँ। आप Binance, OKX, और Bybit के लिए API keys जोड़ सकते हैं, और Settings → API Keys से कभी भी उन्हें manage या delete कर सकते हैं।
क्या Freya को अपनी API key देना सुरक्षित है?
हाँ, जब key सही तरीके से सेट अप की गई हो: सिर्फ़ reading और trading, कोई withdrawal नहीं, और जहाँ संभव हो IP-whitelisted। आपके फंड आपके अपने exchange पर रहते हैं, और जो key आप शेयर करते हैं वह उन्हें move नहीं कर सकती। पूरी जानकारी के लिए देखें: क्या Freya Finance पर मेरा पैसा सुरक्षित है?
Freya कौन से exchanges सपोर्ट करता है?
Freya फ़िलहाल Binance, OKX, और Bybit (spot और futures) से कनेक्ट होता है। समय के साथ और exchanges जोड़े जा सकते हैं। आप इनमें से जो भी कनेक्ट करते हैं उसी पर trade करते हैं। आपके फंड और उपलब्ध markets उसी exchange पर रहते हैं।
कौन से coins या trading pairs पर trade कर सकता हूँ?
उपलब्ध pairs आपके कनेक्टेड exchange की अपनी listings से आते हैं, Freya की किसी अलग list से नहीं। अगर आपका exchange कोई pair list करता है (जैसे BTC/USDT, ETH/USDT), तो आप उस पर bot बना सकते हैं। ज़्यादातर trading USDT को quote currency के रूप में इस्तेमाल करके होती है। अगर कोई exchange किसी pair को delist कर दे, तो वह वहाँ tradable नहीं रहता।