Сауда боттарына арналған API және ЖИ үшін 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, стримдегі шамдар мен маркировкалық баға
- Кілт қосымшада жасалады және тек бір демо-шотпен жұмыс істейді
ЖИ-ассистенттерге арналған MCP
Claude, ChatGPT немесе Cursor баптауларында бір мекенжай — және сіз сұрағанда ассистент BuyCrypt деректерін өзі алады.
- Турнирлер, жүлделер, қатысушылар кестесі, монеталар бойынша көшбасшылар
- Трейдер паспорты: 1000-нан рейтинг, деңгей, сауда стилі
- Сіздің демо-шотыңыз: баланс, позициялар, ордерлер (тек оқуға арналған кілт арқылы)
MCP: BuyCrypt-ты Claude, ChatGPT және Cursor-ға қосыңыз
MCP — ЖИ-ассистенттер сыртқы деректер мен құралдарды қосатын ашық стандарт. 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 кілтіңізді серверге екі тақырыпта (header) береді: 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: СІЗДІҢ_API_KEY" \ --header "X-BuyCrypt-Api-Secret: СІЗДІҢ_API_SECRET"
{
"mcpServers": {
"buycrypt": {
"url": "https://buycrypt.com/mcp",
"headers": {
"X-BuyCrypt-Api-Key": "СІЗДІҢ_API_KEY",
"X-BuyCrypt-Api-Secret": "СІЗДІҢ_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 демо-шотыңызда орындалады, нақты биржаға жіберілмейді. Осылайша стратегияны ақшаны тәуекелге салмай нарықта тексеруге болады.
Қалай бастау керек
- Аккаунт. Веб-терминалға немесе BuyCrypt қосымшасына Google не Apple арқылы кіріңіз. Демо-шот бірден пайда болады.
- Кілт. Веб-терминалда немесе қосымшада: Профиль → API кілттері → демо-шотыңыз → Bot API keys блогы → Generate API key. apiKey мен apiSecret көшіріп алыңыз: құпия кілт бір рет қана көрсетіледі. ЖИ-ассистент немесе мониторинг үшін веб-терминалда 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 мс, 60 000 мс-ке дейін. Сағатты /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="СІЗДІҢ_API_KEY"; SECRET="СІЗДІҢ_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 келеді.
Ботқа пайдаланушылардың нақты шоттары мен биржа кілттері берілмейді — тек бөлек демо-шотқа арналған кілт.
Тіркеу — slug, displayName, webhookUrl (тек HTTPS) және webhookSecret (32 таңбадан бастап) параметрлері бар қолтаңбалы POST /fapi/v1/bot/profiles; тексерілгенге дейін бот PENDING_REVIEW мәртебесін алады. Әр оқиғаға қол қойылған: X-BuyCrypt-Signature тақырыпшасы = HMAC-SHA256(webhookSecret, timestamp + "." + дене), уақыты — 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 мен ЖИ-ассистенттер үшін веб-терминалда «Generate read-only key (for MCP)» таңдаңыз: мұндай кілт шотты көреді, бірақ сауда жасамайды. Құпия кілт бір рет қана көрсетіледі — оны бірден сақтап алыңыз. Кілттің күшін де сол жерде жоюға болады.
MCP деген не және ол не үшін керек?
MCP (Model Context Protocol) — ЖИ-ассистенттер сыртқы деректерді қосатын ашық стандарт. https://buycrypt.com/mcp серверін қосып, Claude, ChatGPT немесе Cursor-дан турнирлер, көшбасшылар және трейдер паспорты туралы сұрай аласыз, ал ассистент BuyCrypt-тың тірі деректері бойынша жауап береді.
MCP қосу үшін тіркелу керек пе?
Жоқ. Турнирлер, рейтинг, трейдер паспорттары мен бағалар кілтсіз қолжетімді. Кілт демо-шотыңызды оқитын үш құрал үшін ғана керек, оған тек оқуға арналған кілт те жеткілікті.
ЖИ-ассистент MCP арқылы сауда жасай ала ма?
Жоқ. Сервердің барлық тоғыз құралы тек деректерді оқиды: ордерлер қойылмайды және болдырылмайды, ешкім турнирге қосылмайды, ақша аударылмайды.
Бот әзірлеушісі менің биржа кілттерімді ала ма?
Жоқ. Басқаның ботын қосқанда BuyCrypt ол үшін бөлек демо-шот ашып, тек соған кілт береді. Нақты шоттарыңыз бен биржа кілттеріңіз ботқа берілмейді. Деректерді қорғау туралы толығырақ — «Қауіпсіздік» бетінде.
Демо-шоттан бастаңыз
BuyCrypt аккаунты тегін: бот үшін демо-шот, қосымшадағы API кілті, стратегияның қаншалықты құнды екенін көрсететін турнирлер мен рейтинг.