BuyCrypt
Әзірлеушілер мен ЖИ-ассистенттерге

Сауда боттарына арналған API және ЖИ үшін MCP

Binance USD-M Futures үшін жазылған бот BuyCrypt демо-шотында қайта жазусыз жұмыс істейді: тек API мекенжайы өзгереді. Ал Claude, ChatGPT және Cursor BuyCrypt MCP-сервері арқылы турнирлерді, трейдерлер рейтингін және сіздің демо-шотыңызды көреді.

1 жолбот кодында: басқа base URL
500+мерзімсіз USDT келісімшарт
9MCP құралы, бәрі тек оқиды
api.buycrypt.comтірі жауап
GET https://api.buycrypt.com/fapi/v1/ticker/price?symbol=BTCUSDT
{ "symbol": "BTCUSDT", "price": "…" }
# сіздің Binance USD-M Futures ботыңыз
- base_url="https://fapi.binance.com"
+ base_url="https://api.buycrypt.com"
Қосылудың екі тәсілі

Бот сауда жасайды. Ассистент сұрақтарға жауап береді.

Сауда боттарына арналған API

Сұраулар, қолтаңба және жауаптар форматы Binance USD-M Futures-тегідей. Бот сіздің BuyCrypt демо-шотыңызда ордер қояды: бағалар нарықтық, ақша демо.

  • Сол кітапханалар: binance-futures-connector, requests-тегі өз кодыңыз
  • REST, listenKey бойынша жеке WebSocket, стримдегі шамдар мен маркировкалық баға
  • Кілт қосымшада жасалады және тек бір демо-шотпен жұмыс істейді
API құжаттамасы →

ЖИ-ассистенттерге арналған MCP

Claude, ChatGPT немесе Cursor баптауларында бір мекенжай — және сіз сұрағанда ассистент BuyCrypt деректерін өзі алады.

  • Турнирлер, жүлделер, қатысушылар кестесі, монеталар бойынша көшбасшылар
  • Трейдер паспорты: 1000-нан рейтинг, деңгей, сауда стилі
  • Сіздің демо-шотыңыз: баланс, позициялар, ордерлер (тек оқуға арналған кілт арқылы)
Бір минутта қосу →
MCP · Model Context Protocol

MCP: BuyCrypt-ты Claude, ChatGPT және Cursor-ға қосыңыз

MCP — ЖИ-ассистенттер сыртқы деректер мен құралдарды қосатын ашық стандарт. BuyCrypt сервері ассистентке платформаның тірі деректерін береді. Тіркелу мен кілт қажет емес, кілт тек сіздің демо-шотыңыз үшін керек болады.

https://buycrypt.com/mcp
Streamable HTTPкірусізтек оқу
  1. claude.ai немесе Claude Desktop қосымшасын ашыңыз → Customize → Connectors.
  2. + Add → Add custom connector басыңыз.
  3. Атауы — BuyCrypt, мекенжайы — https://buycrypt.com/mcp, содан кейін Continue.
  4. Authentication бөлімінде No sign in таңдап, Add басыңыз.

Өз коннекторларыңыз Claude-тың барлық тарифінде бар, тегін тарифте — біреу. Team және Enterprise командаларында коннекторды ұйым иесі Organization settings → Connectors бөлімінде қосады. Өз демо-шотыңыз үшін кілтті сол терезедегі Request headers блогына қосыңыз — мұны қалай жасауға болады.

  1. Терминалда бір команданы орындаңыз:
Terminal
claude mcp add --transport http buycrypt https://buycrypt.com/mcp

Тексеру: claude mcp list — тізімде buycrypt пайда болады. Сервер барлық жобада қолжетімді болуы үшін --scope user қосыңыз.

  1. Браузерде chatgpt.com/plugins ашыңыз.
  2. + → Add custom MCP server басыңыз.
  3. Атауы — BuyCrypt, Connection бөлімінде жария мекенжайды таңдап, https://buycrypt.com/mcp көрсетіңіз.
  4. Authentication — No authentication. I understand and want to continue ескертуін растап, Create басыңыз.

