API don bot na ciniki da MCP don AI
Bot da aka rubuta don Binance USD-M Futures yana aiki a asusun gwaji na BuyCrypt ba tare da sake rubutawa ba: adireshin API kawai ake canzawa. Kuma Claude, ChatGPT da Cursor ta sabar MCP ta BuyCrypt suna ganin gasanni, ƙimar 'yan kasuwa da asusun gwajin ku.
{ "symbol": "BTCUSDT", "price": "…" }
Bot yana ciniki. Mataimaki yana amsa tambayoyi.
API don bot na ciniki
Tsarin buƙatu, sa hannu da amsoshi kamar na Binance USD-M Futures. Bot yana sanya oda a asusun gwaji na BuyCrypt ɗin ku: farashin kasuwa ne, kuɗin na gwaji ne.
- Ɗakunan karatu iri ɗaya: binance-futures-connector, lambar ku da requests
- REST, WebSocket na sirri ta listenKey, kyandira da farashin alama (mark price) a cikin stream
- Ana ƙirƙirar maɓalli a manhajar, kuma yana aiki da asusun gwaji ɗaya kawai
MCP don mataimakan AI
Adireshi ɗaya a saitunan Claude, ChatGPT ko Cursor, kuma mataimakin zai ɗauki bayanan BuyCrypt da kansa idan kun tambaye shi game da su.
- Gasanni, kyaututtuka, teburin mahalarta, jagorori bisa tsabar kuɗi
- Fasfo na ɗan kasuwa: ƙima cikin 1000, mataki, salon ciniki
- Asusun gwajinku: balance, matsayai, oda (ta maɓallin karantawa kaɗai)
MCP: haɗa BuyCrypt da Claude, ChatGPT da Cursor
MCP buɗaɗɗen ma'auni ne da mataimakan AI ke amfani da shi don haɗa bayanai da kayan aiki na waje. Sabar BuyCrypt tana ba mataimakin bayanan dandalin kai tsaye. Ba a buƙatar rajista ko maɓalli; maɓalli ana buƙata ne kawai don asusun gwajin ku.
https://buycrypt.com/mcp
- Ku buɗe claude.ai ko manhajar Claude Desktop → Customize → Connectors.
- Ku danna + Add → Add custom connector.
- Suna: BuyCrypt, adireshi: https://buycrypt.com/mcp, sannan Continue.
- A sashen Authentication ku zaɓi No sign in ku danna Add.
Connectors na kanku suna akwai a dukkan tsare-tsaren Claude; a tsarin kyauta, ɗaya ne. A ƙungiyoyin Team da Enterprise, mai ƙungiyar ne ke ƙara connector a Organization settings → Connectors. Don asusun gwajin ku, ku ƙara maɓalli a sashen Request headers na wannan tagar; yadda ake yi.
- Ku gudanar da umarni ɗaya a terminal:
claude mcp add --transport http buycrypt https://buycrypt.com/mcp
Tabbatarwa: claude mcp list; buycrypt zai bayyana a jerin. Ku ƙara --scope user don sabar ta kasance a dukkan ayyukan ku.
- Ku buɗe chatgpt.com/plugins a burauza.
- Ku danna + → Add custom MCP server.
- Suna: BuyCrypt; a sashen Connection ku zaɓi adireshin jama'a ku shigar da https://buycrypt.com/mcp.
- Authentication: No authentication. Ku tabbatar da gargaɗin I understand and want to continue ku danna Create.
A ChatGPT ana ƙara sabar MCP ta kanku ne a sigar yanar gizo kawai, kuma ba a dukkan tsare-tsare ake samu ba. Idan zaɓin ba ya nan, tsarin ku ko mai kula da wurin aiki ne ya rufe shi. Ba za a iya haɗa asusun gwajin ku a ChatGPT ba: ba ya tura maɓallai zuwa sabar. Don haka, Claude, Claude Code da Cursor sun dace.
Maɓallin zai buɗe Cursor da saitin a shirye. Ko da hannu: ku ƙara a ~/.cursor/mcp.json (don dukkan ayyuka) ko .cursor/mcp.json a tushen aikin:
{
"mcpServers": {
"buycrypt": {
"url": "https://buycrypt.com/mcp"
}
}
}Kowace manhaja mai tallafin Streamable HTTP ta dace: ku shigar da adireshin https://buycrypt.com/mcp, ba a buƙatar izini. Idan manhajar tana iya gudanar da sabar na gida kawai (stdio), ku haɗa ta gadar mcp-remote; ana buƙatar Node.js:
{
"mcpServers": {
"buycrypt": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://buycrypt.com/mcp"]
}
}
}Gwada sabar ba tare da mataimaki ba: npx @modelcontextprotocol/inspector --cli https://buycrypt.com/mcp --transport http --method tools/list
Abin da sabar ke iya yi
platform_overviewWaɗanne gasanni ke gudana yanzu, wace za ta fara na gaba, 'yan kasuwa nawa ke cikin gasanni, kyaututtukan baya-bayan nan.
ba tare da maɓalli balist_tournamentsGasannin da ke gudana, na kusa da waɗanda suka ƙare: tsabar kuɗi, hanyar ƙirga, jimillar kyaututtuka, shiga, mahalarta.
ba tare da maɓalli baget_tournamentGasa ɗaya: kyaututtuka bisa matsayi da teburin mahalarta tare da sakamako.
ba tare da maɓalli baleaderboardJagorori bisa tsabar kuɗi na kwanaki 7, 30 ko 90, kamar a shafin “Manyan 'yan kasuwa”.
ba tare da maɓalli batrader_profileFasfo na ɗan kasuwa bisa sunan laƙabi: ƙima cikin 1000, mataki, ɓangarori biyar na tantancewa, salo. Bayanan martaba na jama'a kawai.
ba tare da maɓalli bamarket_tickerFarashi da canji na awa 24 na kwangila marar ƙarewa, misali BTCUSDT.
ba tare da maɓalli bademo_accountMa'auni, margin da buɗaɗɗun matsayai na asusun gwajin ku.
maɓallin kudemo_open_ordersBuɗaɗɗun oda na asusun gwajin ku.
maɓallin kudemo_recent_resultsSakamakon baya-bayan nan na asusun gwaji: riba da asarar cinikan da aka rufe, kuɗaɗen sabis.
maɓallin kuBabu kayan aikin da ke sanya oda, shiga gasanni ko tura kuɗi; sabar karantawa kawai take yi.
Abin da za ku tambayi mataimaki
Ku danna tambaya don kwafa ta.
Haka mataimaki ke ganin BuyCrypt
A ƙasa akwai amsar gaske ta sabar https://buycrypt.com/mcp a yanzu. Mataimaki yana karɓar waɗannan bayanai kuma yana bayyana su da kalmominsa.
Asusun gwajin ku a cikin mataimaki
Kayan aikin demo_account, demo_open_orders da demo_recent_results suna karanta asusun gwajinku. Saboda su, client yana tura maɓallin API ɗinku zuwa sabar a cikin header guda biyu: X-BuyCrypt-Api-Key da X-BuyCrypt-Api-Secret. Ku ƙirƙiri maɓalli na karantawa kaɗai don mataimakin: yana ganin balance, matsayai da oda, amma BuyCrypt ba zai yi oda, soke oda ko canza leverage da shi ba (amsa 403). Yadda ake samu.
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"
}
}
}
}- Lokacin ƙara connector (Customize → Connectors → Add custom connector), bayan adireshi ku zaɓi No sign in.
- A sashen Request headers ku ƙara headers biyu: X-BuyCrypt-Api-Key da X-BuyCrypt-Api-Secret tare da ƙimomin ku.
- Ku danna Add. Idan an riga an ƙara connector ba tare da maɓalli ba, ku goge shi ku sake ƙara shi da headers.
Karantawa kawai
Sabar MCP ba ta sanya oda kuma ba ta soke shi. Tana buƙatar maɓallin ne don karanta balance, matsayai da oda. Maɓallin karantawa kaɗai ba zai ba da damar yin ciniki ba, ko da ya faɗa hannun wani.
Asusun gwaji ɗaya
Maɓallin BuyCrypt yana aiki ne kawai da asusun gwajin da aka ƙirƙira shi dominsa. Ba ya ba da damar shiga asusun musayar kuɗi na gaske.
Maɓalli na daban
Ku ƙirƙiri maɓallin karantawa kaɗai na daban don mataimakin. Maɓallin yana zuwa buycrypt.com kaɗai; sabar ba ta adana shi kuma ba ta rubuta shi a log. Kuna iya janye shi a wurin da kuka ƙirƙira shi.
API mai dacewa da Binance USD-M Futures
Hanyoyi, sa hannun HMAC-SHA256, sigogi da tsarin amsoshi kamar na Binance USD-M Futures. Bambanci ɗaya ne: ana aiwatar da oda a asusun gwaji na BuyCrypt ɗin ku a farashin kasuwa, ba sa zuwa musayar kuɗi ta gaske. Ta haka za a iya gwada dabara a kasuwa ba tare da haɗarin kuɗi ba.
Yadda za a fara
- Asusu. Ku shiga tashar yanar gizo ko manhajar BuyCrypt ta Google ko Apple. Asusun gwaji zai bayyana nan take.
- Maɓalli. A tashar yanar gizo (web terminal) ko a manhaja: Profile → API keys → asusun gwajinku → sashen Bot API keys → Generate API key. Ku kwafi apiKey da apiSecret: sirrin yana bayyana sau ɗaya kawai. Don mataimakin AI ko sa ido, tashar yanar gizo tana da zaɓin Generate read-only key (for MCP).
- Adireshi. A ɗakin karatun ku, ku sanya https://api.buycrypt.com maimakon https://fapi.binance.com. Hanyoyin /fapi/v1/… ba sa canzawa.
- Gwaji. Ku nemi ma'auni da GET /fapi/v2/balance: amsar za ta nuna USDT na asusun gwajin ku.
Abin da ya kamata ku sani
- Kwangilolin USDT kawai da yanayin matsayi ɗaya (one-way); ba a tallafa wa yanayin hedge ba.
- Farashin ticker: /fapi/v1/ticker/price. Hanyar /fapi/v2/ticker/price, wadda sababbin sigogin ɗakunan karatu ke kira, ba a tallafa mata ba tukuna.
- A stream na jama'a ana samun kyandiran @kline_1m (duk bayan daƙiƙa 5) da @markPrice (kowace daƙiƙa).
- recvWindow: 5,000 ms a asali, har zuwa 60,000 ms. Ku daidaita agogo ta /fapi/v1/time.
- Asusun da ke da maɓallin API na ciniki yana samun alamar 🤖 a jerin ƙima na manhaja: kowa yana ganin cewa shiri ne ke ciniki.
- Ikon maɓalli: maɓalli na yau da kullum (READ_TRADE) yana karantawa kuma yana ciniki, maɓallin karantawa kaɗai (READ) yana yin buƙatun GET da listenKey kawai. Idan aka nemi oda, soke oda, leverage ko margin da shi — HTTP 403 da lamba -2015.
import os from binance.um_futures import UMFutures client = UMFutures( key=os.environ["BUYCRYPT_API_KEY"], # maɓalli daga manhajar BuyCrypt secret=os.environ["BUYCRYPT_API_SECRET"], base_url="https://api.buycrypt.com", # layi ɗaya tilo da ke canzawa ) print(client.balance()) # USDT na asusun gwaji 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))
# bayanan jama'a, ba tare da maɓalli ba 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" # ma'aunin asusun gwaji: buƙata mai sa hannu 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"
Hanyoyi (methods)
Adireshin tushe na REST: https://api.buycrypt.com. Hanyoyi masu sa hannu suna buƙatar header X-MBX-APIKEY, timestamp da signature.
Bayanan kasuwa ba tare da maɓalli ba
Asusu da matsayai masu sa hannu
Ciniki masu sa hannu
Streams na WebSocket
Iyakoki da kurakurai
Masu biyan kuɗi ga bot ɗin ku (beta)
Za a iya yi wa bot rajista a matsayin na jama'a: mai amfani yana danna “Haɗa” a manhajar, BuyCrypt tana buɗe masa asusun gwaji na daban mai 1,000 USDT na gwaji kuma tana fitar da maɓalli na wannan asusu kawai. Maɓallin yana zuwa webhook ɗin ku a matsayin abin da ya faru subscription.created, kuma bot yana ciniki a asusun gwajin mai biyan kuɗin. Idan mai amfani ya cire haɗin, ana rufe matsayai, maɓallin ya daina aiki, kuma kuna karɓar subscription.disconnected.
Ba a ba bot asusun gaske ko maɓallan musayar kuɗi na masu amfani ba; maɓalli ne kawai na asusun gwaji na daban.
Rajista: POST /fapi/v1/bot/profiles mai sa hannu tare da sigogin slug, displayName, webhookUrl (HTTPS kawai) da webhookSecret (haruffa 32 ko fiye); bot yana samun matsayin PENDING_REVIEW har sai an duba shi. Kowane abin da ya faru yana da sa hannu: header X-BuyCrypt-Signature = HMAC-SHA256(webhookSecret, timestamp + "." + jiki), lokaci kuma a X-BuyCrypt-Timestamp. Ana maimaita isarwa har sau 6 (nan take, bayan daƙiƙa 10, daƙiƙa 30, minti 2, minti 10, awa 1); bayan isarwa 10 da suka kasa a jere, ana kashe webhook; tallafi zai taimaka a sake kunna shi.
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: # ya wuce minti 5: a ƙi 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"])
Maɓallin BuyCrypt yana buɗe asusun gwaji kawai
An ɗaure shi da asusu ɗaya
Ana ƙirƙirar maɓallin API don takamaiman asusun gwaji, kuma da shi kaɗai yake aiki. Ba a samun ainihin asusun musayar (exchange) ta wannan API. Maɓallin karantawa kaɗai ba ya ciniki ko a wannan asusun.
Ana nuna sirrin sau ɗaya
Ku adana maɓalli da sirri a cikin environment variables ko manajan sirri, ba a cikin lamba ko a ma'ajiyar jama'a ba.
Soke cikin daƙiƙa ɗaya
A tashar yanar gizo ko a manhaja, a cikin sashen "Bot API keys" ɗin, ku danna "Revoke": duk buƙatun da ke amfani da wannan maɓallin za su sami kuskure 401 nan take.
Tambayoyin da ake yawan yi
Bot yana ciniki da kuɗi na gaske?
A'a. API ɗin BuyCrypt yana aiwatar da oda a asusun gwajin ku: farashin kasuwa ne, ma'auni a USDT na gwaji. Ba a tura oda zuwa musayar kuɗi, don haka za a iya gwada dabara ba tare da haɗari ba.
Dole ne a sake rubuta bot don BuyCrypt?
Yawanci a'a. Idan bot yana aiki da Binance USD-M Futures, ku sauya adireshin tushe zuwa https://api.buycrypt.com ku sanya maɓallin BuyCrypt. Hanyoyi, sa hannu da tsarin amsoshi iri ɗaya ne. Ku tabbatar cewa bot ba ya amfani da yanayin hedge da hanyar /fapi/v2/ticker/price.
A ina ake samun maɓallin API?
A tashar yanar gizo (web terminal) ko manhajar BuyCrypt: Profile → API keys → asusun gwajinku → Bot API keys → Generate API key. Don MCP da mataimakan AI — "Generate read-only key (for MCP)" a tashar yanar gizo: irin wannan maɓallin yana ganin asusun, amma ba ya ciniki. Sirrin yana bayyana sau ɗaya kawai, ku ajiye shi nan take. A can ne kuma ake janye maɓallin.
Menene MCP kuma me ya sa ake buƙatarsa?
MCP (Model Context Protocol) buɗaɗɗen ma'auni ne da mataimakan AI ke amfani da shi don haɗa bayanai na waje. Idan kun haɗa sabar https://buycrypt.com/mcp, za ku iya tambayar Claude, ChatGPT ko Cursor game da gasanni, jagorori da fasfo na ɗan kasuwa, kuma mataimaki zai amsa da bayanan BuyCrypt kai tsaye.
Ana buƙatar rajista don haɗa MCP?
A'a. Gasanni, ƙima, fasfo na 'yan kasuwa da farashi suna nan ba tare da maɓalli ba. Ana buƙatar maɓalli ne kawai don kayan aiki uku da ke karanta asusun gwajinku, kuma maɓallin karantawa kaɗai ya isa.
Mataimakin AI zai iya yin ciniki ta MCP?
A'a. Dukkan kayan aiki tara na sabar suna karanta bayanai ne kawai: ba a sanya ko soke oda, ba wanda ke shiga gasa, ba a tura kuɗi.
Mai haɓaka bot zai samu maɓallan musayar kuɗi na?
A'a. Idan kun haɗa bot na wani, BuyCrypt tana buɗe masa asusun gwaji na daban kuma tana ba shi maɓalli na wannan asusu kawai. Ba a ba bot asusun ku na gaske ko maɓallan musayar kuɗin ku ba. Ƙarin bayani game da kare bayanai yana a shafin “Tsaro”.
Ku fara da asusun gwaji
Asusun BuyCrypt kyauta ne: asusun gwaji don bot, maɓallin API a manhajar, gasanni da ƙima inda ake ganin darajar dabara.