Para sa mga developer at AI assistant

API para sa mga trading bot at MCP para sa AI

Ang bot na isinulat para sa Binance USD-M Futures ay gumagana sa demo account ng BuyCrypt nang hindi isinusulat muli: ang address lang ng API ang nagbabago. At sa pamamagitan ng MCP server ng BuyCrypt, nakikita ng Claude, ChatGPT at Cursor ang mga tournament, rating ng mga trader at ang inyong demo account.

Ikonekta ang AI assistant Dokumentasyon ng API

1 linyasa code ng bot: ibang base URL

500+perpetual na kontrata sa USDT

9MCP tool, lahat ay pagbasa lang

api.buycrypt.comlive na sagot

GET https://api.buycrypt.com/fapi/v1/ticker/price?symbol=BTCUSDT

{ "symbol": "BTCUSDT", "price": "…" }

# ang inyong bot sa Binance USD-M Futures

- base_url="https://fapi.binance.com"

+ base_url="https://api.buycrypt.com"

Dalawang paraan para kumonekta

Nagte-trade ang bot. Sumasagot sa mga tanong ang assistant.

API para sa mga trading bot

Ang format ng mga request, signature at sagot ay gaya ng sa Binance USD-M Futures. Naglalagay ang bot ng mga order sa inyong demo account sa BuyCrypt: presyo ng market, demo na pera.

Parehong mga library: binance-futures-connector, sariling code gamit ang requests
REST, private WebSocket sa pamamagitan ng listenKey, mga candle at mark price sa stream
Ginagawa ang key sa app at gumagana lang sa iisang demo account

Dokumentasyon ng API →

MCP para sa mga AI assistant

Isang address sa settings ng Claude, ChatGPT o Cursor, at kusang kinukuha ng assistant ang data ng BuyCrypt kapag nagtanong kayo tungkol dito.

Mga tournament, premyo, talaan ng mga kalahok, mga nangunguna ayon sa coin
Trader passport: rating sa 1000, antas, istilo ng trading
Ang inyong demo account: balance, mga posisyon, mga order (gamit ang read-only key)

Ikonekta sa loob ng isang minuto →

MCP · Model Context Protocol

MCP: ikonekta ang BuyCrypt sa Claude, ChatGPT at Cursor

Ang MCP ay bukas na pamantayan kung saan ikinokonekta ng mga AI assistant ang panlabas na data at mga tool. Ang server ng BuyCrypt ay nagbibigay sa assistant ng live na data ng platform. Hindi kailangan ng rehistrasyon at key, kailangan lang ang key para sa inyong demo account.

https://buycrypt.com/mcp

Streamable HTTPwalang pag-sign inpagbasa lang

Buksan ang claude.ai o ang Claude Desktop app → Customize → Connectors.
Pindutin ang + Add → Add custom connector.
Pangalan — BuyCrypt, address — https://buycrypt.com/mcp, pagkatapos ay Continue.
Sa seksyong Authentication, piliin ang No sign in at pindutin ang Add.

May sariling connector sa lahat ng plano ng Claude, at isa sa libreng plano. Sa Team at Enterprise, ang may-ari ng organisasyon ang nagdaragdag ng connector sa Organization settings → Connectors. Para sa sariling demo account, idagdag ang key sa block na Request headers sa parehong window — paano ito gawin.

Patakbuhin ang isang command sa terminal:

Terminal

claude mcp add --transport http buycrypt https://buycrypt.com/mcp

Pagsusuri: claude mcp list — lalabas sa listahan ang buycrypt. Idagdag ang --scope user para maging available ang server sa lahat ng proyekto.

Buksan ang chatgpt.com/plugins sa browser.
Pindutin ang + → Add custom MCP server.
Pangalan — BuyCrypt, sa seksyong Connection piliin ang pampublikong address at ilagay ang https://buycrypt.com/mcp.
Authentication — No authentication. Kumpirmahin ang babalang I understand and want to continue at pindutin ang Create.

Ang sariling MCP server sa ChatGPT ay naidaragdag lang sa web version at hindi available sa lahat ng plano. Kung wala ang opsyon, isinara ito ng plano o ng admin ng workspace. Hindi maikokonekta ang sariling demo account sa ChatGPT: hindi nito ipinapasa ang mga key sa server. Para rito, angkop ang Claude, Claude Code at Cursor.