ChatGPT-ге өз MCP-серверлері тек веб-нұсқада қосылады және барлық тарифте қолжетімді емес. Мұндай тармақ болмаса, оны тариф немесе жұмыс кеңістігінің әкімшісі жапқан. ChatGPT-ге өз демо-шотыңызды қосу мүмкін емес: ол серверге кілттерді жібермейді. Бұл үшін Claude, Claude Code және Cursor жарайды.

Cursor-ға қосу

Батырма Cursor-ды дайын баптаумен ашады. Немесе қолмен: ~/.cursor/mcp.json (барлық жоба үшін) немесе жоба түбіріндегі .cursor/mcp.json файлына қосыңыз:

mcp.json
{
  "mcpServers": {
    "buycrypt": {
      "url": "https://buycrypt.com/mcp"
    }
  }
}

Streamable HTTP қолдайтын кез келген клиент жарайды: https://buycrypt.com/mcp мекенжайын көрсетіңіз, авторизация қажет емес. Клиент тек жергілікті серверлерді (stdio) іске қоса алса, mcp-remote көпірі арқылы қосыңыз, Node.js керек:

claude_desktop_config.json және ұқсастары
{
  "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

Бір турнир: орындар бойынша жүлделер және нәтижелері бар қатысушылар кестесі.

кілтсіз
leaderboard

7, 30 немесе 90 күндегі монета бойынша көшбасшылар — «Топ-трейдерлер» бетіндегідей.

кілтсіз
trader_profile

Лақап аты бойынша трейдер паспорты: 1000-нан рейтинг, деңгей, бағалаудың бес бөлігі, стиль. Тек ашық профильдер.

кілтсіз
market_ticker

Мерзімсіз келісімшарт бойынша баға және 24 сағаттағы өзгеріс, мысалы BTCUSDT.

кілтсіз
demo_account

Демо-шотыңыздың балансы, маржасы және ашық позициялары.

сіздің кілтіңіз
demo_open_orders

Демо-шотыңыздың ашық ордерлері.

сіздің кілтіңіз
demo_recent_results

Демо-шоттың соңғы нәтижелері: жабылған мәмілелердің пайдасы мен шығыны, комиссиялар.

сіздің кілтіңіз

Бірде-бір құрал ордер қоймайды, турнирге қосылмайды және ақша аудармайды — сервер тек оқиды.

Ассистенттен не сұрауға болады

Көшіру үшін сұрақты басыңыз.

Тірі мысал

Ассистент BuyCrypt-ты осылай көреді

Төменде — https://buycrypt.com/mcp серверінің дәл қазіргі нағыз жауабы. Ассистент дәл осы деректерді алып, оларды өз сөзімен жеткізеді.

BTC бойынша айдың топ-5 трейдерін көрсет
ассистент leaderboard шақырады{"coin":"BTC","period_days":30,"limit":5}
Сервер жауабы жүктелуде…
Сіздің кілтіңіз бойынша

Демо-шотыңыз ассистентте

demo_account, demo_open_orders және demo_recent_results құралдары демо-шотыңызды оқиды. Ол үшін клиент API кілтіңізді серверге екі тақырыпта (header) береді: X-BuyCrypt-Api-Key және X-BuyCrypt-Api-Secret. Ассистент үшін тек оқуға арналған кілт жасаңыз: ол баланс, позициялар мен ордерлерді көреді, бірақ BuyCrypt ол арқылы ордер қоюды, ордерден бас тартуды немесе иінді өзгертуді орындамайды (жауап 403). Қалай алуға болады.

Terminal
claude mcp add --transport http buycrypt https://buycrypt.com/mcp \
  --header "X-BuyCrypt-Api-Key: СІЗДІҢ_API_KEY" \
  --header "X-BuyCrypt-Api-Secret: СІЗДІҢ_API_SECRET"
mcp.json
{
  "mcpServers": {
    "buycrypt": {
      "url": "https://buycrypt.com/mcp",
      "headers": {
        "X-BuyCrypt-Api-Key": "СІЗДІҢ_API_KEY",
        "X-BuyCrypt-Api-Secret": "СІЗДІҢ_API_SECRET"
      }
    }
  }
}
  1. Коннекторды қосқанда (Customize → Connectors → Add custom connector) мекенжайдан кейін No sign in таңдаңыз.
  2. Request headers блогында өз мәндеріңізбен екі тақырыпша қосыңыз: X-BuyCrypt-Api-Key және X-BuyCrypt-Api-Secret.
  3. Add басыңыз. Коннектор кілтсіз қосылып қойған болса, оны жойып, тақырыпшалармен қайта қосыңыз.

Тек оқу

MCP-сервер ордер қоймайды және оларды жоймайды. Кілт оған баланс, позициялар мен ордерлерді оқу үшін ғана керек. Тек оқуға арналған кілт бөгде адамның қолына түссе де, онымен сауда жасау мүмкін емес.

Бір демо-шот

BuyCrypt кілті тек өзі жасалған демо-шотпен жұмыс істейді. Нақты биржалық шоттарға ол қолжетімділік бермейді.

Бөлек кілт

Ассистент үшін бөлек, тек оқуға арналған кілт жасаңыз. Кілт тек buycrypt.com-ға жіберіледі, сервер оны сақтамайды және журналдарға жазбайды. Кілттің күшін оны жасаған жерде жоюға болады.

Сауда боттарына арналған API

Binance USD-M Futures-пен үйлесімді API

Жолдар, HMAC-SHA256 қолтаңбасы, параметрлер және жауаптар форматы — Binance USD-M Futures-тегідей. Айырмашылық біреу: ордерлер нарықтық бағалар бойынша сіздің BuyCrypt демо-шотыңызда орындалады, нақты биржаға жіберілмейді. Осылайша стратегияны ақшаны тәуекелге салмай нарықта тексеруге болады.

Қалай бастау керек

  1. Аккаунт. Веб-терминалға немесе BuyCrypt қосымшасына Google не Apple арқылы кіріңіз. Демо-шот бірден пайда болады.
  2. Кілт. Веб-терминалда немесе қосымшада: Профиль → API кілттері → демо-шотыңыз → Bot API keys блогы → Generate API key. apiKey мен apiSecret көшіріп алыңыз: құпия кілт бір рет қана көрсетіледі. ЖИ-ассистент немесе мониторинг үшін веб-терминалда Generate read-only key (for MCP) батырмасы бар.
  3. Мекенжай. Кітапханаңызда https://fapi.binance.com орнына https://api.buycrypt.com көрсетіңіз. /fapi/v1/… жолдары бұрынғыдай қалады.
  4. Тексеру. Балансты сұратыңыз — 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 коды қайтады.
pip install binance-futures-connector
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"))
pip install requests
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))
bash, openssl
# жария деректер — кілтсіз
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 қажет.

