BuyCrypt
Für Entwickler und KI-Assistenten

API für Trading-Bots und MCP für KI

Ein Bot, der für Binance USD-M Futures geschrieben wurde, läuft ohne Umschreiben auf dem BuyCrypt-Demokonto: Nur die API-Adresse ändert sich. Und Claude, ChatGPT und Cursor sehen über den MCP-Server von BuyCrypt die Turniere, das Trader-Rating und Ihr Demokonto.

KI-Assistenten verbinden API-Dokumentation
1 Zeileim Code des Bots: eine andere Base-URL
500+USDT-Perpetual-Kontrakte
9MCP-Tools, alle nur lesend
api.buycrypt.comLive-Antwort
GET https://api.buycrypt.com/fapi/v1/ticker/price?symbol=BTCUSDT
{ "symbol": "BTCUSDT", "price": "…" }
# Ihr Bot für Binance USD-M Futures
- base_url="https://fapi.binance.com"
+ base_url="https://api.buycrypt.com"
Zwei Wege der Anbindung

Der Bot tradet. Der Assistent beantwortet Fragen.

API für Trading-Bots

Format von Anfragen, Signaturen und Antworten wie bei Binance USD-M Futures. Der Bot platziert Orders auf Ihrem BuyCrypt-Demokonto: Die Kurse sind echte Marktkurse, das Geld ist Demogeld.

  • Dieselben Bibliotheken: binance-futures-connector oder Ihr eigener Code mit requests
  • REST, privater WebSocket per listenKey, Kerzen und Mark Price im Stream
  • Der Schlüssel wird in der App erstellt und funktioniert nur mit einem Demokonto
API-Dokumentation →

MCP für KI-Assistenten

Eine Adresse in den Einstellungen von Claude, ChatGPT oder Cursor – und der Assistent holt sich die Daten von BuyCrypt selbst, wenn Sie danach fragen.

  • Turniere, Preise, Teilnehmertabelle, Führende nach Coins
  • Trader-Pass: Rating von 1000, Stufe, Trading-Stil
  • Ihr Demokonto: Guthaben, Positionen, Orders (mit einem Nur-Lese-Schlüssel)
In einer Minute verbinden →
MCP · Model Context Protocol

MCP: BuyCrypt mit Claude, ChatGPT und Cursor verbinden

MCP ist ein offener Standard, über den KI-Assistenten externe Daten und Tools anbinden. Der BuyCrypt-Server liefert dem Assistenten Live-Daten der Plattform. Registrierung und Schlüssel sind nicht nötig, einen Schlüssel brauchen Sie nur für Ihr Demokonto.

https://buycrypt.com/mcp
Streamable HTTPohne Anmeldungnur lesend
  1. Öffnen Sie claude.ai oder die App Claude Desktop → Customize → Connectors.
  2. Klicken Sie auf + Add → Add custom connector.
  3. Name: BuyCrypt, Adresse: https://buycrypt.com/mcp, dann Continue.
  4. Wählen Sie im Bereich Authentication die Option No sign in und klicken Sie auf Add.

Eigene Connectors gibt es in allen Claude-Tarifen, im kostenlosen Tarif einen. In Team- und Enterprise-Organisationen fügt der Inhaber der Organisation den Connector unter Organization settings → Connectors hinzu. Für Ihr eigenes Demokonto fügen Sie den Schlüssel im Block Request headers desselben Fensters hinzu – so geht es.

  1. Führen Sie im Terminal einen Befehl aus:
Terminal
claude mcp add --transport http buycrypt https://buycrypt.com/mcp

Prüfung: claude mcp list – in der Liste erscheint buycrypt. Fügen Sie --scope user hinzu, damit der Server in allen Projekten verfügbar ist.

  1. Öffnen Sie chatgpt.com/plugins im Browser.
  2. Klicken Sie auf + → Add custom MCP server.
  3. Name: BuyCrypt; wählen Sie im Bereich Connection die öffentliche Adresse und geben Sie https://buycrypt.com/mcp an.
  4. Authentication: No authentication. Bestätigen Sie den Hinweis I understand and want to continue und klicken Sie auf Create.

Eigene MCP-Server lassen sich in ChatGPT nur in der Web-Version hinzufügen und sind nicht in allen Tarifen verfügbar. Fehlt der Menüpunkt, hat ihn der Tarif oder der Administrator des Workspace gesperrt. Ihr eigenes Demokonto können Sie in ChatGPT nicht verbinden: Es übergibt dem Server keine Schlüssel. Dafür eignen sich Claude, Claude Code und Cursor.

