Trading botları için API ve yapay zekâ için MCP
Binance USD-M Futures için yazılmış bir bot, BuyCrypt demo hesabında yeniden yazılmadan çalışır: yalnızca API adresi değişir. Claude, ChatGPT ve Cursor ise BuyCrypt MCP sunucusu üzerinden turnuvaları, trader sıralamasını ve demo hesabınızı görür.
{ "symbol": "BTCUSDT", "price": "…" }
Bot işlem yapar. Asistan soruları yanıtlar.
Trading botları için API
İstek, imza ve yanıt formatı Binance USD-M Futures ile aynı. Bot, emirleri BuyCrypt demo hesabınızda verir: fiyatlar piyasa fiyatları, para demo.
- Aynı kütüphaneler: binance-futures-connector, requests ile kendi kodunuz
- REST, listenKey ile özel WebSocket, akışta mumlar ve işaret fiyatı
- Anahtar uygulamada oluşturulur ve yalnızca tek bir demo hesapla çalışır
Yapay zekâ asistanları için MCP
Claude, ChatGPT veya Cursor ayarlarında tek bir adres; siz sorduğunuzda asistan BuyCrypt verilerini kendisi alır.
- Turnuvalar, ödüller, katılımcı tablosu, coin bazında liderler
- Trader pasaportu: 1000 üzerinden puan, seviye, işlem tarzı
- Demo hesabınız: bakiye, pozisyonlar, emirler (salt okunur anahtarla)
MCP: BuyCrypt'i Claude, ChatGPT ve Cursor'a bağlayın
MCP, yapay zekâ asistanlarının harici verileri ve araçları bağlamasını sağlayan açık bir standarttır. BuyCrypt sunucusu asistana platformun canlı verilerini verir. Kayıt ve anahtar gerekmez; anahtar yalnızca demo hesabınız için gerekir.
https://buycrypt.com/mcp
- claude.ai sitesini veya Claude Desktop uygulamasını açın → Customize → Connectors.
- + Add → Add custom connector seçeneğine tıklayın.
- Ad: BuyCrypt, adres: https://buycrypt.com/mcp, ardından Continue.
- Authentication bölümünde No sign in seçin ve Add'e tıklayın.
Özel bağlayıcılar tüm Claude planlarında var, ücretsiz planda bir tane. Team ve Enterprise ekiplerinde bağlayıcıyı kuruluş sahibi Organization settings → Connectors bölümünden ekler. Kendi demo hesabınız için anahtarı aynı penceredeki Request headers bloğuna ekleyin — nasıl yapılır.
- Terminalde tek bir komut çalıştırın:
claude mcp add --transport http buycrypt https://buycrypt.com/mcp
Kontrol: claude mcp list — listede buycrypt görünür. Sunucunun tüm projelerde kullanılabilmesi için --scope user ekleyin.
- Tarayıcıda chatgpt.com/plugins adresini açın.
- + → Add custom MCP server seçeneğine tıklayın.
- Ad: BuyCrypt; Connection bölümünde herkese açık adresi seçin ve https://buycrypt.com/mcp yazın.
- Authentication: No authentication. I understand and want to continue uyarısını onaylayın ve Create'e tıklayın.
ChatGPT'de özel MCP sunucuları yalnızca web sürümünde eklenir ve her planda bulunmaz. Seçenek görünmüyorsa planınız veya çalışma alanı yöneticisi kapatmıştır. ChatGPT'ye kendi demo hesabınızı bağlayamazsınız: sunucuya anahtar iletmez. Bunun için Claude, Claude Code ve Cursor uygundur.
Düğme Cursor'ı hazır ayarla açar. Ya da elle: ~/.cursor/mcp.json dosyasına (tüm projeler için) veya proje kökündeki .cursor/mcp.json dosyasına ekleyin:
{
"mcpServers": {
"buycrypt": {
"url": "https://buycrypt.com/mcp"
}
}
}Streamable HTTP destekleyen her istemci uygundur: https://buycrypt.com/mcp adresini girin, yetkilendirme gerekmez. İstemci yalnızca yerel sunucuları (stdio) çalıştırabiliyorsa mcp-remote köprüsüyle bağlayın; Node.js gerekir:
{
"mcpServers": {
"buycrypt": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://buycrypt.com/mcp"]
}
}
}Sunucuyu asistan olmadan test edin: npx @modelcontextprotocol/inspector --cli https://buycrypt.com/mcp --transport http --method tools/list
Sunucu neler yapabilir
platform_overviewŞu anda hangi turnuvalar sürüyor, sıradaki hangisi, turnuvalarda kaç trader var, son ödüller.
anahtarsızlist_tournamentsDevam eden, yaklaşan ve biten turnuvalar: coin, puanlama yöntemi, ödül havuzu, giriş, katılımcılar.
anahtarsızget_tournamentTek bir turnuva: sıralara göre ödüller ve sonuçlarıyla katılımcı tablosu.
anahtarsızleaderboard7, 30 veya 90 günde coin bazında liderler — «En iyi trader'lar» sayfasındaki gibi.
anahtarsıztrader_profileKullanıcı adına göre trader pasaportu: 1000 üzerinden puan, seviye, değerlendirmenin beş bölümü, tarz. Yalnızca herkese açık profiller.
anahtarsızmarket_tickerSüresiz kontratta fiyat ve 24 saatlik değişim, örneğin BTCUSDT.
anahtarsızdemo_accountDemo hesabınızın bakiyesi, marjı ve açık pozisyonları.
anahtarınızdemo_open_ordersDemo hesabınızın açık emirleri.
anahtarınızdemo_recent_resultsDemo hesabın son sonuçları: kapanan işlemlerin kâr ve zararı, komisyonlar.
anahtarınızHiçbir araç emir vermez, turnuvaya katılmaz veya para transfer etmez — sunucu yalnızca okur.
Asistana ne sorabilirsiniz
Kopyalamak için soruya tıklayın.
Asistan BuyCrypt'i böyle görür
Aşağıda https://buycrypt.com/mcp sunucusunun şu anki gerçek yanıtı var. Asistan aynı verileri alır ve kendi sözleriyle aktarır.
Demo hesabınız asistanda
demo_account, demo_open_orders ve demo_recent_results araçları demo hesabınızı okur. Bunlar için istemci, API anahtarınızı sunucuya iki başlıkta iletir: X-BuyCrypt-Api-Key ve X-BuyCrypt-Api-Secret. Asistan için salt okunur bir anahtar oluşturun: bu anahtar bakiyeyi, pozisyonları ve emirleri görür, ancak BuyCrypt bu anahtarla emir, iptal veya kaldıraç değişikliği yapmaz (403 yanıtı). Nasıl alınır.
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"
}
}
}
}- Bağlayıcıyı eklerken (Customize → Connectors → Add custom connector) adresten sonra No sign in seçin.
- Request headers bloğuna iki başlık ekleyin: X-BuyCrypt-Api-Key ve X-BuyCrypt-Api-Secret, kendi değerlerinizle.
- Add'e tıklayın. Bağlayıcı daha önce anahtarsız eklendiyse silin ve başlıklarla yeniden ekleyin.
Yalnızca okuma
MCP sunucusu emir vermez ve emirleri iptal etmez. Anahtara bakiyeyi, pozisyonları ve emirleri okumak için ihtiyaç duyar. Salt okunur anahtar, başkasının eline geçse bile işlem yapmaya izin vermez.
Tek demo hesap
BuyCrypt anahtarı yalnızca oluşturulduğu demo hesapla çalışır. Gerçek borsa hesaplarına erişim vermez.
Ayrı anahtar
Asistan için ayrı bir salt okunur anahtar oluşturun. Anahtar yalnızca buycrypt.com'a gider; sunucu onu saklamaz ve günlüklere yazmaz. Anahtarı oluşturduğunuz yerden iptal edebilirsiniz.
Binance USD-M Futures uyumlu API
Yollar, HMAC-SHA256 imzası, parametreler ve yanıt formatı Binance USD-M Futures ile aynıdır. Tek fark: emirler piyasa fiyatlarıyla BuyCrypt demo hesabınızda gerçekleşir, gerçek borsaya gitmez. Böylece stratejinizi parayı riske atmadan piyasada test edebilirsiniz.
Nasıl başlanır
- Hesap. Web terminaline veya BuyCrypt uygulamasına Google ya da Apple ile giriş yapın. Demo hesap hemen oluşur.
- Anahtar. Web terminalinde veya uygulamada: Profil → API anahtarları → demo hesabınız → Bot API keys bölümü → Generate API key. apiKey ve apiSecret değerlerini kopyalayın: gizli anahtar yalnızca bir kez gösterilir. Yapay zekâ asistanı veya izleme için web terminalinde Generate read-only key (for MCP) düğmesi vardır.
- Adres. Kütüphanenizde https://api.buycrypt.com adresini https://fapi.binance.com yerine yazın. /fapi/v1/… yolları aynı kalır.
- Kontrol. Bakiyeyi isteyin — GET /fapi/v2/balance: yanıtta demo hesabınızın USDT bakiyesi olur.
Bilmeniz gerekenler
- Yalnızca USDT kontratları ve tek pozisyon modu (one-way); hedge modu desteklenmez.
- Ticker fiyatı: /fapi/v1/ticker/price. Kütüphanelerin yeni sürümlerinin çağırdığı /fapi/v2/ticker/price yolu henüz desteklenmiyor.
- Herkese açık akışta @kline_1m mumları (5 saniyede bir) ve @markPrice (saniyede bir) gelir.
- recvWindow varsayılan olarak 5.000 ms, en fazla 60.000 ms. Saatinizi /fapi/v1/time ile eşitleyin.
- İşlem yetkili API anahtarı olan hesap, uygulamadaki liderlik tablosunda 🤖 simgesi alır: işlemleri bir programın yaptığını herkes görür.
- Anahtar yetkileri: normal anahtar (READ_TRADE) okur ve işlem yapar, salt okunur anahtar (READ) yalnızca GET isteklerine ve listenKey işlemine izin verir. Bu anahtarla emir, iptal, kaldıraç veya marjin isteği gönderilirse HTTP 403 ve -2015 kodu döner.
import os from binance.um_futures import UMFutures client = UMFutures( key=os.environ["BUYCRYPT_API_KEY"], # BuyCrypt uygulamasındaki anahtar secret=os.environ["BUYCRYPT_API_SECRET"], base_url="https://api.buycrypt.com", # değişen tek satır ) print(client.balance()) # demo hesabın USDT bakiyesi 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))
# herkese açık veriler — anahtar gerekmez 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" # demo hesap bakiyesi — imzalı istek 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"
Metotlar
REST temel adresi: https://api.buycrypt.com. İmzalı metotlar X-MBX-APIKEY başlığı, timestamp ve signature gerektirir.
Piyasa verileri anahtarsız
Hesap ve pozisyonlar imzalı
İşlem imzalı
WebSocket akışları
Limitler ve hatalar
Botunuz için aboneler (beta)
Botu herkese açık olarak kaydedebilirsiniz: kullanıcı uygulamada «Bağlan»a dokunur, BuyCrypt ona 1.000 demo USDT ile ayrı bir demo hesap açar ve yalnızca bu hesaba erişen bir anahtar üretir. Anahtar subscription.created olayıyla webhook'unuza gelir ve bot abonenin demo hesabında işlem yapar. Kullanıcı bağlantıyı kestiğinde pozisyonlar kapanır, anahtar çalışmayı bırakır ve size subscription.disconnected gelir.
Kullanıcıların gerçek hesapları ve borsa anahtarları bota iletilmez — yalnızca ayrı demo hesabın anahtarı.
Kayıt: slug, displayName, webhookUrl (yalnızca HTTPS) ve webhookSecret (en az 32 karakter) parametreleriyle imzalı POST /fapi/v1/bot/profiles; bot inceleme tamamlanana kadar PENDING_REVIEW durumunda kalır. Her olay imzalıdır: X-BuyCrypt-Signature başlığı = HMAC-SHA256(webhookSecret, timestamp + "." + gövde), zaman X-BuyCrypt-Timestamp başlığında. Teslimat en fazla 6 kez tekrarlanır (hemen, 10 sn, 30 sn, 2 dk, 10 dk, 1 sa sonra); art arda 10 başarısız teslimattan sonra webhook devre dışı kalır — yeniden açmak için desteğe başvurun.
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 dakikadan eski — reddet 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 anahtarı yalnızca demo hesabı açar
Tek hesaba bağlı
API anahtarı belirli bir demo hesap için oluşturulur ve yalnızca onunla çalışır. Borsalardaki gerçek hesaplara bu API üzerinden erişilemez. Salt okunur anahtar bu hesapta da işlem yapmaz.
Secret yalnızca bir kez gösterilir
Anahtarı ve secret'ı kodda veya herkese açık depolarda değil, ortam değişkenlerinde ya da bir secret yöneticisinde saklayın.
Bir saniyede iptal
Web terminalinde veya uygulamada, aynı “Bot API keys” bölümünde “Revoke” düğmesine basın: bu anahtarla gönderilen tüm istekler hemen 401 hatası alır.
Sık sorulan sorular
Bot gerçek parayla mı işlem yapar?
Hayır. BuyCrypt API emirleri demo hesabınızda gerçekleştirir: fiyatlar piyasa fiyatları, bakiye demo USDT. Emirler borsaya gönderilmez, bu yüzden stratejinizi risksiz test edebilirsiniz.
Botu BuyCrypt için yeniden yazmak gerekir mi?
Genellikle hayır. Bot Binance USD-M Futures ile çalışıyorsa temel adresi https://api.buycrypt.com ile değiştirin ve BuyCrypt anahtarını girin. Yollar, imza ve yanıt formatı aynıdır. Botun hedge modunu ve /fapi/v2/ticker/price yolunu kullanmadığını kontrol edin.
API anahtarı nereden alınır?
BuyCrypt web terminalinde veya uygulamasında: Profil → API anahtarları → demo hesabınız → Bot API keys → Generate API key. MCP ve yapay zekâ asistanları için web terminalinde “Generate read-only key (for MCP)” düğmesini kullanın: bu anahtar hesabı görür ama işlem yapmaz. Gizli anahtar yalnızca bir kez gösterilir, hemen kaydedin. Anahtarı aynı yerden iptal edebilirsiniz.
MCP nedir ve ne işe yarar?
MCP (Model Context Protocol), yapay zekâ asistanlarının harici verileri bağlamasını sağlayan açık bir standarttır. https://buycrypt.com/mcp sunucusunu bağladığınızda Claude, ChatGPT veya Cursor'a turnuvaları, liderleri ve trader pasaportunu sorabilirsiniz; asistan BuyCrypt'in canlı verileriyle yanıt verir.
MCP'yi bağlamak için kayıt gerekir mi?
Hayır. Turnuvalar, liderlik tablosu, trader pasaportları ve fiyatlar anahtarsız görüntülenebilir. Anahtar yalnızca demo hesabınızı okuyan üç araç için gerekir ve salt okunur bir anahtar yeterlidir.
Yapay zekâ asistanı MCP üzerinden işlem yapabilir mi?
Hayır. Sunucunun dokuz aracının hepsi yalnızca veri okur: emir verilmez ve iptal edilmez, kimse turnuvaya katılmaz, para transfer edilmez.
Bot geliştiricisi borsa anahtarlarımı alır mı?
Hayır. Başkasının botunu bağladığınızda BuyCrypt onun için ayrı bir demo hesap açar ve yalnızca bu hesaba anahtar verir. Gerçek hesaplarınız ve borsa anahtarlarınız bota iletilmez. Veri korumasıyla ilgili ayrıntılar «Güvenlik» sayfasında.
Demo hesapla başlayın
BuyCrypt hesabı ücretsizdir: bot için demo hesap, uygulamada API anahtarı, stratejinin gerçek değerini gösteren turnuvalar ve sıralama.