BuyCrypt
Untuk developer dan asisten AI

API untuk bot trading dan MCP untuk AI

Bot yang ditulis untuk Binance USD-M Futures berjalan di akun demo BuyCrypt tanpa perlu ditulis ulang: yang berubah hanya alamat API. Lalu Claude, ChatGPT, dan Cursor melalui server MCP BuyCrypt bisa melihat turnamen, rating trader, dan akun demo Anda.

Hubungkan asisten AI Dokumentasi API
1 barisdi kode bot: base URL yang berbeda
500+kontrak perpetual USDT
9tool MCP, semuanya hanya membaca
api.buycrypt.comrespons langsung
GET https://api.buycrypt.com/fapi/v1/ticker/price?symbol=BTCUSDT
{ "symbol": "BTCUSDT", "price": "…" }
# bot Anda di Binance USD-M Futures
- base_url="https://fapi.binance.com"
+ base_url="https://api.buycrypt.com"
Dua cara terhubung

Bot melakukan trading. Asisten menjawab pertanyaan.

API untuk bot trading

Format permintaan, tanda tangan, dan respons sama seperti Binance USD-M Futures. Bot memasang order di akun demo BuyCrypt Anda: harganya harga pasar, uangnya uang demo.

  • Library yang sama: binance-futures-connector, atau kode Anda sendiri dengan requests
  • REST, WebSocket privat lewat listenKey, candle dan mark price di stream
  • Kunci dibuat di aplikasi dan hanya berlaku untuk satu akun demo
Dokumentasi API →

MCP untuk asisten AI

Satu alamat di pengaturan Claude, ChatGPT, atau Cursor, dan asisten akan mengambil data BuyCrypt sendiri saat Anda menanyakannya.

  • Turnamen, hadiah, tabel peserta, pemimpin per koin
  • Paspor trader: rating dari 1000, level, gaya trading
  • Akun demo Anda: saldo, posisi, order (dengan kunci hanya-baca)
Hubungkan dalam semenit →
MCP · Model Context Protocol

MCP: hubungkan BuyCrypt ke Claude, ChatGPT, dan Cursor

MCP adalah standar terbuka yang dipakai asisten AI untuk terhubung ke data dan tool eksternal. Server BuyCrypt memberikan data platform secara langsung kepada asisten. Tidak perlu registrasi maupun kunci; kunci hanya diperlukan untuk akun demo Anda.

https://buycrypt.com/mcp
Streamable HTTPtanpa loginhanya baca
  1. Buka claude.ai atau aplikasi Claude Desktop → Customize → Connectors.
  2. Klik + Add → Add custom connector.
  3. Nama — BuyCrypt, alamat — https://buycrypt.com/mcp, lalu Continue.
  4. Di bagian Authentication pilih No sign in lalu klik Add.

Konektor kustom tersedia di semua paket Claude; di paket gratis hanya satu. Di Team dan Enterprise, konektor ditambahkan oleh pemilik organisasi di Organization settings → Connectors. Untuk akun demo Anda, tambahkan kunci di blok Request headers pada jendela yang sama — caranya.

  1. Jalankan satu perintah di terminal:
Terminal
claude mcp add --transport http buycrypt https://buycrypt.com/mcp

Pengecekan: claude mcp list — buycrypt akan muncul di daftar. Tambahkan --scope user agar server tersedia di semua proyek.

  1. Buka chatgpt.com/plugins di browser.
  2. Klik + → Add custom MCP server.
  3. Nama — BuyCrypt; di bagian Connection pilih alamat publik dan isi https://buycrypt.com/mcp.
  4. Authentication — No authentication. Konfirmasi peringatan I understand and want to continue lalu klik Create.

Server MCP kustom di ChatGPT hanya bisa ditambahkan di versi web dan tidak tersedia di semua paket. Jika menunya tidak ada, berarti dibatasi oleh paket Anda atau administrator workspace. Akun demo Anda tidak bisa dihubungkan ke ChatGPT karena ChatGPT tidak meneruskan kunci ke server. Untuk itu, gunakan Claude, Claude Code, atau Cursor.

Tambahkan ke Cursor