Zu Cursor hinzufügen

Die Schaltfläche öffnet Cursor mit fertiger Konfiguration. Oder manuell: Fügen Sie in ~/.cursor/mcp.json (für alle Projekte) oder in .cursor/mcp.json im Projektstamm hinzu:

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

Jeder Client mit Unterstützung für Streamable HTTP funktioniert: Geben Sie die Adresse https://buycrypt.com/mcp an, eine Autorisierung ist nicht nötig. Wenn der Client nur lokale Server (stdio) starten kann, verbinden Sie ihn über die Brücke mcp-remote; dafür wird Node.js benötigt:

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

Server ohne Assistenten prüfen: npx @modelcontextprotocol/inspector --cli https://buycrypt.com/mcp --transport http --method tools/list

Was der Server kann

platform_overview

Welche Turniere gerade laufen, welches als Nächstes startet, wie viele Trader in Turnieren sind, die letzten Preise.

ohne Schlüssel
list_tournaments

Laufende, kommende und beendete Turniere: Coin, Wertungsart, Preispool, Teilnahme, Teilnehmer.

ohne Schlüssel
get_tournament

Ein einzelnes Turnier: Preise nach Plätzen und die Teilnehmertabelle mit Ergebnissen.

ohne Schlüssel
leaderboard

Führende nach Coin für 7, 30 oder 90 Tage – wie auf der Seite „Top-Trader“.

ohne Schlüssel
trader_profile

Trader-Pass nach Nickname: Rating von 1000, Stufe, fünf Teilbewertungen, Stil. Nur öffentliche Profile.

ohne Schlüssel
market_ticker

Kurs und Veränderung in 24 Stunden für einen Perpetual-Kontrakt, zum Beispiel BTCUSDT.

ohne Schlüssel
demo_account

Guthaben, Margin und offene Positionen Ihres Demokontos.

Ihr Schlüssel
demo_open_orders

Offene Orders Ihres Demokontos.

Ihr Schlüssel
demo_recent_results

Die letzten Ergebnisse des Demokontos: Gewinn und Verlust geschlossener Trades, Gebühren.

Ihr Schlüssel

Kein Tool platziert Orders, tritt Turnieren bei oder überweist Geld – der Server liest nur.

Was Sie den Assistenten fragen können

Klicken Sie auf eine Frage, um sie zu kopieren.

Live-Beispiel

So sieht der Assistent BuyCrypt

Unten sehen Sie die echte Antwort des Servers https://buycrypt.com/mcp in diesem Moment. Der Assistent erhält genau diese Daten und gibt sie in eigenen Worten wieder.

Zeig mir die Top 5 Trader des Monats bei BTC
Der Assistent ruft leaderboard{"coin":"BTC","period_days":30,"limit":5} auf
Serverantwort wird geladen…
Mit Ihrem Schlüssel

Ihr Demokonto im Assistenten

Die Tools demo_account, demo_open_orders und demo_recent_results lesen Ihr Demokonto. Dafür übergibt der Client Ihren API-Schlüssel in zwei Headern an den Server: X-BuyCrypt-Api-Key und X-BuyCrypt-Api-Secret. Erstellen Sie für den Assistenten einen Schlüssel nur zum Lesen: Er sieht Guthaben, Positionen und Orders, aber Orders, Stornierungen oder Hebeländerungen führt BuyCrypt damit nicht aus (Antwort 403). So erhalten Sie ihn.

Terminal
claude mcp add --transport http buycrypt https://buycrypt.com/mcp \
  --header "X-BuyCrypt-Api-Key: IHR_API_KEY" \
  --header "X-BuyCrypt-Api-Secret: IHR_API_SECRET"
mcp.json
{
  "mcpServers": {
    "buycrypt": {
      "url": "https://buycrypt.com/mcp",
      "headers": {
        "X-BuyCrypt-Api-Key": "IHR_API_KEY",
        "X-BuyCrypt-Api-Secret": "IHR_API_SECRET"
      }
    }
  }
}
  1. Wählen Sie beim Hinzufügen des Connectors (Customize → Connectors → Add custom connector) nach der Adresse No sign in.
  2. Fügen Sie im Block Request headers zwei Header hinzu: X-BuyCrypt-Api-Key und X-BuyCrypt-Api-Secret mit Ihren Werten.
  3. Klicken Sie auf Add. Wurde der Connector bereits ohne Schlüssel hinzugefügt, löschen Sie ihn und fügen Sie ihn mit den Headern erneut hinzu.

Nur lesend

