ٹریڈنگ بوٹس کے لیے 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، اسٹریم میں کینڈلز اور مارک پرائس
- کلید ایپ میں بنتی ہے اور صرف ایک ڈیمو اکاؤنٹ کے ساتھ کام کرتی ہے
AI اسسٹنٹس کے لیے MCP
Claude، ChatGPT یا Cursor کی سیٹنگز میں ایک ایڈریس، اور جب آپ پوچھیں تو اسسٹنٹ خود BuyCrypt کا ڈیٹا لے لیتا ہے۔
- ٹورنامنٹس، انعامات، شرکاء کی ٹیبل، کوائنز کے لحاظ سے لیڈرز
- ٹریڈر پاسپورٹ: 1000 میں سے ریٹنگ، سطح، ٹریڈنگ کا انداز
- آپ کا ڈیمو اکاؤنٹ: بیلنس، پوزیشنز، آرڈرز (ریڈ اونلی کلید کے ذریعے)
MCP: BuyCrypt کو Claude، ChatGPT اور Cursor سے جوڑیں
MCP ایک کھلا معیار ہے جس کے ذریعے AI اسسٹنٹس بیرونی ڈیٹا اور ٹولز جوڑتے ہیں۔ BuyCrypt سرور اسسٹنٹ کو پلیٹ فارم کا لائیو ڈیٹا دیتا ہے۔ رجسٹریشن اور کلید کی ضرورت نہیں، کلید صرف آپ کے ڈیمو اکاؤنٹ کے لیے درکار ہوگی۔
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 حصے میں کلید شامل کریں — یہ کیسے کریں۔
- ٹرمینل میں ایک کمانڈ چلائیں:
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 میں اپنا ڈیمو اکاؤنٹ نہیں جوڑا جا سکتا: یہ سرور کو کلیدیں نہیں بھیجتا۔ اس کے لیے 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اس وقت کون سے ٹورنامنٹس جاری ہیں، اگلا کون سا شروع ہوگا، ٹورنامنٹس میں کتنے ٹریڈرز ہیں، تازہ انعامات۔
کلید کے بغیرlist_tournamentsجاری، قریبی اور مکمل شدہ ٹورنامنٹس: کوائن، اسکورنگ کا طریقہ، انعامی پول، داخلہ، شرکاء۔
کلید کے بغیرget_tournamentایک ٹورنامنٹ: پوزیشنوں کے لحاظ سے انعامات اور نتائج کے ساتھ شرکاء کی ٹیبل۔
کلید کے بغیرleaderboard7، 30 یا 90 دنوں میں کوائن کے لحاظ سے لیڈرز — «ٹاپ ٹریڈرز» صفحے کی طرح۔
کلید کے بغیرtrader_profileنِک نیم کے ذریعے ٹریڈر پاسپورٹ: 1000 میں سے ریٹنگ، سطح، جانچ کے پانچ اجزاء، انداز۔ صرف عوامی پروفائلز۔
کلید کے بغیرmarket_tickerپرپیچوئل کنٹریکٹ پر قیمت اور 24 گھنٹوں کی تبدیلی، مثلاً BTCUSDT۔
کلید کے بغیرdemo_accountآپ کے ڈیمو اکاؤنٹ کا بیلنس، مارجن اور کھلی پوزیشنیں۔
آپ کی کلیدdemo_open_ordersآپ کے ڈیمو اکاؤنٹ کے کھلے آرڈرز۔
آپ کی کلیدdemo_recent_resultsڈیمو اکاؤنٹ کے تازہ نتائج: بند ٹریڈز کا منافع اور نقصان، فیس۔
آپ کی کلیدکوئی بھی ٹول نہ آرڈر لگاتا ہے، نہ ٹورنامنٹس میں شامل ہوتا ہے، نہ رقم منتقل کرتا ہے — سرور صرف پڑھتا ہے۔
اسسٹنٹ سے کیا پوچھیں
سوال کاپی کرنے کے لیے اس پر ٹیپ کریں۔
اسسٹنٹ 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 پر ٹیپ کریں۔ اگر کنیکٹر پہلے ہی کلید کے بغیر شامل ہے تو اسے حذف کریں اور ہیڈرز کے ساتھ دوبارہ شامل کریں۔
صرف پڑھنا
MCP سرور نہ آرڈر لگاتا ہے، نہ منسوخ کرتا ہے۔ اسے کلید صرف بیلنس، پوزیشنز اور آرڈرز پڑھنے کے لیے چاہیے۔ ریڈ اونلی کلید کسی اور کے ہاتھ لگ جائے تب بھی اس سے ٹریڈنگ نہیں ہو سکتی۔
ایک ڈیمو اکاؤنٹ
BuyCrypt کلید صرف اسی ڈیمو اکاؤنٹ کے ساتھ کام کرتی ہے جس کے لیے بنائی گئی۔ یہ حقیقی ایکسچینج اکاؤنٹس تک رسائی نہیں دیتی۔
الگ کلید
اسسٹنٹ کے لیے الگ ریڈ اونلی کلید بنائیں۔ کلید صرف buycrypt.com پر جاتی ہے، سرور اسے محفوظ نہیں کرتا اور لاگز میں نہیں لکھتا۔ اسے وہیں منسوخ کیا جا سکتا ہے جہاں بنایا تھا۔
Binance USD-M Futures سے مطابقت رکھنے والا API
راستے، HMAC-SHA256 دستخط، پیرامیٹرز اور جوابات کا فارمیٹ — Binance USD-M Futures جیسا۔ فرق صرف ایک ہے: آرڈرز آپ کے BuyCrypt ڈیمو اکاؤنٹ پر مارکیٹ قیمتوں پر ایگزیکیوٹ ہوتے ہیں، حقیقی ایکسچینج پر نہیں جاتے۔ یوں حکمتِ عملی کو رقم داؤ پر لگائے بغیر مارکیٹ پر جانچا جا سکتا ہے۔
کیسے شروع کریں
- اکاؤنٹ۔ Google یا Apple کے ذریعے ویب ٹرمینل یا BuyCrypt ایپ میں لاگ اِن کریں۔ ڈیمو اکاؤنٹ فوراً بن جائے گا۔
- کلید۔ ویب ٹرمینل یا ایپ میں: پروفائل ← API کلیدیں ← آپ کا ڈیمو اکاؤنٹ ← 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 ایپ سے کلید 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))
# عوامی ڈیٹا — کلید کے بغیر 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 ضروری ہیں۔
مارکیٹ ڈیٹا کلید کے بغیر
اکاؤنٹ اور پوزیشنیں دستخط شدہ
ٹریڈنگ دستخط شدہ
WebSocket اسٹریمز
حدود اور غلطیاں
آپ کے بوٹ کے سبسکرائبرز (بیٹا)
بوٹ کو عوامی کے طور پر رجسٹر کیا جا سکتا ہے: صارف ایپ میں «جوڑیں» پر ٹیپ کرتا ہے، BuyCrypt اس کے لیے 1,000 ڈیمو USDT کے ساتھ الگ ڈیمو اکاؤنٹ کھولتا ہے اور صرف اسی اکاؤنٹ کی کلید جاری کرتا ہے۔ کلید subscription.created ایونٹ کے ساتھ آپ کے ویب ہک پر جاتی ہے، اور بوٹ سبسکرائبر کے ڈیمو اکاؤنٹ پر ٹریڈ کرتا ہے۔ جب صارف منقطع ہوتا ہے تو پوزیشنیں بند ہو جاتی ہیں، کلید کام کرنا چھوڑ دیتی ہے، اور آپ کو subscription.disconnected ملتا ہے۔
بوٹ کو صارفین کے حقیقی اکاؤنٹس اور ایکسچینج کلیدیں نہیں دی جاتیں — صرف الگ ڈیمو اکاؤنٹ کی کلید۔
رجسٹریشن — دستخط شدہ 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 کلید صرف ڈیمو اکاؤنٹ کھولتی ہے
ایک اکاؤنٹ سے منسلک
API کلید کسی مخصوص ڈیمو اکاؤنٹ کے لیے بنتی ہے اور صرف اسی کے ساتھ کام کرتی ہے۔ اس API کے ذریعے ایکسچینجز کے حقیقی اکاؤنٹس تک رسائی نہیں۔ ریڈ اونلی کلید اس اکاؤنٹ پر بھی ٹریڈ نہیں کرتی۔
سیکرٹ ایک بار دکھایا جاتا ہے
کلید اور سیکرٹ کو انوائرنمنٹ ویری ایبلز یا سیکرٹس مینیجر میں رکھیں، کوڈ میں یا عوامی ریپوزیٹریز میں نہیں۔
ایک سیکنڈ میں منسوخی
ویب ٹرمینل یا ایپ میں، اسی “Bot API keys” سیکشن میں “Revoke” دبائیں: اس کلید والی تمام درخواستوں کو فوراً 401 ایرر ملے گا۔
عام سوالات
کیا بوٹ اصلی رقم سے ٹریڈ کرتا ہے؟
نہیں۔ BuyCrypt API آرڈرز آپ کے ڈیمو اکاؤنٹ پر ایگزیکیوٹ کرتا ہے: قیمتیں مارکیٹ کی، بیلنس ڈیمو USDT میں۔ آرڈرز ایکسچینج کو نہیں بھیجے جاتے، اس لیے حکمتِ عملی بغیر خطرے کے جانچی جا سکتی ہے۔
کیا BuyCrypt کے لیے بوٹ دوبارہ لکھنا پڑے گا؟
عموماً نہیں۔ اگر بوٹ Binance USD-M Futures کے ساتھ کام کرتا ہے تو بنیادی ایڈریس https://api.buycrypt.com سے بدلیں اور BuyCrypt کلید لگائیں۔ راستے، دستخط اور جوابات کا فارمیٹ وہی ہیں۔ یقینی بنائیں کہ بوٹ ہیج موڈ اور /fapi/v2/ticker/price راستہ استعمال نہیں کرتا۔
API کلید کہاں سے لیں؟
ویب ٹرمینل یا BuyCrypt ایپ میں: پروفائل ← API کلیدیں ← آپ کا ڈیمو اکاؤنٹ ← 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 کے ذریعے ٹریڈ کر سکتا ہے؟
نہیں۔ سرور کے تمام نو ٹولز صرف ڈیٹا پڑھتے ہیں: نہ آرڈرز لگتے ہیں نہ منسوخ ہوتے ہیں، نہ کوئی ٹورنامنٹ میں شامل ہوتا ہے، نہ رقم منتقل ہوتی ہے۔
کیا بوٹ کے ڈویلپر کو میری ایکسچینج کلیدیں ملیں گی؟
نہیں۔ جب آپ کسی اور کا بوٹ جوڑتے ہیں تو BuyCrypt اس کے لیے الگ ڈیمو اکاؤنٹ کھولتا ہے اور صرف اسی کی کلید دیتا ہے۔ آپ کے حقیقی اکاؤنٹس اور ایکسچینج کلیدیں بوٹ کو نہیں دی جاتیں۔ ڈیٹا کے تحفظ کے بارے میں مزید — «سیکیورٹی» کے صفحے پر۔
ڈیمو اکاؤنٹ سے شروع کریں
BuyCrypt اکاؤنٹ مفت ہے: بوٹ کے لیے ڈیمو اکاؤنٹ، ایپ میں API کلید، ٹورنامنٹس اور ریٹنگ، جہاں نظر آتا ہے کہ حکمتِ عملی میں کتنا دم ہے۔