Idagdag sa Cursor

Bubuksan ng button ang Cursor na may handang setting. O manu-mano: idagdag sa ~/.cursor/mcp.json (para sa lahat ng proyekto) o .cursor/mcp.json sa root ng proyekto:

mcp.json

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

Angkop ang anumang client na sumusuporta sa Streamable HTTP: ilagay ang address na https://buycrypt.com/mcp, hindi kailangan ng authorization. Kung lokal na server (stdio) lang ang kayang patakbuhin ng client, ikonekta sa pamamagitan ng bridge na mcp-remote, kailangan ng Node.js:

claude_desktop_config.json at mga kahawig

{
  "mcpServers": {
    "buycrypt": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://buycrypt.com/mcp"]
    }
  }
}

Suriin ang server nang walang assistant: npx @modelcontextprotocol/inspector --cli https://buycrypt.com/mcp --transport http --method tools/list

Ano ang kayang gawin ng server

platform_overview

Anong mga tournament ang tumatakbo ngayon, alin ang susunod na magsisimula, ilang trader ang nasa mga tournament, ang mga huling premyo.

walang key

list_tournaments

Mga tumatakbo, paparating at tapos nang tournament: coin, paraan ng pagbilang, prize pool, entry, mga kalahok.

walang key

get_tournament

Isang tournament: mga premyo ayon sa puwesto at talaan ng mga kalahok na may resulta.

walang key

leaderboard

Mga nangunguna ayon sa coin sa loob ng 7, 30 o 90 araw — gaya ng sa pahinang “Top Traders”.

walang key

trader_profile

Trader passport ayon sa nickname: rating sa 1000, antas, limang bahagi ng marka, istilo. Mga pampublikong profile lang.

walang key

market_ticker

Presyo at pagbabago sa loob ng 24 oras ng perpetual na kontrata, halimbawa BTCUSDT.

walang key

demo_account

Balanse, margin at mga bukas na posisyon ng inyong demo account.

inyong key

demo_open_orders

Mga bukas na order ng inyong demo account.

inyong key

demo_recent_results

Mga huling resulta ng demo account: kita at lugi ng mga saradong trade, mga fee.

inyong key

Walang tool na naglalagay ng order, sumasali sa tournament o naglilipat ng pera — nagbabasa lang ang server.

Ano ang itatanong sa assistant

Pindutin ang tanong para kopyahin ito.

Live na halimbawa

Ganito nakikita ng assistant ang BuyCrypt

Sa ibaba ang totoong sagot ng server na https://buycrypt.com/mcp ngayon mismo. Ang parehong data ang natatanggap ng assistant at ikinukuwento ito sa sarili nitong salita.

Ipakita ang top 5 trader ng buwan sa BTC

tinatawag ng assistant ang leaderboard{"coin":"BTC","period_days":30,"limit":5}

Naglo-load ang sagot ng server…

Gamit ang inyong key

Ang inyong demo account sa assistant

Binabasa ng mga tool na demo_account, demo_open_orders at demo_recent_results ang inyong demo account. Para sa mga ito, ipinapasa ng client sa server ang inyong API key sa dalawang header: X-BuyCrypt-Api-Key at X-BuyCrypt-Api-Secret. Para sa assistant, gumawa ng key na read-only: nakikita nito ang balance, mga posisyon at mga order, pero hindi magsasagawa ang BuyCrypt ng order, cancel o pagpapalit ng leverage gamit ito (sagot na 403). Paano kumuha.

Terminal

claude mcp add --transport http buycrypt https://buycrypt.com/mcp \
  --header "X-BuyCrypt-Api-Key: INYONG_API_KEY" \
  --header "X-BuyCrypt-Api-Secret: INYONG_API_SECRET"

mcp.json

{
  "mcpServers": {
    "buycrypt": {
      "url": "https://buycrypt.com/mcp",
      "headers": {
        "X-BuyCrypt-Api-Key": "INYONG_API_KEY",
        "X-BuyCrypt-Api-Secret": "INYONG_API_SECRET"
      }
    }
  }
}

Sa pagdagdag ng connector (Customize → Connectors → Add custom connector), pagkatapos ng address ay piliin ang No sign in.
Sa block na Request headers, magdagdag ng dalawang header: X-BuyCrypt-Api-Key at X-BuyCrypt-Api-Secret na may inyong mga halaga.
Pindutin ang Add. Kung naidagdag na ang connector nang walang key, burahin ito at idagdag muli na may mga header.