Der MCP-Server platziert und storniert keine Orders. Den Schlüssel braucht er, um Guthaben, Positionen und Orders zu lesen. Mit einem Nur-Lese-Schlüssel lässt sich nicht handeln, selbst wenn er in fremde Hände gerät.

Ein Demokonto

Der BuyCrypt-Schlüssel funktioniert nur mit dem Demokonto, für das er erstellt wurde. Zugriff auf echte Börsenkonten gibt er nicht.

Eigener Schlüssel

Erstellen Sie für den Assistenten einen eigenen Nur-Lese-Schlüssel. Der Schlüssel geht nur an buycrypt.com; der Server speichert ihn nicht und schreibt ihn nicht in Logs. Widerrufen können Sie ihn dort, wo Sie ihn erstellt haben.

API für Trading-Bots

API kompatibel mit Binance USD-M Futures

Pfade, HMAC-SHA256-Signatur, Parameter und Antwortformat wie bei Binance USD-M Futures. Der einzige Unterschied: Orders werden auf Ihrem BuyCrypt-Demokonto zu Marktkursen ausgeführt und gehen nicht an eine echte Börse. So können Sie eine Strategie am Markt prüfen, ohne Geld zu riskieren.

So starten Sie

  1. Konto. Melden Sie sich im Web-Terminal oder in der BuyCrypt-App mit Google oder Apple an. Das Demokonto erscheint sofort.
  2. Schlüssel. Im Web-Terminal oder in der App: Profil → API-Schlüssel → Ihr Demokonto → Bereich Bot API keys → Generate API key. Kopieren Sie apiKey und apiSecret: Das Secret wird nur einmal angezeigt. Für einen KI-Assistenten oder ein Monitoring gibt es im Web-Terminal die Schaltfläche Generate read-only key (for MCP).
  3. Adresse. Geben Sie in Ihrer Bibliothek https://api.buycrypt.com statt https://fapi.binance.com an. Die Pfade /fapi/v1/… bleiben unverändert.
  4. Prüfung. Fragen Sie das Guthaben ab – GET /fapi/v2/balance: In der Antwort stehen die USDT Ihres Demokontos.

Was Sie wissen sollten

  • Nur USDT-Kontrakte und der Ein-Positions-Modus (one-way); der Hedge-Modus wird nicht unterstützt.
  • Tickerkurs: /fapi/v1/ticker/price. Der Pfad /fapi/v2/ticker/price, den neuere Versionen der Bibliotheken aufrufen, wird noch nicht unterstützt.
  • Im öffentlichen Stream kommen Kerzen @kline_1m (alle 5 s) und @markPrice (jede Sekunde).
  • recvWindow: standardmäßig 5.000 ms, bis zu 60.000 ms. Gleichen Sie die Uhrzeit über /fapi/v1/time ab.
  • Ein Konto mit einem Trading-API-Schlüssel erhält im Rating der App das Symbol 🤖: So sieht jeder, dass ein Programm handelt.
  • Schlüsselrechte: Ein normaler Schlüssel (READ_TRADE) liest und handelt, ein Nur-Lese-Schlüssel (READ) erlaubt nur GET-Anfragen und listenKey. Order, Stornierung, Hebel oder Margin damit ergeben HTTP 403 und Code -2015.
pip install binance-futures-connector
import os
from binance.um_futures import UMFutures

client = UMFutures(
    key=os.environ["BUYCRYPT_API_KEY"],        # Schlüssel aus der BuyCrypt-App
    secret=os.environ["BUYCRYPT_API_SECRET"],
    base_url="https://api.buycrypt.com",      # die einzige Zeile, die sich ändert
)

print(client.balance())                             # USDT des Demokontos
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
# öffentliche Daten – ohne Schlüssel
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"

# Guthaben des Demokontos – signierte Anfrage
KEY="IHR_API_KEY"; SECRET="IHR_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"

Methoden

REST-Basisadresse: https://api.buycrypt.com. Signierte Methoden erfordern den Header X-MBX-APIKEY, timestamp und signature.