Нарық деректері кілтсіз
GET/fapi/v1/ping · /fapi/v1/timeБайланысты тексеру және сервер уақыты, мс.
GET/fapi/v1/exchangeInfoКелісімшарттар, баға мен саны сүзгілері, лимиттер.
GET/fapi/v1/ticker/price · /ticker/24hr · /ticker/bookTickerСоңғы баға, 24 сағаттық статистика, ең жақсы сатып алу және сату бағалары.
GET/fapi/v1/depth · /fapi/v1/klinesОрдер кітабы мен шамдар.
GET/fapi/v1/premiumIndex · /fapi/v1/fundingRateМаркировкалық баға, индекс және қаржыландыру мөлшерлемесі.
Шот және позициялар қолтаңбалы
GET/fapi/v2/account · /fapi/v3/accountБаланс, маржа және позициялар бір жауаппен (v1, v2 және v3 бірдей).
GET/fapi/v2/balance · /fapi/v3/balanceДемо-шот балансы, тек USDT.
GET/fapi/v2/positionRisk · /fapi/v3/positionRiskАшық позициялар: кіру бағасы, маркировкалық баға, іске аспаған нәтиже, ликвидация бағасы.
GET/fapi/v1/userTrades · /fapi/v1/incomeСимвол бойынша мәмілелер және нәтижелер тарихы: пайда мен шығын, комиссиялар.
GET/fapi/v1/commissionRate · /fapi/v1/leverageBracketСимвол бойынша комиссия және иін деңгейлері.
Сауда қолтаңбалы
POST/fapi/v1/orderЖаңа ордер: MARKET, LIMIT, STOP, STOP_MARKET, TAKE_PROFIT, TAKE_PROFIT_MARKET, TRAILING_STOP_MARKET; reduceOnly, closePosition, timeInForce, newClientOrderId.
GET/fapi/v1/order · /openOrders · /allOrdersБір ордер, ашық ордерлер, тарих.
PUT/fapi/v1/orderЛимиттік ордерді өзгерту.
DELETE/fapi/v1/order · /allOpenOrdersБір ордерді немесе символ бойынша барлығын болдырмау.
POST/fapi/v1/batchOrdersБір сұраумен бірнеше ордер; DELETE — тізіммен болдырмау.
POST/fapi/v1/algoOrderШартты ордерлер (стоп, тейк-профит, трейлинг); GET /openAlgoOrders, /allAlgoOrders тізімдері, DELETE /algoOrder, /algoOpenOrders.
POST/fapi/v1/leverage · /fapi/v1/marginTypeСимвол бойынша иін және маржа түрі.
GET/fapi/v1/positionSide/dualӘрдайым dualSidePosition: false — бір позиция режимі.
WebSocket ағындары
POST/fapi/v1/listenKey60 минутқа жеке ағын кілті; PUT ұзартады, DELETE жабады.
WSwss://api.buycrypt.com/fapi/ws/<listenKey>Шотыңыздың оқиғалары: ORDER_TRADE_UPDATE, ACCOUNT_UPDATE, MARGIN_CALL — Binance форматында.
WSwss://api.buycrypt.com/fapi/ws-market/btcusdt@markPriceБір нарықтың жария ағыны: @markPrice және @kline_1m.
WSwss://api.buycrypt.com/stream?streams=btcusdt@markPrice/ethusdt@kline_1mБір қосылымда бірнеше ағын, жауаптар {"stream", "data"} қабығында.
Лимиттер мен қателер
1 мин2 400 салмақ · 1 200 қолтаңбалы оқуБір API кілтіне. Жауаптарда — X-MBX-USED-WEIGHT-1M және X-MBX-ORDER-COUNT-10S тақырыпшалары.
10 с300 ордерАсып кетсе — HTTP 429 және Retry-After.
ERR-1021 · -1022 · -2014 · -2015Уақыт recvWindow шегінен тыс · қолтаңба қате · кілт пішімі қате · кілттің күші жойылған немесе ол қате (HTTP 401), кілт тек оқуға арналған, ал сұрау сауда сұрауы (HTTP 403).
ERR-1102 · -2010 · -2011 · -2019Міндетті параметр жоқ · ордер қабылданбады · ордер табылмады · маржа жетпейді.
Ботыңызға арналған жазылушылар (бета)

Ботты жария ретінде тіркеуге болады: пайдаланушы қосымшада «Қосу» батырмасын басады, 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 сәтсіз жеткізуден кейін вебхук өшіріледі — оны қайта қосуға қолдау қызметі көмектеседі.

Вебхук қолтаңбасын тексеру, Python
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 кілті, стратегияның қаншалықты құнды екенін көрсететін турнирлер мен рейтинг.