/api/derivatives/coins
GETDisponible

Screener de dérivés par crypto

Screener de dérivés par crypto (prix, OI, financement, RSI, long/short, liquidations ; filtrable)

GET/api/derivatives/coins

Requête

Paramètres de requête

NomTypeRequisPar défautValeurs autoriséesDescription
limitintegerOptionnel50≤ 500Nombre de lignes à renvoyer. Exemple: 50
offsetintegerOptionnel0—Décalage de pagination.
onlyWatchliststringOptionnel—1=1 restreint à la liste de suivi de l'appelant (JWT requis, sans cache).
exchangesstringOptionnel——Liste blanche de plateformes séparées par des virgules (27 plateformes) ; 400 si aucune n'est valide.
minMarketCapnumberOptionnel——Filtre : capitalisation minimale (USD).
maxMarketCapnumberOptionnel——Filtre : capitalisation maximale (USD).
minOinumberOptionnel——Filtre : positions ouvertes minimales (USD).
maxOinumberOptionnel——Filtre : positions ouvertes maximales (USD).
minFundingnumberOptionnel——Filtre : taux de financement minimal.
maxFundingnumberOptionnel——Filtre : taux de financement maximal.
minRsi1hnumberOptionnel——Filtre : RSI 1h minimal.
maxRsi1hnumberOptionnel——Filtre : RSI 1h maximal.
minRsi4hnumberOptionnel——Filtre : RSI 4h minimal.
maxRsi4hnumberOptionnel——Filtre : RSI 4h maximal.
minRsi1dnumberOptionnel——Filtre : RSI 1d minimal.
maxRsi1dnumberOptionnel——Filtre : RSI 1d maximal.
minChangePctnumberOptionnel——Filtre : variation 24h minimale (%).
maxChangePctnumberOptionnel——Filtre : variation 24h maximale (%).
minVolumenumberOptionnel——Filtre : volume 24h minimal (USD).
maxVolumenumberOptionnel——Filtre : volume 24h maximal (USD).
minLiq24hnumberOptionnel——Filtre : liquidations 24h minimales (USD).
maxLiq24hnumberOptionnel——Filtre : liquidations 24h maximales (USD).
minLsAccountnumberOptionnel——Filtre : ratio long/short des comptes minimal.
maxLsAccountnumberOptionnel——Filtre : ratio long/short des comptes maximal.
minOiChg1hnumberOptionnel——Filtre : variation de l'OI sur 1h minimale (%).
maxOiChg1hnumberOptionnel——Filtre : variation de l'OI sur 1h maximale (%).
minOiChg24hnumberOptionnel——Filtre : variation de l'OI sur 24h minimale (%).
maxOiChg24hnumberOptionnel——Filtre : variation de l'OI sur 24h maximale (%).

Exemple de requête

curl -s "https://www.coinboss.com/api/derivatives/coins?limit=50"

Champs de la réponse

Le tableau des champs est généré à partir de réponses réelles : il liste donc exactement ce que renvoie l'endpoint. Les chemins utilisent a[] pour les éléments d'un tableau et {*} pour les objets indexés par un nom dynamique, comme une crypto ou une plateforme.

ChampTypeUnitéDescription
successboolean—true lorsque la requête a abouti. En cas d'échec, le corps est `{ success: false, code, error, request_id }`.
nownumbermsHeure du serveur au moment où la réponse a été construite.
totalnumber—Total.
dataarray—Charge utile.
data[]object—Charge utile.
data[].coinstring—Symbole de la crypto, en majuscules (par exemple BTC).
data[].namestring—Nom.
data[].image_urlstring—Chemin d'icône de même origine servi par CoinBoss ; null lorsqu'aucune icône vérifiée n'existe.
data[].market_capnumber—Capitalisation boursière.
data[].pricenumber—Dernier prix dans la devise de cotation (USD ou USDT sauf mention contraire).
data[].change_pctnumber%Variation en pourcentage.
data[].volume_usdnumberUSDVolume en notionnel USD.
data[].rsi_1hnumber—RSI(14) sur bougies 1h.
data[].rsi_4hnumber—RSI(14) sur bougies 4h.
data[].rsi_1dnumber—RSI(14) sur bougies quotidiennes.
data[].basis_pctnumber|null%(futures − spot) / spot × 100.
data[].basis_annual_pctnull% per yearBasis annualisé selon le nombre de jours avant l'échéance.
data[].oi_usdnumberUSDPositions ouvertes en notionnel USD.
data[].funding_avgnumber—Taux de financement moyen sur l'ensemble des plateformes.
data[].ls_accountnumber|null—Ratio long/short par comptes.
data[].ls_takernumber|null—Ratio achats/ventes taker.
data[].liq_24h_usdnumberUSDLiquidations sur 24h.
data[].oi_chg_1h_pctnumber%Variation des positions ouvertes sur 1h.
data[].oi_chg_24h_pctnumber%Variation des positions ouvertes sur 24h.
data[].vol_chg_24h_pctnumber%Variation du volume sur 24h.
data[].updated_atnumbermsDate de dernière mise à jour de cette ligne.

Généré à partir de 1 réponses réelles (2026-11-11 23:00 UTC).

Exemple de réponse

/api/derivatives/coins?limit=50 · Réponse réelle (capture : 2026-11-13 04:02:33 UTC). Les tableaux et dictionnaires longs sont abrégés pour l'affichage : data comptait 50 éléments.

  • {
    • "success": true,
    • "now": 1794542553222,
    • "total": 800,
    • "data": [
      • { … 21 },
      • { … 21 }
      ]
    }

Détails

