Wie benutze ich die Coinbase -API für den Futures -Handel?

Verständnis der Coinbase -API für Futures -Handel

Die Coinbase -API ermöglicht es Entwicklern und Händlern, programmgesteuert mit den Finanzprodukten von Coinbase, einschließlich Futures -Verträgen , zu interagieren. Im Gegensatz zum Spot -Handel beinhalten Futures Verträge, die den Käufer oder Verkäufer dazu verpflichten, einen Vermögenswert zu einem vorbestimmten zukünftigen Datum und Preis zu handeln. Um die API für Futures zu verwenden, müssen Sie zunächst verstehen, dass Coinbase diese Funktionalität über seine Coinbase Advanced Trade API bietet, die sowohl REST- als auch WebSocket -Protokolle unterstützt. Stellen Sie vor dem Initiieren von Geschäften sicher, dass Sie einen API -Schlüssel mit den richtigen Berechtigungen erstellt haben - insbesondere den Handelsbereich für Futures. Ohne dies gibt Ihre Anfragen einen 403 -Fehler zurück.

Richten Sie Ihren API -Schlüssel für Futures Access ein

Melden Sie sich zunächst in Ihr Coinbase -Konto an und navigieren Sie zum Abschnitt API -Einstellungen . Klicken Sie auf "Neue API -Taste erstellen" und weisen Sie einen Namen wie "FuturesBot" zu. Wählen Sie im Berechtigungsbereich aus:

• Sicht
• Handel
• Überweisen Stellen Sie sicher, dass IP Whitelisting für zusätzliche Sicherheit aktiviert werden kann. Sobald Sie gespeichert sind, zeigt Coinbase Ihren API -Schlüssel, Ihr Geheimnis und Ihre Passphrase an. Bewahren Sie diese sicher auf-niemals in öffentlichen Repositories oder im kundenseitigen Code. Der API-Schlüssel muss im CB-ACCESS-KEY Header, die Passphrase in CB-ACCESS-PASSPHRASE und den Zeitstempel im CB-ACCESS-TIMESTAMP übergeben werden. Der geheime Schlüssel wird verwendet, um jede Anforderung mit HMAC SHA256 zu signieren.

  Platzieren Sie eine Futures -Bestellung über REST -API

  Um eine Futures -Bestellung aufzugeben, senden Sie eine Postanfrage an https://api.coinbase.com/api/v3/brokerage/orders . Der Körper muss enthalten:
• client_order_id : eine eindeutige Bescheid, die Sie generieren
• product_id : Format wie BTC-USD-FUTURE
• side : entweder 'BUY' oder 'SELL'
• order_type : Verwenden Sie 'LIMIT' zur Preiskontrolle
• price : String -Format, z. B. '50000.00'
• size : Menge als Zeichenfolge, z. B. '0.01'
• leverage : Setzen Sie zwischen 1x und 5x als String, z. B. '3'
• margin_type : Muss für Futures 'ISOLATED' sein Header müssen Ihre Authentifizierungs -Token enthalten. Die Antwort gibt bei erfolgreichem Auftrag eine order_id zurück. Wenn die Anfrage fehlschlägt, überprüfen Sie das Nachrichtenfeld message - beispielsweise können die nicht genügend Marge 'Insufficient margin available' .

  Verwaltung von Positionen und Rand mit API -Endpunkten

  Überwachen Sie nach dem Aufgeben einer Bestellung Ihre Positionen mithilfe des Endpunkts GET https://api.coinbase.com/api/v3/brokerage/positions . Dies gibt aktive Futures -Positionen zurück, einschließlich:
• size : Aktuelle Positionsgröße
• entry_price : Durchschnittlicher Eintrag in USD
• unrealized_pnl : schwebender Gewinn/Verlust
• liquidation_price : Preis, zu dem die Position automatisch verkleinert wird Um die Hebel an einer offenen Position anzupassen, verwenden Sie POST /api/v3/brokerage/positions/leverage . Der Körper muss enthalten:
• product_id : Wie der offenen Position
• leverage : Neue Hebel als String (z. B. '2' ) Dies ist kritisch - wenn sich Ihre Position dem Liquidationspreis nähert, kann die Reduzierung der Hebelwirkung erzwungene Schließung verhindern.

  Futures -Bestellungen programmatisch stornieren und schließen

  Um eine nicht gefüllte Bestellung zu stornieren, senden Sie eine Anforderung an /api/v3/brokerage/orders/{order_id} . Ersetzen Sie {order_id} durch die ID aus der anfänglichen Bestellantwort. Um eine Position zu schließen, geben Sie eine neue Bestellung mit der gegenüberliegenden Seite und der passenden Größe ein. Wenn Sie beispielsweise eine lange Position von 0,01 BTC innehaben, geben Sie eine SELL mit size: '0.01' auf. Die API unterstützt keine Ein-Klick-Positionsschließung-dies muss manuell über entgegengesetzte Befehle erfolgen. Überprüfen Sie immer die Positionsgröße über den Positionsendpunkt, bevor Sie ihn schließen, um teilweise Schließungen oder Überverkäufe zu vermeiden.

  Handhabungsfehler und Ratengrenzen

  Die Coinbase -API erzwingt Tarifgrenzen: 10 Anfragen pro Sekunde pro API -Schlüssel . Wenn dies überschreitet, gibt ein 429 -Fehler zurück. Implementieren Sie exponentielle Backoffs in Ihrem Code - warten Sie nach jedem Fehler um 1 Sekunde, dann 2, dann 4 usw.. Häufige Fehler sind:
• 400 Bad Request : Überprüfen Sie die JSON -Formatierung - Setzen Sie alle erforderlichen Felder, die Saiten sind
• 401 Unauthorized : Überprüfen Sie den Zeitstempel und die Signaturgenerierung
• 403 Forbidden : Bestätigen Sie den API -Schlüssel "Handel" -Zuxiel
• 422 Unprocessable Entity : Ungültiges Produkt_ID oder Hebel außerhalb des 1–5 -fachen Bereichs von 1–5x Loggen Sie alle Antworten auf Debugg -Probleme. Verwenden Sie Tools wie Postman oder Curl, um Endpunkte zu testen, bevor Sie sich in Live -Handelsbots integrieren.

  Häufig gestellte Fragen

  Kann ich den gleichen API -Schlüssel für den Spot- und den Futures -Handel verwenden? Ja, aber nur, wenn der Schlüssel sowohl "Ansicht" als auch "Handel" -Träger aktiviert ist. Futures-spezifische Endpunkte erfordern weiterhin das richtige Produkt_ID-Format (z. B. ETH-USD-FUTURE ), das sich von ETH-USD von Spot unterscheidet.

  Was passiert, wenn meine Futures -Position liquidiert wird? Die API schließt automatisch die Position, wenn der Markpreis das Liquidationsniveau erreicht. Sie erhalten keine Benachrichtigung über die API - Monitor liquidation_price aus dem Positionsendpunkt und richten Warnungen extern ein.

  Ist TestNet für die Entwicklung von Futures -API verfügbar? Nein, Coinbase bietet kein Futures -Testnetz an. Verwenden Sie eine kleine Menge reales Kapital in einem Sandkastenkonto oder simulieren Sie vor der Bereitstellung lokal die Bestelllogik.

  Wie berechnet ich den erforderlichen Rand für eine Futures -Bestellung? Erforderliche Marge = (Preis × Größe) / Hebel. Für eine 0,01 BTC -Bestellung bei 50.000 USD mit 3X -Hebel: (50000 × 0,01) / 3 = 166,67 USD . Stellen Sie sicher, dass Ihr Konto mindestens diesen Betrag in USD oder Stablecoins enthält.