24h Volumen—Open Interest—24h Liquidationen$1.36B24h Long/Short—BTC-Dominanz—ETH-Dominanz—
App
Sprache ▾
€ EUR ▾
/api/ls/coin
GETVerfügbar

Long/Short-Verhältnisse für einen Coin über alle Börsen und Varianten

Long/Short-Verhältnisse für einen Coin über alle Börsen und Varianten

GET/api/ls/coin
Kontrakte, die in Vielfachen des Coins notiert sind (zum Beispiel `1000PEPE`), werden dem Basis-Coin zugeordnet. Coins, für die keine Börse ein Long/Short-Verhältnis veröffentlicht, liefern eine leere Liste.

Anfrage

Query-Parameter

NameTypErforderlichStandardZulässige WerteBeschreibung
basestringErforderlich——Symbol des Basis-Coins (Großbuchstaben, z. B. BTC). Beispiel: BTC

Beispielanfrage

curl -s "https://www.coinboss.com/api/ls/coin?base=BTC"

Antwortfelder

Die Feldtabelle wird aus echten Antworten erzeugt und führt daher genau das auf, was der Endpunkt zurückgibt. In Pfaden steht a[] für Array-Elemente und {*} für Objekte, deren Schlüssel ein dynamischer Name ist, etwa ein Coin oder eine Börse.

FeldTypEinheitBeschreibung
successboolean—true, wenn die Anfrage erfolgreich war. Im Fehlerfall lautet der Body `{ success: false, code, error, request_id }`.
basestring—Symbol des Basis-Assets.
nownumbermsServerzeit beim Erstellen der Antwort.
pricenumber—Letzter Preis in der Kurswährung (USD oder USDT, sofern nicht anders angegeben).
exchange_countnumber—Anzahl der Börsen.
exchangesarray—Börsen.
exchanges[]string—Börsen.
typesarray—Typen.
types[]string—Typen.
accountobject—Kontenbasierte Kennzahl. dynamische Schlüssel: binance,okx,bybit,bitget,gate,kraken
account.{*}object—Kontenbasierte Kennzahl.
account.{*}.longnumber—Long-Anteil.
account.{*}.shortnumber—Short-Anteil.
account.{*}.rationumber—Long-Anteil geteilt durch Short-Anteil (1 = ausgeglichen).
topaccobject—Long/Short-Verhältnis der Top-Trader nach Konten je Börse; die Schlüssel sind Börsenkennungen, jeweils mit `long` in %, `short` in % und `ratio` (Long ÷ Short). dynamische Schlüssel: binance,htx
topacc.{*}object—Eine Börse: Anteile `long` und `short` der Top-Trader-Konten in Prozent und `ratio` = Long ÷ Short; der Schlüssel ist die Börsenkennung.
topacc.{*}.longnumber—Long-Anteil.
topacc.{*}.shortnumber—Short-Anteil.
topacc.{*}.rationumber—Long-Anteil geteilt durch Short-Anteil (1 = ausgeglichen).
positionobject—Long/Short-Verhältnis nach Positionsgröße je Börse (bei Binance, Gate und HTX die Positionen der Top-Trader); die Schlüssel sind Börsenkennungen. dynamische Schlüssel: binance,bitget,gate,htx,okx
position.{*}object—Eine Börse: Anteile `long` und `short` in Prozent und `ratio` = Long ÷ Short; der Schlüssel ist die Börsenkennung.
position.{*}.longnumber—Long-Anteil.
position.{*}.shortnumber—Short-Anteil.
position.{*}.rationumber—Long-Anteil geteilt durch Short-Anteil (1 = ausgeglichen).
takerobject—Kennzahl Taker-Kauf / -Verkauf. dynamische Schlüssel: binance,bitget,gate,okx
taker.{*}object—Kennzahl Taker-Kauf / -Verkauf.
taker.{*}.longnumber—Long-Anteil.
taker.{*}.shortnumber—Short-Anteil.
taker.{*}.rationumber—Long-Anteil geteilt durch Short-Anteil (1 = ausgeglichen).
avg_rationumberratioEinfacher Mittelwert der `ratio`-Werte je Börse für den Typ `account`; null, wenn keine Börse ihn meldet.
avg_longnumber%Einfacher Mittelwert des Anteils der Long-Konten über die Börsen in `account`.
avg_shortnumber%Einfacher Mittelwert des Anteils der Short-Konten über die Börsen in `account`.
last_updatenumbermsZeitstempel des neuesten Long/Short-Datensatzes, der in dieser Antwort verwendet wird (alle Typen); null, wenn es keinen gibt.

Erzeugt 2026-11-11 23:09 UTC aus 4 echten Antworten.

Beispielantwort

/api/ls/coin?base=BTC · Echte Antwort, erfasst 2026-11-13 03:57:51 UTC. Lange Arrays und Maps sind für die Anzeige gekürzt: taker hatte 4 Elemente; account hatte 6 Elemente; position hatte 5 Elemente.

  • {
    • "success": true,
    • "base": "BTC",
    • "now": 1794542271045,
    • "price": 68907.3,
    • "exchange_count": 6,
    • "exchanges": [
      • "binance",
      • "okx",
      • "bybit",
      • "bitget",
      • "gate",
      • "kraken"
      ],
    • "types": [
      • "account",
      • "topacc",
      • "position",
      • "taker"
      ],
    • "account": {
      • "binance": { … 3 },
      • "okx": { … 3 }
      },
    • "topacc": {
      • "binance": { … 3 },
      • "htx": { … 3 }
      },
    • "position": {
      • "binance": { … 3 },
      • "bitget": { … 3 }
      },
    • "taker": {
      • "binance": { … 3 },
      • "bitget": { … 3 }
      },
    • "avg_ratio": 2.883,
    • "avg_long": 73.52,
    • "avg_short": 26.48,
    • "last_update": 1794542163797
    }