Authentification
Aucune. Endpoint public.
Limite de requêtes
1200 requêtes par minute et par IP
Cache serveur
5s
Micro-cache en périphérie
10s
Fréquence de mise à jour
métriques dérivées : top 100 des cryptos toutes les 5 min, rangs 101-400 toutes les 15 min, rangs 401-980 toutes les 30 min ; tickers toutes les 60 s ; prix en direct poussé par WebSocket
Fenêtre
dernier instantané (tickers de moins de 1 h)
Sources de données
Indicateurs de dérivés par crypto précalculés en interne à partir des collecteurs de plateformes propres à CoinBoss (25 sources, p. ex. binance, okx, bybit, bitget, gate, hyperliquid) ; les noms des cryptos, les icônes et la capitalisation proviennent d'un agrégateur tiers de données de marché.
Couverture des plateformes
jusqu'à 980 cryptos classées par positions ouvertes agrégées (801 lignes au moment de l'audit) ; paramètre `exchanges` restreint à une liste blanche de 27 plateformes
Pagination
limit (défaut 50, max 500)
Tri
oi_usd décroissant
Unités
oi / volume / liquidations in USD; change and RSI fields as percent / index values; funding as raw fraction; market_cap in USD
Méthode
oi_usd = cross-exchange open interest (all contract types, multiplier contracts folded); RSI(14) on 1 h / 4 h (aggregated from 1 h) / 1 d klines; oi_chg = change vs hourly archive; liq_24h_usd = 24 h SUM(value_usd); with the `exchanges` param metrics are recomputed at request time for the selected venues
Horodatages
Millisecondes depuis l'epoch Unix (UTC), sauf indication contraire dans la description du champ
Format de réponse
json
Stabilité
Stable

Statut en direct

DisponibleVérifié : 2026-11-13 04:02:33 UTCHTTP 20019 msSchéma conformePoint de données le plus récent : il y a 4m

Disponibilité, 30 derniers jours

100 % des 412 contrôles réussis

Erreurs

Les appels en échec ont la même structure sur tous les endpoints. La liste complète figure sur la page des erreurs. Erreurs et limites de requêtes →

CodeHTTPSignificationQue faire
INVALID_PARAM400Un paramètre requis est manquant ou une valeur n'est pas acceptée. `param` indique le nom du paramètre lorsqu'il est connu.Ne réessayez pas à l'identique ; corrigez la requête.
UNAUTHORIZED401L'en-tête `CB-API-KEY` a été envoyé, mais la clé est inconnue ou révoquée. Les données publiques ne nécessitent aucune clé — supprimez l'en-tête ou utilisez une clé valide.Ne réessayez pas à l'identique.
FORBIDDEN403La route ne fait pas partie de l'API publique (interne ou réservée aux comptes).Ne réessayez pas.
NOT_FOUND404Route inconnue, ou la crypto / la plateforme / le fonds demandé n'existe pas.Ne réessayez pas ; vérifiez le chemin et les identifiants dans le catalogue.
RATE_LIMITED429Plus de requêtes que la limite par minute. `Retry-After` indique le nombre de secondes à attendre.Attendez la durée indiquée par `Retry-After`, puis réessayez avec backoff.
INTERNAL500Erreur serveur inattendue. Le message est volontairement générique ; citez `request_id` lorsque vous la signalez.Réessayez une fois après quelques secondes ; si l'erreur persiste, signalez-la avec l'ID de requête.
UPSTREAM_FAILED503La source de données derrière cet endpoint n'a pas répondu à temps. Aucun chiffre périmé ni de substitution n'est renvoyé à sa place.Réessayez avec backoff ; consultez la page de statut.
UNAVAILABLE501 / 503Le jeu de données n'est temporairement pas prêt (préchauffage du cache) ou l'endpoint n'a pas encore de source publique licite.Réessayez plus tard ; le catalogue signale les endpoints indisponibles par conception.
REQUEST_FAILED200Certains endpoints plus anciens répondent HTTP 200 avec `success: false`. Vérifiez toujours `success`, et pas seulement le statut HTTP.Dépend du message ; à traiter comme une requête en échec.

Essayer

GET/api/derivatives/coinsDisponible
Paramètres

integer · défaut 50 · max 500 — Number of rows to return.

integer · défaut 0 — Pagination offset.

string — =1 restricts to the caller watchlist (JWT required, uncached).

string — Comma-separated exchange whitelist (27 venues); 400 if none valid.

number — Filter: minimum market cap (USD).

number — Filter: maximum market cap (USD).

number — Filter: minimum open interest (USD).

number — Filter: maximum open interest (USD).

number — Filter: minimum funding rate.

number — Filter: maximum funding rate.

number — Filter: minimum 1h RSI.

number — Filter: maximum 1h RSI.

number — Filter: minimum 4h RSI.

number — Filter: maximum 4h RSI.

number — Filter: minimum 1d RSI.

number — Filter: maximum 1d RSI.

number — Filter: minimum 24h change (%).

number — Filter: maximum 24h change (%).

number — Filter: minimum 24h volume (USD).

number — Filter: maximum 24h volume (USD).

number — Filter: minimum 24h liquidations (USD).

number — Filter: maximum 24h liquidations (USD).

number — Filter: minimum account long/short ratio.

number — Filter: maximum account long/short ratio.

number — Filter: minimum 1h OI change (%).

number — Filter: maximum 1h OI change (%).

number — Filter: minimum 24h OI change (%).

number — Filter: maximum 24h OI change (%).

URL de la requêtehttps://www.coinboss.com/api/derivatives/coins?limit=50
Choisissez un endpoint et cliquez sur « Envoyer la requête ». La réponse, les en-têtes et le temps de réponse s'afficheront ici.