Marktdaten ohne Schlüssel
GET/fapi/v1/ping · /fapi/v1/timeVerbindungstest und Serverzeit in ms.
GET/fapi/v1/exchangeInfoKontrakte, Preis- und Mengenfilter, Limits.
GET/fapi/v1/ticker/price · /ticker/24hr · /ticker/bookTickerLetzter Kurs, 24-Stunden-Statistik, beste Kauf- und Verkaufspreise.
GET/fapi/v1/depth · /fapi/v1/klinesOrderbuch und Kerzen.
GET/fapi/v1/premiumIndex · /fapi/v1/fundingRateMark Price, Index und Funding Rate.
Konto und Positionen signiert
GET/fapi/v2/account · /fapi/v3/accountGuthaben, Margin und Positionen in einer Antwort (v1, v2 und v3 sind identisch).
GET/fapi/v2/balance · /fapi/v3/balanceGuthaben des Demokontos, nur USDT.
GET/fapi/v2/positionRisk · /fapi/v3/positionRiskOffene Positionen: Einstiegspreis, Mark Price, unrealisiertes Ergebnis, Liquidationspreis.
GET/fapi/v1/userTrades · /fapi/v1/incomeTrades pro Symbol und Ergebnishistorie: Gewinn und Verlust, Gebühren.
GET/fapi/v1/commissionRate · /fapi/v1/leverageBracketGebühr pro Symbol und Hebelstufen.
Handel signiert
POST/fapi/v1/orderNeue Order: MARKET, LIMIT, STOP, STOP_MARKET, TAKE_PROFIT, TAKE_PROFIT_MARKET, TRAILING_STOP_MARKET; reduceOnly, closePosition, timeInForce, newClientOrderId.
GET/fapi/v1/order · /openOrders · /allOrdersEinzelne Order, offene Orders, Historie.
PUT/fapi/v1/orderLimit-Order ändern.
DELETE/fapi/v1/order · /allOpenOrdersEine Order oder alle Orders eines Symbols stornieren.
POST/fapi/v1/batchOrdersMehrere Orders in einer Anfrage; DELETE storniert eine Liste.
POST/fapi/v1/algoOrderBedingte Orders (Stop, Take-Profit, Trailing); GET /openAlgoOrders, /allAlgoOrders, DELETE /algoOrder, /algoOpenOrders.
POST/fapi/v1/leverage · /fapi/v1/marginTypeHebel und Margin-Typ pro Symbol.
GET/fapi/v1/positionSide/dualImmer dualSidePosition: false – Ein-Positions-Modus.
WebSocket-Streams
POST/fapi/v1/listenKeySchlüssel für den privaten Stream, gültig 60 Minuten; PUT verlängert, DELETE schließt.
WSwss://api.buycrypt.com/fapi/ws/<listenKey>Ereignisse Ihres Kontos: ORDER_TRADE_UPDATE, ACCOUNT_UPDATE, MARGIN_CALL – im Binance-Format.
WSwss://api.buycrypt.com/fapi/ws-market/btcusdt@markPriceÖffentlicher Stream eines Marktes: @markPrice und @kline_1m.
WSwss://api.buycrypt.com/stream?streams=btcusdt@markPrice/ethusdt@kline_1mMehrere Streams in einer Verbindung, Antworten im Wrapper {"stream", "data"}.
Limits und Fehler
1 Min.2.400 Gewicht · 1.200 signierte LesezugriffePro API-Schlüssel. In den Antworten stehen die Header X-MBX-USED-WEIGHT-1M und X-MBX-ORDER-COUNT-10S.
10 s300 OrdersBei Überschreitung: HTTP 429 und Retry-After.
ERR-1021 · -1022 · -2014 · -2015Zeit außerhalb von recvWindow · ungültige Signatur · ungültiges Schlüsselformat · Schlüssel widerrufen oder ungültig (HTTP 401), Schlüssel nur zum Lesen, aber Anfrage zum Handeln (HTTP 403).
ERR-1102 · -2010 · -2011 · -2019Pflichtparameter fehlt · Order abgelehnt · Order nicht gefunden · Margin reicht nicht aus.
Abonnenten für Ihren Bot (Beta)

Sie können Ihren Bot als öffentlich registrieren: Der Nutzer tippt in der App auf „Verbinden“, BuyCrypt eröffnet ihm ein separates Demokonto mit 1.000 Demo-USDT und stellt einen Schlüssel nur für dieses Konto aus. Der Schlüssel geht mit dem Ereignis subscription.created an Ihren Webhook, und der Bot tradet auf dem Demokonto des Abonnenten. Trennt der Nutzer die Verbindung, werden die Positionen geschlossen, der Schlüssel wird ungültig, und Sie erhalten subscription.disconnected.

Der Bot erhält weder echte Konten noch Börsenschlüssel der Nutzer – nur den Schlüssel zu einem separaten Demokonto.