Pagbasa lang

Hindi naglalagay o nagka-cancel ng order ang MCP server. Kailangan nito ang key para mabasa ang balance, mga posisyon at mga order. Hindi makakapag-trade gamit ang read-only key, kahit mapunta pa ito sa ibang tao.

Iisang demo account

Gumagana lang ang key ng BuyCrypt sa demo account kung para saan ito ginawa. Hindi ito nagbibigay ng access sa mga totoong exchange account.

Hiwalay na key

Gumawa ng hiwalay na read-only key para sa assistant. Sa buycrypt.com lang napupunta ang key; hindi ito sine-save ng server at hindi isinusulat sa mga log. Maaari ninyo itong bawiin sa mismong lugar kung saan ito ginawa.

API para sa mga trading bot

API na compatible sa Binance USD-M Futures

Ang mga path, signature na HMAC-SHA256, mga parameter at format ng sagot — gaya ng sa Binance USD-M Futures. Iisa ang pagkakaiba: isinasagawa ang mga order sa inyong demo account sa BuyCrypt sa presyo ng market, at hindi napupunta sa totoong exchange. Kaya masusubok ang strategy sa market nang hindi nanganganib ang pera.

Paano magsimula

Account. Mag-sign in sa web terminal o sa BuyCrypt app gamit ang Google o Apple. Agad na lalabas ang demo account.
Key. Sa web terminal o app: Profile → API keys → inyong demo account → block na Bot API keys → Generate API key. Kopyahin ang apiKey at apiSecret: isang beses lang ipinapakita ang secret. Para sa AI assistant o monitoring, may button sa web terminal na Generate read-only key (for MCP).
Address. Sa inyong library, ilagay ang https://api.buycrypt.com sa halip na https://fapi.binance.com. Nananatili ang mga path na /fapi/v1/….
Pagsusuri. Hilingin ang balanse — GET /fapi/v2/balance: nasa sagot ang USDT ng inyong demo account.

Mahalagang malaman

Mga USDT contract at one-way position mode lang; hindi suportado ang hedge mode.
Presyo ng ticker — /fapi/v1/ticker/price. Ang path na /fapi/v2/ticker/price, na tinatawag ng mga bagong bersyon ng library, ay hindi pa suportado.
Sa pampublikong stream, dumarating ang mga candle na @kline_1m (bawat 5 seg) at @markPrice (bawat segundo).
recvWindow — 5,000 ms bilang default, hanggang 60,000 ms. I-sync ang orasan gamit ang /fapi/v1/time.
Ang account na may trading API key ay nakakakuha ng badge na 🤖 sa rating ng app: nakikita ng lahat na programa ang nagte-trade.
Mga pahintulot ng key: ang karaniwang key (READ_TRADE) ay nagbabasa at nagte-trade, ang read-only key (READ) ay GET requests at listenKey lang. Kapag ginamit ito sa order, cancel, leverage o margin — HTTP 403 at code na -2015.

pip install binance-futures-connector

import os
from binance.um_futures import UMFutures

client = UMFutures(
    key=os.environ["BUYCRYPT_API_KEY"],        # key mula sa BuyCrypt app
    secret=os.environ["BUYCRYPT_API_SECRET"],
    base_url="https://api.buycrypt.com",      # ang tanging linyang nagbabago
)

print(client.balance())                             # USDT ng demo account
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

# pampublikong data — walang 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"

# balanse ng demo account — signed na request
KEY="INYONG_API_KEY"; SECRET="INYONG_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"

Mga method

Base address ng REST — https://api.buycrypt.com. Ang mga signed method ay nangangailangan ng header na X-MBX-APIKEY, timestamp at signature.

Market data walang key

GET/fapi/v1/ping · /fapi/v1/timePagsusuri ng koneksyon at oras ng server sa ms.

GET/fapi/v1/exchangeInfoMga kontrata, filter ng presyo at dami, mga limit.

GET/fapi/v1/ticker/price · /ticker/24hr · /ticker/bookTickerHuling presyo, estadistika sa 24 oras, pinakamagandang presyo ng bili at benta.

GET/fapi/v1/depth · /fapi/v1/klinesOrder book at mga candle.