Tombol ini membuka Cursor dengan pengaturan yang sudah siap. Atau secara manual: tambahkan ke ~/.cursor/mcp.json (untuk semua proyek) atau .cursor/mcp.json di root proyek:

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

Klien apa pun yang mendukung Streamable HTTP bisa dipakai: isi alamat https://buycrypt.com/mcp, tanpa otorisasi. Jika klien hanya bisa menjalankan server lokal (stdio), hubungkan lewat jembatan mcp-remote (butuh Node.js):

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

Cek server tanpa asisten: npx @modelcontextprotocol/inspector --cli https://buycrypt.com/mcp --transport http --method tools/list

Kemampuan server

platform_overview

Turnamen apa yang sedang berjalan, mana yang dimulai berikutnya, berapa trader di turnamen, hadiah terbaru.

tanpa kunci
list_tournaments

Turnamen yang berjalan, yang akan datang, dan yang sudah selesai: koin, metode penilaian, total hadiah, biaya masuk, peserta.

tanpa kunci
get_tournament

Satu turnamen: hadiah per peringkat dan tabel peserta beserta hasilnya.

tanpa kunci
leaderboard

Pemimpin per koin selama 7, 30, atau 90 hari — seperti di halaman “Trader teratas”.

tanpa kunci
trader_profile

Paspor trader berdasarkan nama panggilan: rating dari 1000, level, lima komponen penilaian, gaya. Hanya profil terbuka.

tanpa kunci
market_ticker

Harga dan perubahan 24 jam untuk kontrak perpetual, misalnya BTCUSDT.

tanpa kunci
demo_account

Saldo, margin, dan posisi terbuka akun demo Anda.

kunci Anda
demo_open_orders

Order terbuka di akun demo Anda.

kunci Anda
demo_recent_results

Hasil terbaru akun demo: profit dan rugi dari transaksi tertutup, biaya.

kunci Anda

Tidak ada tool yang memasang order, ikut turnamen, atau memindahkan uang — server hanya membaca.

Apa yang bisa ditanyakan ke asisten

Klik pertanyaan untuk menyalinnya.

Contoh langsung

Beginilah asisten melihat BuyCrypt

Di bawah ini respons asli dari server https://buycrypt.com/mcp saat ini juga. Asisten menerima data yang sama dan menyampaikannya dengan kata-katanya sendiri.

Tampilkan 5 trader teratas bulan ini untuk BTC
asisten memanggil leaderboard{"coin":"BTC","period_days":30,"limit":5}
Memuat respons server…
Dengan kunci Anda

Akun demo Anda di asisten

Alat demo_account, demo_open_orders, dan demo_recent_results membaca akun demo Anda. Untuk alat-alat ini, klien mengirim kunci API Anda ke server dalam dua header: X-BuyCrypt-Api-Key dan X-BuyCrypt-Api-Secret. Buat kunci hanya-baca untuk asisten: kunci ini bisa melihat saldo, posisi, dan order, tetapi BuyCrypt tidak akan menjalankan order, pembatalan, atau perubahan leverage dengan kunci ini (respons 403). Cara mendapatkannya.

Terminal
claude mcp add --transport http buycrypt https://buycrypt.com/mcp \
  --header "X-BuyCrypt-Api-Key: API_KEY_ANDA" \
  --header "X-BuyCrypt-Api-Secret: API_SECRET_ANDA"
mcp.json
{
  "mcpServers": {
    "buycrypt": {
      "url": "https://buycrypt.com/mcp",
      "headers": {
        "X-BuyCrypt-Api-Key": "API_KEY_ANDA",
        "X-BuyCrypt-Api-Secret": "API_SECRET_ANDA"
      }
    }
  }
}
  1. Saat menambahkan konektor (Customize → Connectors → Add custom connector), setelah alamat pilih No sign in.
  2. Di blok Request headers tambahkan dua header: X-BuyCrypt-Api-Key dan X-BuyCrypt-Api-Secret dengan nilai milik Anda.
  3. Klik Add. Jika konektor sudah ditambahkan tanpa kunci, hapus lalu tambahkan lagi dengan header.

Hanya baca

