BuyCrypt
Geliştiriciler ve yapay zekâ asistanları için

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.

1 satırbot kodunda: farklı bir base URL
500+USDT süresiz kontrat
9MCP aracı, hepsi yalnızca okur
api.buycrypt.comcanlı yanıt
GET https://api.buycrypt.com/fapi/v1/ticker/price?symbol=BTCUSDT
{ "symbol": "BTCUSDT", "price": "…" }
# Binance USD-M Futures üzerindeki botunuz
- base_url="https://fapi.binance.com"
+ base_url="https://api.buycrypt.com"
Bağlanmanın iki yolu

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
API dokümantasyonu →

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)
Bir dakikada bağlayın →
MCP · Model Context Protocol

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
Streamable HTTPgiriş yapmadanyalnızca okuma
  1. claude.ai sitesini veya Claude Desktop uygulamasını açın → Customize → Connectors.
  2. + Add → Add custom connector seçeneğine tıklayın.
  3. Ad: BuyCrypt, adres: https://buycrypt.com/mcp, ardından Continue.
  4. 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.

  1. Terminalde tek bir komut çalıştırın:
Terminal
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.

  1. Tarayıcıda chatgpt.com/plugins adresini açın.
  2. + → Add custom MCP server seçeneğine tıklayın.
  3. Ad: BuyCrypt; Connection bölümünde herkese açık adresi seçin ve https://buycrypt.com/mcp yazın.
  4. 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.

Cursor'a ekle

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:

mcp.json
{
  "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:

claude_desktop_config.json ve benzerleri
{
  "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ız
list_tournaments

Devam eden, yaklaşan ve biten turnuvalar: coin, puanlama yöntemi, ödül havuzu, giriş, katılımcılar.

anahtarsız
get_tournament

Tek bir turnuva: sıralara göre ödüller ve sonuçlarıyla katılımcı tablosu.

anahtarsız
leaderboard

7, 30 veya 90 günde coin bazında liderler — «En iyi trader'lar» sayfasındaki gibi.

anahtarsız
trader_profile

Kullanı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ız
market_ticker

Süresiz kontratta fiyat ve 24 saatlik değişim, örneğin BTCUSDT.

anahtarsız
demo_account

Demo hesabınızın bakiyesi, marjı ve açık pozisyonları.

anahtarınız
demo_open_orders

Demo hesabınızın açık emirleri.

anahtarınız
demo_recent_results

Demo hesabın son sonuçları: kapanan işlemlerin kâr ve zararı, komisyonlar.

anahtarınız

Hiç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.

Canlı örnek

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.

BTC'de ayın en iyi 5 trader'ını göster
asistan şunu çağırır: leaderboard{"coin":"BTC","period_days":30,"limit":5}
Sunucu yanıtı yükleniyor…
Anahtarınızla

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.

Terminal
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"
mcp.json
{
  "mcpServers": {
    "buycrypt": {
      "url": "https://buycrypt.com/mcp",
      "headers": {
        "X-BuyCrypt-Api-Key": "YOUR_API_KEY",
        "X-BuyCrypt-Api-Secret": "YOUR_API_SECRET"
      }
    }
  }
}
  1. Bağlayıcıyı eklerken (Customize → Connectors → Add custom connector) adresten sonra No sign in seçin.
  2. Request headers bloğuna iki başlık ekleyin: X-BuyCrypt-Api-Key ve X-BuyCrypt-Api-Secret, kendi değerlerinizle.
  3. 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.

Trading botları için API

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

  1. Hesap. Web terminaline veya BuyCrypt uygulamasına Google ya da Apple ile giriş yapın. Demo hesap hemen oluşur.
  2. 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.
  3. Adres. Kütüphanenizde https://api.buycrypt.com adresini https://fapi.binance.com yerine yazın. /fapi/v1/… yolları aynı kalır.
  4. 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.
pip install binance-futures-connector
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"))
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
# 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
GET/fapi/v1/ping · /fapi/v1/timeBağlantı kontrolü ve ms cinsinden sunucu saati.
GET/fapi/v1/exchangeInfoKontratlar, fiyat ve miktar filtreleri, limitler.
GET/fapi/v1/ticker/price · /ticker/24hr · /ticker/bookTickerSon fiyat, 24 saatlik istatistik, en iyi alış ve satış fiyatları.
GET/fapi/v1/depth · /fapi/v1/klinesEmir defteri ve mumlar.
GET/fapi/v1/premiumIndex · /fapi/v1/fundingRateİşaret fiyatı, endeks ve fonlama oranı.
Hesap ve pozisyonlar imzalı
GET/fapi/v2/account · /fapi/v3/accountBakiye, marj ve pozisyonlar tek yanıtta (v1, v2 ve v3 aynı).
GET/fapi/v2/balance · /fapi/v3/balanceDemo hesap bakiyesi, yalnızca USDT.
GET/fapi/v2/positionRisk · /fapi/v3/positionRiskAçık pozisyonlar: giriş fiyatı, işaret fiyatı, gerçekleşmemiş sonuç, likidasyon fiyatı.
GET/fapi/v1/userTrades · /fapi/v1/incomeSembole göre işlemler ve sonuç geçmişi: kâr ve zarar, komisyonlar.
GET/fapi/v1/commissionRate · /fapi/v1/leverageBracketSembole göre komisyon ve kaldıraç seviyeleri.
İşlem imzalı
POST/fapi/v1/orderYeni emir: MARKET, LIMIT, STOP, STOP_MARKET, TAKE_PROFIT, TAKE_PROFIT_MARKET, TRAILING_STOP_MARKET; reduceOnly, closePosition, timeInForce, newClientOrderId.
GET/fapi/v1/order · /openOrders · /allOrdersTek emir, açık emirler, geçmiş.
PUT/fapi/v1/orderLimit emri değiştirin.
DELETE/fapi/v1/order · /allOpenOrdersTek bir emri veya sembolün tüm emirlerini iptal edin.
POST/fapi/v1/batchOrdersTek istekte birden fazla emir; DELETE — toplu iptal.
POST/fapi/v1/algoOrderKoşullu emirler (stop, take profit, trailing); GET /openAlgoOrders, /allAlgoOrders, DELETE /algoOrder, /algoOpenOrders.
POST/fapi/v1/leverage · /fapi/v1/marginTypeSembole göre kaldıraç ve marj türü.
GET/fapi/v1/positionSide/dualHer zaman dualSidePosition: false — tek pozisyon modu.
WebSocket akışları
POST/fapi/v1/listenKey60 dakikalık özel akış anahtarı; PUT uzatır, DELETE kapatır.
WSwss://api.buycrypt.com/fapi/ws/<listenKey>Hesabınızın olayları: ORDER_TRADE_UPDATE, ACCOUNT_UPDATE, MARGIN_CALL — Binance formatında.
WSwss://api.buycrypt.com/fapi/ws-market/btcusdt@markPriceTek piyasanın herkese açık akışı: @markPrice ve @kline_1m.
WSwss://api.buycrypt.com/stream?streams=btcusdt@markPrice/ethusdt@kline_1mTek bağlantıda birden fazla akış, yanıtlar {"stream", "data"} sarmalayıcısında.
Limitler ve hatalar
1 dk2.400 ağırlık · 1.200 imzalı okumaAPI anahtarı başına. Yanıtlarda X-MBX-USED-WEIGHT-1M ve X-MBX-ORDER-COUNT-10S başlıkları bulunur.
10 sn300 emirAşıldığında HTTP 429 ve Retry-After döner.
ERR-1021 · -1022 · -2014 · -2015Zaman recvWindow dışında · imza hatalı · anahtar biçimi hatalı · anahtar iptal edilmiş veya geçersiz (HTTP 401), anahtar salt okunur ama istek işlem isteği (HTTP 403).
ERR-1102 · -2010 · -2011 · -2019Zorunlu parametre eksik · emir reddedildi · emir bulunamadı · yetersiz marj.
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.

Webhook imzasını doğrulama, 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 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"])
Anahtarlar ve güvenlik

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.

Sorular

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.