ट्रेडिंग बॉट के लिए API और AI के लिए MCP
Binance USD-M Futures के लिए लिखा गया बॉट BuyCrypt के डेमो अकाउंट पर बिना दोबारा लिखे चलता है: बदलता है सिर्फ़ API का पता। और Claude, ChatGPT और Cursor BuyCrypt के MCP सर्वर के ज़रिए टूर्नामेंट, ट्रेडरों की रेटिंग और आपका डेमो अकाउंट देख सकते हैं।
{ "symbol": "BTCUSDT", "price": "…" }
बॉट ट्रेड करता है। असिस्टेंट सवालों के जवाब देता है।
ट्रेडिंग बॉट के लिए API
रिक्वेस्ट, सिग्नेचर और रिस्पॉन्स का फ़ॉर्मेट Binance USD-M Futures जैसा है। बॉट आपके BuyCrypt डेमो अकाउंट पर ऑर्डर लगाता है: कीमतें बाज़ार की, पैसा डेमो।
- वही लाइब्रेरी: binance-futures-connector, requests पर आपका अपना कोड
- REST, listenKey से प्राइवेट WebSocket, स्ट्रीम में कैंडल और मार्क प्राइस
- Key ऐप में बनती है और सिर्फ़ एक डेमो अकाउंट के साथ काम करती है
AI असिस्टेंट के लिए MCP
Claude, ChatGPT या Cursor की सेटिंग में एक पता, और जब आप पूछते हैं, असिस्टेंट ख़ुद BuyCrypt का डेटा ले लेता है।
- टूर्नामेंट, इनाम, प्रतिभागियों की तालिका, कॉइन के हिसाब से लीडर
- ट्रेडर पासपोर्ट: 1000 में से रेटिंग, स्तर, ट्रेडिंग स्टाइल
- आपका डेमो अकाउंट: बैलेंस, पोज़िशन, ऑर्डर (रीड-ओनली कुंजी से)
MCP: BuyCrypt को Claude, ChatGPT और Cursor से जोड़ें
MCP एक खुला स्टैंडर्ड है, जिससे AI असिस्टेंट बाहरी डेटा और टूल जोड़ते हैं। BuyCrypt का सर्वर असिस्टेंट को प्लेटफ़ॉर्म का लाइव डेटा देता है। रजिस्ट्रेशन और key की ज़रूरत नहीं, key सिर्फ़ आपके डेमो अकाउंट के लिए चाहिए।
https://buycrypt.com/mcp
- claude.ai या Claude Desktop ऐप खोलें → Customize → Connectors।
- + Add → Add custom connector दबाएँ।
- नाम — BuyCrypt, पता — https://buycrypt.com/mcp, फिर Continue।
- Authentication सेक्शन में No sign in चुनें और Add दबाएँ।
अपने कनेक्टर Claude के सभी प्लान में उपलब्ध हैं, मुफ़्त प्लान में — एक। Team और Enterprise टीमों में कनेक्टर संगठन का मालिक Organization settings → Connectors में जोड़ता है। अपने डेमो अकाउंट के लिए इसी विंडो के Request headers ब्लॉक में key जोड़ें — यह कैसे करें।
- टर्मिनल में एक कमांड चलाएँ:
claude mcp add --transport http buycrypt https://buycrypt.com/mcp
जाँच: claude mcp list — सूची में buycrypt दिखेगा। सर्वर को सभी प्रोजेक्ट में उपलब्ध कराने के लिए --scope user जोड़ें।
- ब्राउज़र में chatgpt.com/plugins खोलें।
- + → Add custom MCP server दबाएँ।
- नाम — BuyCrypt, Connection सेक्शन में सार्वजनिक पता चुनें और https://buycrypt.com/mcp डालें।
- Authentication — No authentication। चेतावनी I understand and want to continue की पुष्टि करें और Create दबाएँ।
ChatGPT में अपने MCP सर्वर सिर्फ़ वेब वर्ज़न में जोड़े जाते हैं और सभी प्लान में उपलब्ध नहीं हैं। अगर यह विकल्प नहीं दिखता, तो उसे आपके प्लान या वर्कस्पेस एडमिन ने बंद किया है। ChatGPT में अपना डेमो अकाउंट नहीं जोड़ा जा सकता: वह सर्वर को keys नहीं भेजता। इसके लिए Claude, Claude Code और Cursor ठीक रहेंगे।
बटन तैयार सेटिंग के साथ Cursor खोलेगा। या हाथ से: ~/.cursor/mcp.json (सभी प्रोजेक्ट के लिए) या प्रोजेक्ट के रूट में .cursor/mcp.json में जोड़ें:
{
"mcpServers": {
"buycrypt": {
"url": "https://buycrypt.com/mcp"
}
}
}Streamable HTTP सपोर्ट करने वाला कोई भी क्लाइंट चलेगा: पता https://buycrypt.com/mcp डालें, ऑथराइज़ेशन की ज़रूरत नहीं। अगर क्लाइंट सिर्फ़ लोकल सर्वर (stdio) चला सकता है, तो mcp-remote ब्रिज से जोड़ें, Node.js चाहिए:
{
"mcpServers": {
"buycrypt": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://buycrypt.com/mcp"]
}
}
}असिस्टेंट के बिना सर्वर जाँचें: npx @modelcontextprotocol/inspector --cli https://buycrypt.com/mcp --transport http --method tools/list
सर्वर क्या कर सकता है
platform_overviewअभी कौन-से टूर्नामेंट चल रहे हैं, अगला कौन-सा शुरू होगा, टूर्नामेंट में कितने ट्रेडर हैं, हाल के इनाम।
बिना keylist_tournamentsचल रहे, आने वाले और ख़त्म हो चुके टूर्नामेंट: कॉइन, स्कोरिंग का तरीक़ा, प्राइज़ पूल, एंट्री, प्रतिभागी।
बिना keyget_tournamentएक टूर्नामेंट: स्थानों के हिसाब से इनाम और नतीजों के साथ प्रतिभागियों की तालिका।
बिना keyleaderboard7, 30 या 90 दिनों में कॉइन के लीडर — “Top Traders” पेज की तरह।
बिना keytrader_profileनिकनेम से ट्रेडर पासपोर्ट: 1000 में से रेटिंग, स्तर, आकलन के पाँच हिस्से, स्टाइल। सिर्फ़ सार्वजनिक प्रोफ़ाइल।
बिना keymarket_tickerपरपेचुअल कॉन्ट्रैक्ट की कीमत और 24 घंटे का बदलाव, जैसे BTCUSDT।
बिना keydemo_accountआपके डेमो अकाउंट का बैलेंस, मार्जिन और खुली पोज़िशन।
आपकी keydemo_open_ordersआपके डेमो अकाउंट के खुले ऑर्डर।
आपकी keydemo_recent_resultsडेमो अकाउंट के हाल के नतीजे: बंद ट्रेड का प्रॉफ़िट और नुकसान, फ़ीस।
आपकी keyकोई भी टूल न ऑर्डर लगाता है, न टूर्नामेंट में शामिल होता है, न पैसा ट्रांसफ़र करता है — सर्वर सिर्फ़ पढ़ता है।
असिस्टेंट से क्या पूछें
सवाल कॉपी करने के लिए उस पर टैप करें।
असिस्टेंट को BuyCrypt ऐसा दिखता है
नीचे सर्वर https://buycrypt.com/mcp का अभी का असली जवाब है। असिस्टेंट यही डेटा पाता है और उसे अपने शब्दों में बताता है।
असिस्टेंट में आपका डेमो अकाउंट
demo_account, demo_open_orders और demo_recent_results टूल आपका डेमो अकाउंट पढ़ते हैं। इनके लिए क्लाइंट आपकी API कुंजी सर्वर को दो हेडर में भेजता है: X-BuyCrypt-Api-Key और X-BuyCrypt-Api-Secret। असिस्टेंट के लिए रीड-ओनली कुंजी बनाएँ: वह बैलेंस, पोज़िशन और ऑर्डर देखती है, लेकिन उससे BuyCrypt न ऑर्डर लगाएगा, न रद्द करेगा, न लीवरेज बदलेगा (जवाब 403)। कुंजी कैसे पाएँ।
claude mcp add --transport http buycrypt https://buycrypt.com/mcp \ --header "X-BuyCrypt-Api-Key: YOUR_API_KEY" \ --header "X-BuyCrypt-Api-Secret: YOUR_API_SECRET"
{
"mcpServers": {
"buycrypt": {
"url": "https://buycrypt.com/mcp",
"headers": {
"X-BuyCrypt-Api-Key": "YOUR_API_KEY",
"X-BuyCrypt-Api-Secret": "YOUR_API_SECRET"
}
}
}
}- कनेक्टर जोड़ते समय (Customize → Connectors → Add custom connector) पते के बाद No sign in चुनें।
- Request headers ब्लॉक में दो हेडर जोड़ें: X-BuyCrypt-Api-Key और X-BuyCrypt-Api-Secret, अपनी वैल्यू के साथ।
- Add दबाएँ। अगर कनेक्टर पहले ही बिना key के जोड़ा जा चुका है, तो उसे हटाएँ और हेडर के साथ फिर से जोड़ें।
सिर्फ़ पढ़ना
MCP सर्वर ऑर्डर न लगाता है, न रद्द करता है। उसे कुंजी सिर्फ़ बैलेंस, पोज़िशन और ऑर्डर पढ़ने के लिए चाहिए। रीड-ओनली कुंजी किसी और के हाथ लग जाए, तब भी उससे ट्रेड नहीं किया जा सकता।
एक डेमो अकाउंट
BuyCrypt key सिर्फ़ उसी डेमो अकाउंट के साथ काम करती है, जिसके लिए बनाई गई है। असली एक्सचेंज अकाउंट तक वह पहुँच नहीं देती।
अलग key
असिस्टेंट के लिए अलग रीड-ओनली कुंजी बनाएँ। कुंजी सिर्फ़ buycrypt.com पर जाती है, सर्वर उसे न सेव करता है, न लॉग में लिखता है। आप उसे वहीं वापस ले सकते हैं जहाँ बनाया था।
Binance USD-M Futures के अनुकूल API
पाथ, HMAC-SHA256 सिग्नेचर, पैरामीटर और रिस्पॉन्स फ़ॉर्मेट — Binance USD-M Futures जैसे। फ़र्क़ एक है: ऑर्डर आपके BuyCrypt डेमो अकाउंट पर बाज़ार की कीमतों पर एक्ज़िक्यूट होते हैं, असली एक्सचेंज पर नहीं जाते। इस तरह रणनीति को बाज़ार पर बिना पैसे का जोखिम उठाए परखा जा सकता है।
कैसे शुरू करें
- अकाउंट। Google या Apple से वेब टर्मिनल या BuyCrypt ऐप में लॉग इन करें। डेमो अकाउंट तुरंत बन जाएगा।
- कुंजी। वेब टर्मिनल या ऐप में: Profile → API keys → आपका डेमो अकाउंट → Bot API keys ब्लॉक → Generate API key। apiKey और apiSecret कॉपी कर लें: सीक्रेट सिर्फ़ एक बार दिखता है। AI असिस्टेंट या मॉनिटरिंग के लिए वेब टर्मिनल में Generate read-only key (for MCP) बटन है।
- पता। अपनी लाइब्रेरी में https://fapi.binance.com की जगह https://api.buycrypt.com डालें। /fapi/v1/… पाथ वही रहते हैं।
- जाँच। बैलेंस माँगें — GET /fapi/v2/balance: जवाब में आपके डेमो अकाउंट के USDT होंगे।
क्या जानना ज़रूरी है
- सिर्फ़ USDT कॉन्ट्रैक्ट और एक पोज़िशन वाला मोड (one-way); हेज मोड सपोर्ट नहीं है।
- टिकर की कीमत — /fapi/v1/ticker/price। /fapi/v2/ticker/price पाथ, जिसे लाइब्रेरी के नए वर्ज़न कॉल करते हैं, अभी सपोर्ट नहीं है।
- सार्वजनिक स्ट्रीम में @kline_1m कैंडल (हर 5 सेकंड) और @markPrice (हर सेकंड) आते हैं।
- recvWindow — डिफ़ॉल्ट 5,000 ms, अधिकतम 60,000 ms। घड़ी /fapi/v1/time से मिलाएँ।
- जिस अकाउंट के पास ट्रेडिंग API कुंजी है, उसे ऐप की रेटिंग में 🤖 बैज मिलता है: सबको दिखता है कि ट्रेड प्रोग्राम कर रहा है।
- कुंजी के अधिकार: सामान्य कुंजी (READ_TRADE) पढ़ती भी है और ट्रेड भी करती है, रीड-ओनली कुंजी (READ) से सिर्फ़ GET अनुरोध और listenKey चलते हैं। उससे ऑर्डर, रद्द करने, लीवरेज या मार्जिन का अनुरोध करने पर HTTP 403 और कोड -2015 मिलता है।
import os from binance.um_futures import UMFutures client = UMFutures( key=os.environ["BUYCRYPT_API_KEY"], # BuyCrypt ऐप से मिली key secret=os.environ["BUYCRYPT_API_SECRET"], base_url="https://api.buycrypt.com", # बदलने वाली इकलौती लाइन ) print(client.balance()) # डेमो अकाउंट के USDT client.change_leverage(symbol="BTCUSDT", leverage=5) order = client.new_order(symbol="BTCUSDT", side="BUY", type="MARKET", quantity=0.002) print(order["orderId"], order["status"]) print(client.get_position_risk(symbol="BTCUSDT"))
import hashlib, hmac, os, time, urllib.parse, requests API = "https://api.buycrypt.com" KEY = os.environ["BUYCRYPT_API_KEY"] SECRET = os.environ["BUYCRYPT_API_SECRET"] def signed(method, path, **params): params["timestamp"] = int(time.time() * 1000) query = urllib.parse.urlencode(params) sig = hmac.new(SECRET.encode(), query.encode(), hashlib.sha256).hexdigest() r = requests.request(method, f"{API}{path}?{query}&signature={sig}", headers={"X-MBX-APIKEY": KEY}, timeout=10) r.raise_for_status() return r.json() print(signed("GET", "/fapi/v2/balance")) print(signed("POST", "/fapi/v1/order", symbol="BTCUSDT", side="BUY", type="LIMIT", timeInForce="GTC", quantity=0.002, price=60000))
# सार्वजनिक डेटा — बिना key curl "https://api.buycrypt.com/fapi/v1/ticker/price?symbol=BTCUSDT" curl "https://api.buycrypt.com/fapi/v1/klines?symbol=ETHUSDT&interval=1h&limit=3" # डेमो अकाउंट का बैलेंस — साइन की हुई रिक्वेस्ट KEY="YOUR_API_KEY"; SECRET="YOUR_API_SECRET" Q="timestamp=$(date +%s)000" SIG=$(printf '%s' "$Q" | openssl dgst -sha256 -hmac "$SECRET" | sed 's/^.* //') curl -H "X-MBX-APIKEY: $KEY" "https://api.buycrypt.com/fapi/v2/balance?$Q&signature=$SIG"
मेथड
REST का बेस पता — https://api.buycrypt.com। साइन किए गए मेथड के लिए X-MBX-APIKEY हेडर, timestamp और signature ज़रूरी हैं।
मार्केट डेटा बिना key
अकाउंट और पोज़िशन साइन किए गए
ट्रेडिंग साइन किए गए
WebSocket स्ट्रीम
लिमिट और एरर
आपके बॉट के सब्सक्राइबर (बीटा)
बॉट को सार्वजनिक के रूप में रजिस्टर किया जा सकता है: यूज़र ऐप में “कनेक्ट” दबाता है, BuyCrypt उसके लिए 1,000 डेमो USDT वाला अलग डेमो अकाउंट खोलता है और सिर्फ़ उसी अकाउंट की key जारी करता है। Key आपके वेबहुक पर subscription.created इवेंट के साथ जाती है, और बॉट सब्सक्राइबर के डेमो अकाउंट पर ट्रेड करता है। जब यूज़र डिस्कनेक्ट करता है, पोज़िशन बंद हो जाती हैं, key काम करना बंद कर देती है, और आपको subscription.disconnected मिलता है।
बॉट को यूज़र्स के असली अकाउंट और एक्सचेंज keys नहीं दी जातीं — सिर्फ़ अलग डेमो अकाउंट की key।
रजिस्ट्रेशन — साइन किया हुआ POST /fapi/v1/bot/profiles, पैरामीटर slug, displayName, webhookUrl (सिर्फ़ HTTPS) और webhookSecret (32 अक्षरों से) के साथ; जाँच तक बॉट का स्टेटस PENDING_REVIEW रहता है। हर इवेंट साइन किया होता है: हेडर X-BuyCrypt-Signature = HMAC-SHA256(webhookSecret, timestamp + "." + body), समय — X-BuyCrypt-Timestamp में। डिलीवरी 6 बार तक दोहराई जाती है (तुरंत, 10 सेकंड, 30 सेकंड, 2 मिनट, 10 मिनट, 1 घंटे बाद); लगातार 10 असफल डिलीवरी के बाद वेबहुक बंद हो जाता है — उसे फिर चालू करने में सपोर्ट मदद करेगा।
import hashlib, hmac, os, time WEBHOOK_SECRET = os.environ["BUYCRYPT_WEBHOOK_SECRET"] def verify(headers, raw_body: bytes) -> bool: ts = int(headers["X-BuyCrypt-Timestamp"]) if abs(time.time() * 1000 - ts) > 5 * 60 * 1000: # 5 मिनट से पुराना — अस्वीकार करें return False expected = hmac.new(WEBHOOK_SECRET.encode(), f"{ts}.".encode() + raw_body, hashlib.sha256).hexdigest() return hmac.compare_digest(expected, headers["X-BuyCrypt-Signature"])
BuyCrypt key सिर्फ़ डेमो अकाउंट खोलती है
एक अकाउंट से बंधी
API कुंजी किसी एक डेमो अकाउंट के लिए बनती है और सिर्फ़ उसी के साथ काम करती है। एक्सचेंज के असली अकाउंट इस API से उपलब्ध नहीं हैं। रीड-ओनली कुंजी इस अकाउंट पर भी ट्रेड नहीं करती।
Secret सिर्फ़ एक बार दिखता है
Key और secret को एनवायरनमेंट वेरिएबल या सीक्रेट मैनेजर में रखें, कोड या सार्वजनिक रिपॉज़िटरी में नहीं।
एक सेकंड में रद्द
वेब टर्मिनल या ऐप में, उसी "Bot API keys" ब्लॉक में "Revoke" दबाएँ: इस कुंजी वाले सभी अनुरोधों को तुरंत 401 त्रुटि मिलेगी।
अक्सर पूछे जाने वाले सवाल
क्या बॉट असली पैसे से ट्रेड करता है?
नहीं। BuyCrypt API ऑर्डर आपके डेमो अकाउंट पर एक्ज़िक्यूट करता है: कीमतें बाज़ार की, बैलेंस डेमो USDT में। ऑर्डर एक्सचेंज पर नहीं भेजे जाते, इसलिए रणनीति बिना जोखिम परखी जा सकती है।
क्या BuyCrypt के लिए बॉट दोबारा लिखना पड़ेगा?
आम तौर पर नहीं। अगर बॉट Binance USD-M Futures के साथ काम करता है, तो बेस पता https://api.buycrypt.com कर दें और BuyCrypt key डालें। पाथ, सिग्नेचर और रिस्पॉन्स फ़ॉर्मेट वही हैं। जाँच लें कि बॉट हेज मोड और /fapi/v2/ticker/price पाथ इस्तेमाल न करता हो।
API key कहाँ से लें?
BuyCrypt के वेब टर्मिनल या ऐप में: Profile → API keys → आपका डेमो अकाउंट → Bot API keys → Generate API key। MCP और AI असिस्टेंट के लिए वेब टर्मिनल में "Generate read-only key (for MCP)" चुनें: ऐसी कुंजी अकाउंट देखती है, पर ट्रेड नहीं करती। सीक्रेट सिर्फ़ एक बार दिखता है, उसे तुरंत सेव कर लें। कुंजी वहीं वापस भी ली जा सकती है।
MCP क्या है और यह किस काम का है?
MCP (Model Context Protocol) एक खुला स्टैंडर्ड है, जिससे AI असिस्टेंट बाहरी डेटा जोड़ते हैं। https://buycrypt.com/mcp सर्वर जोड़ने के बाद आप Claude, ChatGPT या Cursor से टूर्नामेंट, लीडरों और ट्रेडर पासपोर्ट के बारे में पूछ सकते हैं, और असिस्टेंट BuyCrypt के लाइव डेटा से जवाब देगा।
क्या MCP जोड़ने के लिए रजिस्ट्रेशन ज़रूरी है?
नहीं। टूर्नामेंट, रेटिंग, ट्रेडर पासपोर्ट और कीमतें बिना कुंजी के उपलब्ध हैं। कुंजी सिर्फ़ उन तीन टूल के लिए चाहिए जो आपका डेमो अकाउंट पढ़ते हैं, और उनके लिए रीड-ओनली कुंजी काफ़ी है।
क्या AI असिस्टेंट MCP के ज़रिए ट्रेड कर सकता है?
नहीं। सर्वर के सभी नौ टूल सिर्फ़ डेटा पढ़ते हैं: ऑर्डर न लगाए जाते हैं, न रद्द होते हैं, कोई टूर्नामेंट में शामिल नहीं होता, पैसा ट्रांसफ़र नहीं होता।
क्या बॉट डेवलपर को मेरी एक्सचेंज keys मिलेंगी?
नहीं। जब आप किसी और का बॉट जोड़ते हैं, BuyCrypt उसके लिए अलग डेमो अकाउंट खोलता है और सिर्फ़ उसी की key देता है। आपके असली अकाउंट और एक्सचेंज keys बॉट को नहीं दी जातीं। डेटा सुरक्षा के बारे में और जानकारी “सुरक्षा” पेज पर है।
डेमो अकाउंट से शुरू करें
BuyCrypt अकाउंट मुफ़्त है: बॉट के लिए डेमो अकाउंट, ऐप में API key, टूर्नामेंट और रेटिंग, जहाँ दिखता है कि रणनीति कितने पानी में है।