Server MCP tidak memasang dan tidak membatalkan order. Server membutuhkan kunci untuk membaca saldo, posisi, dan order. Kunci hanya-baca tidak bisa dipakai untuk trading, meskipun jatuh ke tangan orang lain.

Satu akun demo

Kunci BuyCrypt hanya berlaku untuk akun demo tempat kunci itu dibuat. Kunci ini tidak memberi akses ke akun bursa sungguhan.

Kunci terpisah

Buat kunci hanya-baca terpisah untuk asisten. Kunci hanya dikirim ke buycrypt.com; server tidak menyimpannya dan tidak mencatatnya di log. Anda bisa mencabutnya di tempat yang sama saat membuatnya.

API untuk bot trading

API yang kompatibel dengan Binance USD-M Futures

Path, tanda tangan HMAC-SHA256, parameter, dan format respons sama seperti Binance USD-M Futures. Bedanya hanya satu: order dieksekusi di akun demo BuyCrypt Anda dengan harga pasar dan tidak dikirim ke bursa sungguhan. Jadi strategi bisa diuji di pasar tanpa mempertaruhkan uang.

Cara memulai

  1. Akun. Masuk ke terminal web atau aplikasi BuyCrypt dengan Google atau Apple. Akun demo langsung tersedia.
  2. Kunci. Di terminal web atau aplikasi: Profil → Kunci API → akun demo Anda → bagian Bot API keys → Generate API key. Salin apiKey dan apiSecret: secret hanya ditampilkan sekali. Untuk asisten AI atau pemantauan, terminal web punya tombol Generate read-only key (for MCP).
  3. Alamat. Di library Anda, isi https://api.buycrypt.com sebagai ganti https://fapi.binance.com. Path /fapi/v1/… tetap sama.
  4. Pengecekan. Minta saldo — GET /fapi/v2/balance: respons akan berisi USDT akun demo Anda.

Yang perlu diketahui

  • Hanya kontrak USDT dan mode satu posisi (one-way); mode hedge tidak didukung.
  • Harga ticker — /fapi/v1/ticker/price. Path /fapi/v2/ticker/price yang dipanggil versi library terbaru belum didukung.
  • Stream publik mengirim candle @kline_1m (setiap 5 detik) dan @markPrice (setiap detik).
  • recvWindow — 5.000 ms secara default, hingga 60.000 ms. Sinkronkan jam melalui /fapi/v1/time.
  • Akun dengan kunci API trading mendapat ikon 🤖 di papan peringkat aplikasi: semua orang bisa melihat bahwa yang melakukan trading adalah program.
  • Hak akses kunci: kunci biasa (READ_TRADE) bisa membaca dan trading, kunci hanya-baca (READ) hanya untuk permintaan GET dan listenKey. Order, pembatalan, leverage, atau margin dengan kunci ini akan dijawab HTTP 403 dan kode -2015.
pip install binance-futures-connector
import os
from binance.um_futures import UMFutures

client = UMFutures(
    key=os.environ["BUYCRYPT_API_KEY"],        # kunci dari aplikasi BuyCrypt
    secret=os.environ["BUYCRYPT_API_SECRET"],
    base_url="https://api.buycrypt.com",      # satu-satunya baris yang berubah
)

print(client.balance())                             # USDT akun demo
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
# data publik — tanpa kunci
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"

# saldo akun demo — permintaan bertanda tangan
KEY="API_KEY_ANDA"; SECRET="API_SECRET_ANDA"
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"

Metode

Alamat dasar REST — https://api.buycrypt.com. Metode bertanda tangan memerlukan header X-MBX-APIKEY, timestamp, dan signature.