GET/fapi/v1/premiumIndex · /fapi/v1/fundingRateMark price, index at funding rate.

Account at mga posisyon signed

GET/fapi/v2/account · /fapi/v3/accountBalanse, margin at mga posisyon sa iisang sagot (pareho ang v1, v2 at v3).

GET/fapi/v2/balance · /fapi/v3/balanceBalanse ng demo account, USDT lang.

GET/fapi/v2/positionRisk · /fapi/v3/positionRiskMga bukas na posisyon: entry price, mark price, unrealized na resulta, liquidation price.

GET/fapi/v1/userTrades · /fapi/v1/incomeMga trade ayon sa symbol at kasaysayan ng resulta: kita at lugi, mga fee.

GET/fapi/v1/commissionRate · /fapi/v1/leverageBracketFee ayon sa symbol at mga antas ng leverage.

Trading signed

POST/fapi/v1/orderBagong order: MARKET, LIMIT, STOP, STOP_MARKET, TAKE_PROFIT, TAKE_PROFIT_MARKET, TRAILING_STOP_MARKET; reduceOnly, closePosition, timeInForce, newClientOrderId.

GET/fapi/v1/order · /openOrders · /allOrdersIsang order, mga bukas na order, kasaysayan.

PUT/fapi/v1/orderBaguhin ang limit order.

DELETE/fapi/v1/order · /allOpenOrdersKanselahin ang isang order o lahat ayon sa symbol.

POST/fapi/v1/batchOrdersIlang order sa iisang request; DELETE — pagkansela ng listahan.

POST/fapi/v1/algoOrderMga conditional order (stop, take profit, trailing); GET /openAlgoOrders, /allAlgoOrders, DELETE /algoOrder, /algoOpenOrders.

POST/fapi/v1/leverage · /fapi/v1/marginTypeLeverage at uri ng margin ayon sa symbol.

GET/fapi/v1/positionSide/dualPalaging dualSidePosition: false — one-way position mode.

Mga WebSocket stream

POST/fapi/v1/listenKeyKey ng private stream para sa 60 minuto; pinahahaba ng PUT, isinasara ng DELETE.

WSwss://api.buycrypt.com/fapi/ws/<listenKey>Mga event ng inyong account: ORDER_TRADE_UPDATE, ACCOUNT_UPDATE, MARGIN_CALL — sa format ng Binance.

WSwss://api.buycrypt.com/fapi/ws-market/btcusdt@markPricePampublikong stream ng isang market: @markPrice at @kline_1m.

WSwss://api.buycrypt.com/stream?streams=btcusdt@markPrice/ethusdt@kline_1mIlang stream sa iisang koneksyon, nakabalot ang mga sagot sa {"stream", "data"}.

Mga limit at error

1 min2,400 weight · 1,200 signed na pagbasaBawat API key. Sa mga sagot — ang mga header na X-MBX-USED-WEIGHT-1M at X-MBX-ORDER-COUNT-10S.

10 seg300 orderKapag lumampas — HTTP 429 at Retry-After.

ERR-1021 · -1022 · -2014 · -2015Oras na labas sa recvWindow · maling signature · maling format ng key · binawi o mali ang key (HTTP 401), read-only ang key pero pang-trade ang request (HTTP 403).

ERR-1102 · -2010 · -2011 · -2019Walang kinakailangang parameter · tinanggihan ang order · hindi nakita ang order · kulang ang margin.

Mga subscriber para sa inyong bot (beta)

Maaaring irehistro ang bot bilang pampubliko: pinipindot ng user ang “Connect” sa app, binubuksan ng BuyCrypt para sa kanya ang hiwalay na demo account na may 1,000 demo USDT at naglalabas ng key para sa account na ito lang. Ipinapadala ang key sa inyong webhook bilang event na subscription.created, at nagte-trade ang bot sa demo account ng subscriber. Kapag nag-disconnect ang user, isinasara ang mga posisyon, hihinto ang key, at matatanggap ninyo ang subscription.disconnected.

Hindi ipinapasa sa bot ang mga totoong account at exchange key ng mga user — key lang sa hiwalay na demo account.