Geprüfte Stichproben

Neben dem obigen Beispiel ruft die Prüfsonde diesen Endpunkt mit den folgenden Parametern auf und prüft jedes Mal das Schema.

ParameterHTTPLatenzErgebnis
base=ETH20051 msBestanden
base=SOL20040 msBestanden
base=ARKM20034 msBestanden

Geprüft 2026-11-13 03:57:51 UTC

Details

Authentifizierung
Keine. Öffentlicher Endpunkt.
Rate-Limit
1200 Anfragen pro Minute und IP
Server-Cache
30s
Edge-Micro-Cache
10s
Aktualisierungsintervall
alle 5 min (Verhältnis nach Konten der Top-Trader von binance sowie Taker- / Top-Trader-Positionsverhältnisse von okx stündlich; Long-Tail-Symbole alle 30 min)
Zeitfenster
letzter Snapshot; innerhalb von 3 h aktualisierte Zeilen
Datenquellen
Long/Short-Verhältnisse, von den eigenen Collectoren über die öffentlichen Statistik-Endpunkte von 7 Börsen abgefragt (binance, okx, bybit, bitget, gate, htx, kraken).
Börsenabdeckung
Verhältnis nach Konten: binance, okx, bybit, bitget, gate, kraken; Verhältnis nach Konten der Top-Trader: binance, htx; Verhältnis nach Positionen: binance, okx, gate, htx, bitget; Taker-Kauf/Verkauf-Verhältnis: binance, okx, bitget, gate; die Abtastperioden der Upstream-Quellen unterscheiden sich (5 min bis 1 h); die Symbolabdeckung ist eine rollierende Liste der volumenstärksten Coins (rund 280 Coins beim Verhältnis nach Konten von binance, rund 20-60 Coins bei anderen Börsen / Typen)
Einheiten
long / short as percentages of 100; ratio = long / short; price in USD
Methode
avg_ratio = simple mean of account ratios across exchanges; avg_long / avg_short = simple means of account long% / short%
Zeitstempel
Unix-Epoche in Millisekunden (UTC), sofern die Feldbeschreibung nichts anderes angibt
Antwortformat
json
Stabilität
Stabil

Live-Status

VerfügbarGeprüft 2026-11-13 03:57:51 UTCHTTP 20042 msSchema stimmt überein

Verfügbarkeit, letzte 30 Tage

100 % von 410 Prüfungen bestanden

Fehler

Fehlgeschlagene Aufrufe haben auf jedem Endpunkt denselben Aufbau. Die vollständige Liste steht auf der Fehlerseite. Fehler und Rate-Limits →

CodeHTTPBedeutungEmpfohlene Reaktion
INVALID_PARAM400Ein erforderlicher Parameter fehlt oder ein Wert wird nicht akzeptiert. `param` nennt den Parameter, sofern er bekannt ist.Nicht unverändert wiederholen; die Anfrage korrigieren.
UNAUTHORIZED401Der Header `CB-API-KEY` wurde gesendet, der Schlüssel ist jedoch unbekannt oder widerrufen. Öffentliche Daten erfordern keinen Schlüssel – lassen Sie den Header weg oder verwenden Sie einen gültigen Schlüssel.Nicht unverändert wiederholen.
FORBIDDEN403Die Route gehört nicht zur öffentlichen API (intern oder nur für Konten).Nicht wiederholen.
NOT_FOUND404Unbekannte Route, oder der angefragte Coin / die Börse / der Fonds existiert nicht.Nicht wiederholen; Pfad und Kennungen mit dem Katalog abgleichen.
RATE_LIMITED429Mehr Anfragen, als das Limit pro Minute zulässt. `Retry-After` gibt die Wartezeit in Sekunden an.`Retry-After` abwarten, dann mit Backoff wiederholen.
INTERNAL500Unerwarteter Serverfehler. Die Meldung ist bewusst allgemein gehalten; geben Sie `request_id` an, wenn Sie den Fehler melden.Einmal nach einigen Sekunden wiederholen; wenn der Fehler bestehen bleibt, mit der Request-ID melden.
UPSTREAM_FAILED503Die Datenquelle hinter diesem Endpunkt hat nicht rechtzeitig geantwortet. Es werden ersatzweise keine veralteten oder stellvertretenden Zahlen zurückgegeben.Mit Backoff wiederholen; die Statusseite prüfen.
UNAVAILABLE501 / 503Der Datensatz ist vorübergehend nicht bereit (Cache wird aufgewärmt), oder der Endpunkt hat noch keine rechtmäßige öffentliche Quelle.Später wiederholen; der Katalog kennzeichnet Endpunkte, die konzeptbedingt nicht verfügbar sind.
REQUEST_FAILED200Einige ältere Endpunkte antworten mit HTTP 200 und `success: false`. Prüfen Sie immer `success`, nicht nur den HTTP-Status.Hängt von der Meldung ab; als fehlgeschlagene Anfrage behandeln.

Ausprobieren

GET/api/ls/coinVerfügbar
Parameter

string — Base coin symbol (uppercase, e.g. BTC).

Anfrage-URLhttps://www.coinboss.com/api/ls/coin?base=BTC
Wählen Sie einen Endpunkt und klicken Sie auf „Anfrage senden“. Antwort, Header und Laufzeit erscheinen hier.