Registrierung: signierter POST /fapi/v1/bot/profiles mit den Parametern slug, displayName, webhookUrl (nur HTTPS) und webhookSecret (mindestens 32 Zeichen); bis zur Prüfung hat der Bot den Status PENDING_REVIEW. Jedes Ereignis ist signiert: Header X-BuyCrypt-Signature = HMAC-SHA256(webhookSecret, timestamp + "." + Body), die Zeit steht in X-BuyCrypt-Timestamp. Die Zustellung wird bis zu 6-mal wiederholt (sofort, nach 10 s, 30 s, 2 Min., 10 Min., 1 Std.); nach 10 fehlgeschlagenen Zustellungen in Folge wird der Webhook deaktiviert – wieder aktivieren hilft der Support.

Prüfung der Webhook-Signatur, 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:   # älter als 5 Minuten – ablehnen
        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"])
Schlüssel und Sicherheit

Ein BuyCrypt-Schlüssel öffnet nur das Demokonto

An ein Konto gebunden

Ein API-Schlüssel wird für ein bestimmtes Demokonto erstellt und funktioniert nur mit diesem. Echte Börsenkonten sind über diese API nicht zugänglich. Ein Nur-Lese-Schlüssel handelt auch auf diesem Konto nicht.

Das Secret wird einmal angezeigt

Bewahren Sie Schlüssel und Secret in Umgebungsvariablen oder einem Secret-Manager auf, nicht im Code und nicht in öffentlichen Repositories.

Widerruf in einer Sekunde

Klicken Sie im Web-Terminal oder in der App im selben Bereich „Bot API keys“ auf „Revoke“: Alle Anfragen mit diesem Schlüssel erhalten sofort den Fehler 401.

Fragen

Häufige Fragen

Tradet der Bot mit echtem Geld?

Nein. Die BuyCrypt-API führt Orders auf Ihrem Demokonto aus: Die Kurse sind echte Marktkurse, das Guthaben ist in Demo-USDT. An die Börse werden keine Orders gesendet, deshalb können Sie die Strategie ohne Risiko prüfen.

Muss ich den Bot für BuyCrypt umschreiben?

In der Regel nicht. Wenn der Bot mit Binance USD-M Futures arbeitet, ersetzen Sie die Basisadresse durch https://api.buycrypt.com und setzen Sie den BuyCrypt-Schlüssel ein. Pfade, Signatur und Antwortformat bleiben gleich. Prüfen Sie, dass der Bot weder den Hedge-Modus noch den Pfad /fapi/v2/ticker/price verwendet.

Wo bekomme ich einen API-Schlüssel?

Im Web-Terminal oder in der App von BuyCrypt: Profil → API-Schlüssel → Ihr Demokonto → Bot API keys → Generate API key. Für MCP und KI-Assistenten im Web-Terminal „Generate read-only key (for MCP)“: Ein solcher Schlüssel sieht das Konto, handelt aber nicht. Das Secret wird nur einmal angezeigt – speichern Sie es sofort. Dort können Sie den Schlüssel auch widerrufen.

Was ist MCP und wozu braucht man es?

MCP (Model Context Protocol) ist ein offener Standard, über den KI-Assistenten externe Daten anbinden. Wenn Sie den Server https://buycrypt.com/mcp verbinden, können Sie Claude, ChatGPT oder Cursor nach Turnieren, Führenden und dem Trader-Pass fragen, und der Assistent antwortet mit Live-Daten von BuyCrypt.

Brauche ich eine Registrierung, um MCP zu verbinden?

Nein. Turniere, Rating, Trader-Pässe und Kurse sind ohne Schlüssel zugänglich. Ein Schlüssel ist nur für die drei Tools nötig, die Ihr Demokonto lesen, und dafür reicht ein Nur-Lese-Schlüssel.

Kann ein KI-Assistent über MCP traden?

Nein. Alle neun Tools des Servers lesen nur Daten: Es werden keine Orders platziert oder storniert, niemand tritt Turnieren bei, und es wird kein Geld überwiesen.

Erhält der Entwickler eines Bots meine Börsenschlüssel?

Nein. Wenn Sie einen fremden Bot verbinden, eröffnet BuyCrypt dafür ein separates Demokonto und stellt einen Schlüssel nur für dieses Konto aus. Ihre echten Konten und Börsenschlüssel werden dem Bot nicht übergeben. Mehr zum Datenschutz auf der Seite „Sicherheit“.

Starten Sie mit dem Demokonto

Ein BuyCrypt-Konto ist kostenlos: Demokonto für den Bot, API-Schlüssel in der App, Turniere und ein Rating, das zeigt, was die Strategie wert ist.

Web-Terminal öffnen App herunterladen
Top-TraderTrader-PassKostenlose TurniereAlle TurniereTrading-GuideSicherheit