Ang rehistrasyon ay signed na POST /fapi/v1/bot/profiles na may mga parameter na slug, displayName, webhookUrl (HTTPS lang) at webhookSecret (mula 32 character); nasa status na PENDING_REVIEW ang bot hanggang masuri. Naka-sign ang bawat event: header na X-BuyCrypt-Signature = HMAC-SHA256(webhookSecret, timestamp + "." + body), ang oras — sa X-BuyCrypt-Timestamp. Inuulit ang paghahatid hanggang 6 na beses (agad, pagkatapos ng 10 seg, 30 seg, 2 min, 10 min, 1 oras); pagkatapos ng 10 sunod-sunod na bigong paghahatid, ina-off ang webhook — maaari itong i-on muli ng suporta.

Pagsusuri ng signature ng webhook, 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:   # lampas 5 minuto — tanggihan
        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"])

Mga key at seguridad

Demo account lang ang binubuksan ng key ng BuyCrypt

Nakatali sa iisang account

Ginagawa ang API key para sa isang partikular na demo account at doon lang ito gumagana. Hindi maa-access ang mga totoong account sa exchange sa API na ito. Hindi rin nagte-trade ang read-only key kahit sa account na ito.

Isang beses lang ipinapakita ang secret

Itago ang key at secret sa environment variable o secrets manager, hindi sa code at hindi sa mga pampublikong repository.

Pagbawi sa isang segundo

Sa web terminal o app, sa parehong block na "Bot API keys", pindutin ang "Revoke": agad makakatanggap ng error 401 ang lahat ng request na gumagamit ng key na ito.

Mga tanong

Mga madalas na tanong

Totoong pera ba ang tine-trade ng bot?

Hindi. Isinasagawa ng API ng BuyCrypt ang mga order sa inyong demo account: presyo ng market, balanse sa demo USDT. Hindi ipinapadala ang mga order sa exchange, kaya masusubok ang strategy nang walang panganib.

Kailangan bang isulat muli ang bot para sa BuyCrypt?

Karaniwan ay hindi. Kung gumagana ang bot sa Binance USD-M Futures, palitan ang base address ng https://api.buycrypt.com at ilagay ang key ng BuyCrypt. Pareho ang mga path, signature at format ng sagot. Suriin na hindi gumagamit ang bot ng hedge mode at ng path na /fapi/v2/ticker/price.

Saan makukuha ang API key?

Sa web terminal o app ng BuyCrypt: Profile → API keys → inyong demo account → Bot API keys → Generate API key. Para sa MCP at mga AI assistant — "Generate read-only key (for MCP)" sa web terminal: nakikita ng ganitong key ang account, pero hindi ito nagte-trade. Isang beses lang ipinapakita ang secret, kaya i-save agad ito. Doon din maaaring bawiin ang key.

Ano ang MCP at para saan ito?

Ang MCP (Model Context Protocol) ay bukas na pamantayan kung saan ikinokonekta ng mga AI assistant ang panlabas na data. Kapag ikinonekta ang server na https://buycrypt.com/mcp, maaari ninyong tanungin ang Claude, ChatGPT o Cursor tungkol sa mga tournament, mga nangunguna at trader passport, at sasagot ang assistant gamit ang live na data ng BuyCrypt.

Kailangan ba ng rehistrasyon para ikonekta ang MCP?

Hindi. Available nang walang key ang mga tournament, rating, trader passport at presyo. Kailangan lang ang key para sa tatlong tool na nagbabasa ng inyong demo account, at sapat na ang read-only key.

Maaari bang mag-trade ang AI assistant sa pamamagitan ng MCP?

Hindi. Nagbabasa lang ng data ang lahat ng siyam na tool ng server: walang inilalagay o kinakanselang order, walang sumasali sa tournament, walang inililipat na pera.

Makukuha ba ng developer ng bot ang aking exchange key?

Hindi. Kapag ikinonekta ninyo ang bot ng iba, nagbubukas ang BuyCrypt ng hiwalay na demo account para rito at nagbibigay ng key para lang doon. Hindi ipinapasa sa bot ang inyong mga totoong account at exchange key. Higit pa tungkol sa proteksyon ng data — sa pahinang “Seguridad”.

Magsimula sa demo account

Libre ang BuyCrypt account: demo account para sa bot, API key sa app, mga tournament at rating kung saan makikita kung ano ang halaga ng strategy.

Buksan ang web terminal I-download ang app

Mga top trader Trader passport Mga libreng tournament Lahat ng tournament Gabay sa trading Seguridad