Data pasar tanpa kunci
GET/fapi/v1/ping · /fapi/v1/timeCek koneksi dan waktu server dalam ms.
GET/fapi/v1/exchangeInfoKontrak, filter harga dan kuantitas, batas.
GET/fapi/v1/ticker/price · /ticker/24hr · /ticker/bookTickerHarga terakhir, statistik 24 jam, harga beli dan jual terbaik.
GET/fapi/v1/depth · /fapi/v1/klinesOrder book dan candle.
GET/fapi/v1/premiumIndex · /fapi/v1/fundingRateMark price, indeks, dan funding rate.
Akun dan posisi bertanda tangan
GET/fapi/v2/account · /fapi/v3/accountSaldo, margin, dan posisi dalam satu respons (v1, v2, dan v3 sama).
GET/fapi/v2/balance · /fapi/v3/balanceSaldo akun demo, hanya USDT.
GET/fapi/v2/positionRisk · /fapi/v3/positionRiskPosisi terbuka: harga masuk, mark price, hasil yang belum terealisasi, harga likuidasi.
GET/fapi/v1/userTrades · /fapi/v1/incomeTransaksi per simbol dan riwayat hasil: profit dan rugi, biaya.
GET/fapi/v1/commissionRate · /fapi/v1/leverageBracketBiaya per simbol dan tingkat leverage.
Trading bertanda tangan
POST/fapi/v1/orderOrder baru: MARKET, LIMIT, STOP, STOP_MARKET, TAKE_PROFIT, TAKE_PROFIT_MARKET, TRAILING_STOP_MARKET; reduceOnly, closePosition, timeInForce, newClientOrderId.
GET/fapi/v1/order · /openOrders · /allOrdersSatu order, order terbuka, riwayat.
PUT/fapi/v1/orderUbah limit order.
DELETE/fapi/v1/order · /allOpenOrdersBatalkan satu order atau semua order per simbol.
POST/fapi/v1/batchOrdersBeberapa order dalam satu permintaan; DELETE — pembatalan sekaligus.
POST/fapi/v1/algoOrderOrder bersyarat (stop, take profit, trailing); GET /openAlgoOrders, /allAlgoOrders, DELETE /algoOrder, /algoOpenOrders.
POST/fapi/v1/leverage · /fapi/v1/marginTypeLeverage dan tipe margin per simbol.
GET/fapi/v1/positionSide/dualSelalu dualSidePosition: false — mode satu posisi.
Stream WebSocket
POST/fapi/v1/listenKeyKunci stream privat berlaku 60 menit; PUT memperpanjang, DELETE menutup.
WSwss://api.buycrypt.com/fapi/ws/<listenKey>Event akun Anda: ORDER_TRADE_UPDATE, ACCOUNT_UPDATE, MARGIN_CALL — dalam format Binance.
WSwss://api.buycrypt.com/fapi/ws-market/btcusdt@markPriceStream publik untuk satu pasar: @markPrice dan @kline_1m.
WSwss://api.buycrypt.com/stream?streams=btcusdt@markPrice/ethusdt@kline_1mBeberapa stream dalam satu koneksi, respons dibungkus {"stream", "data"}.
Batas dan error
1 mntbobot 2.400 · 1.200 pembacaan bertanda tanganPer API key. Respons memuat header X-MBX-USED-WEIGHT-1M dan X-MBX-ORDER-COUNT-10S.
10 dtk300 orderJika batas terlampaui — HTTP 429 dan Retry-After.
ERR-1021 · -1022 · -2014 · -2015Waktu di luar recvWindow · tanda tangan salah · format kunci salah · kunci dicabut atau salah (HTTP 401), kunci hanya-baca tetapi permintaannya trading (HTTP 403).
ERR-1102 · -2010 · -2011 · -2019Parameter wajib tidak ada · order ditolak · order tidak ditemukan · margin tidak cukup.
Subscriber untuk bot Anda (beta)

Bot bisa didaftarkan sebagai bot publik: pengguna menekan “Hubungkan” di aplikasi, BuyCrypt membukakan akun demo terpisah berisi 1.000 USDT demo dan menerbitkan kunci khusus untuk akun itu. Kunci dikirim ke webhook Anda lewat event subscription.created, lalu bot melakukan trading di akun demo subscriber. Saat pengguna memutuskan koneksi, posisi ditutup, kunci berhenti berlaku, dan Anda menerima subscription.disconnected.

Bot tidak menerima akun sungguhan maupun kunci bursa milik pengguna — hanya kunci ke akun demo terpisah.

Registrasi — POST /fapi/v1/bot/profiles bertanda tangan dengan parameter slug, displayName, webhookUrl (hanya HTTPS), dan webhookSecret (minimal 32 karakter); bot berstatus PENDING_REVIEW sampai diperiksa. Setiap event ditandatangani: header X-BuyCrypt-Signature = HMAC-SHA256(webhookSecret, timestamp + "." + body), waktunya ada di X-BuyCrypt-Timestamp. Pengiriman diulang hingga 6 kali (langsung, setelah 10 dtk, 30 dtk, 2 mnt, 10 mnt, 1 jam); setelah 10 kali gagal berturut-turut, webhook dinonaktifkan — dukungan dapat membantu mengaktifkannya lagi.

Verifikasi tanda tangan 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:   # lebih dari 5 menit — tolak
        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"])
Kunci dan keamanan

Kunci BuyCrypt hanya membuka akun demo

Terikat ke satu akun

Kunci API dibuat untuk satu akun demo tertentu dan hanya berfungsi dengan akun itu. Akun nyata di bursa tidak dapat diakses melalui API ini. Kunci hanya-baca juga tidak bisa trading di akun ini.

Secret hanya ditampilkan sekali

Simpan kunci dan secret di environment variable atau secret manager, bukan di kode dan bukan di repositori publik.

Pencabutan dalam sedetik

Di terminal web atau aplikasi, di bagian “Bot API keys” yang sama, tekan “Revoke”: semua permintaan dengan kunci ini akan langsung mendapat error 401.

Pertanyaan

Pertanyaan umum

Apakah bot trading dengan uang sungguhan?

Tidak. API BuyCrypt mengeksekusi order di akun demo Anda: harganya harga pasar, saldonya dalam USDT demo. Order tidak dikirim ke bursa, jadi strategi bisa diuji tanpa risiko.

Apakah bot perlu ditulis ulang untuk BuyCrypt?

Biasanya tidak. Jika bot bekerja dengan Binance USD-M Futures, ganti alamat dasar menjadi https://api.buycrypt.com dan masukkan kunci BuyCrypt. Path, tanda tangan, dan format respons tetap sama. Pastikan bot tidak memakai mode hedge dan path /fapi/v2/ticker/price.

Di mana mendapatkan API key?

Di terminal web atau aplikasi BuyCrypt: Profil → Kunci API → akun demo Anda → Bot API keys → Generate API key. Untuk MCP dan asisten AI, gunakan “Generate read-only key (for MCP)” di terminal web: kunci ini bisa melihat akun, tetapi tidak bisa trading. Secret hanya ditampilkan sekali, jadi segera simpan. Di tempat yang sama kunci juga bisa dicabut.

Apa itu MCP dan untuk apa?

MCP (Model Context Protocol) adalah standar terbuka yang dipakai asisten AI untuk terhubung ke data eksternal. Setelah menghubungkan server https://buycrypt.com/mcp, Anda bisa bertanya kepada Claude, ChatGPT, atau Cursor tentang turnamen, pemimpin peringkat, dan paspor trader, dan asisten akan menjawab berdasarkan data BuyCrypt secara langsung.

Apakah perlu registrasi untuk menghubungkan MCP?

Tidak. Turnamen, papan peringkat, paspor trader, dan harga tersedia tanpa kunci. Kunci hanya diperlukan untuk tiga alat yang membaca akun demo Anda, dan kunci hanya-baca sudah cukup.

Bisakah asisten AI melakukan trading lewat MCP?

Tidak. Kesembilan tool server hanya membaca data: tidak ada order yang dipasang atau dibatalkan, tidak ada yang ikut turnamen, dan tidak ada uang yang dipindahkan.

Apakah developer bot akan menerima kunci bursa saya?

Tidak. Saat Anda menghubungkan bot milik orang lain, BuyCrypt membuka akun demo terpisah untuknya dan hanya memberikan kunci ke akun itu. Akun sungguhan dan kunci bursa Anda tidak diberikan ke bot. Selengkapnya tentang perlindungan data ada di halaman “Keamanan”.

Mulai dengan akun demo

Akun BuyCrypt gratis: akun demo untuk bot, API key di aplikasi, serta turnamen dan peringkat yang menunjukkan seberapa bagus strategi Anda.

Buka terminal web Unduh aplikasi
Trader teratasPaspor traderTurnamen gratisSemua turnamenPanduan tradingKeamanan