Screener de dérivés par crypto
Screener de dérivés par crypto (prix, OI, financement, RSI, long/short, liquidations ; filtrable)
/api/derivatives/coinsRequête
Paramètres de requête
| Nom | Type | Requis | Par défaut | Valeurs autorisées | Description |
|---|---|---|---|---|---|
| limit | integer | Optionnel | 50 | ≤ 500 | Nombre de lignes à renvoyer. Exemple: 50 |
| offset | integer | Optionnel | 0 | — | Décalage de pagination. |
| onlyWatchlist | string | Optionnel | — | 1 | =1 restreint à la liste de suivi de l'appelant (JWT requis, sans cache). |
| exchanges | string | Optionnel | — | — | Liste blanche de plateformes séparées par des virgules (27 plateformes) ; 400 si aucune n'est valide. |
| minMarketCap | number | Optionnel | — | — | Filtre : capitalisation minimale (USD). |
| maxMarketCap | number | Optionnel | — | — | Filtre : capitalisation maximale (USD). |
| minOi | number | Optionnel | — | — | Filtre : positions ouvertes minimales (USD). |
| maxOi | number | Optionnel | — | — | Filtre : positions ouvertes maximales (USD). |
| minFunding | number | Optionnel | — | — | Filtre : taux de financement minimal. |
| maxFunding | number | Optionnel | — | — | Filtre : taux de financement maximal. |
| minRsi1h | number | Optionnel | — | — | Filtre : RSI 1h minimal. |
| maxRsi1h | number | Optionnel | — | — | Filtre : RSI 1h maximal. |
| minRsi4h | number | Optionnel | — | — | Filtre : RSI 4h minimal. |
| maxRsi4h | number | Optionnel | — | — | Filtre : RSI 4h maximal. |
| minRsi1d | number | Optionnel | — | — | Filtre : RSI 1d minimal. |
| maxRsi1d | number | Optionnel | — | — | Filtre : RSI 1d maximal. |
| minChangePct | number | Optionnel | — | — | Filtre : variation 24h minimale (%). |
| maxChangePct | number | Optionnel | — | — | Filtre : variation 24h maximale (%). |
| minVolume | number | Optionnel | — | — | Filtre : volume 24h minimal (USD). |
| maxVolume | number | Optionnel | — | — | Filtre : volume 24h maximal (USD). |
| minLiq24h | number | Optionnel | — | — | Filtre : liquidations 24h minimales (USD). |
| maxLiq24h | number | Optionnel | — | — | Filtre : liquidations 24h maximales (USD). |
| minLsAccount | number | Optionnel | — | — | Filtre : ratio long/short des comptes minimal. |
| maxLsAccount | number | Optionnel | — | — | Filtre : ratio long/short des comptes maximal. |
| minOiChg1h | number | Optionnel | — | — | Filtre : variation de l'OI sur 1h minimale (%). |
| maxOiChg1h | number | Optionnel | — | — | Filtre : variation de l'OI sur 1h maximale (%). |
| minOiChg24h | number | Optionnel | — | — | Filtre : variation de l'OI sur 24h minimale (%). |
| maxOiChg24h | number | Optionnel | — | — | 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.
| Champ | Type | Unité | Description |
|---|---|---|---|
| success | boolean | — | true lorsque la requête a abouti. En cas d'échec, le corps est `{ success: false, code, error, request_id }`. |
| now | number | ms | Heure du serveur au moment où la réponse a été construite. |
| total | number | — | Total. |
| data | array | — | Charge utile. |
| data[] | object | — | Charge utile. |
| data[].coin | string | — | Symbole de la crypto, en majuscules (par exemple BTC). |
| data[].name | string | — | Nom. |
| data[].image_url | string | — | Chemin d'icône de même origine servi par CoinBoss ; null lorsqu'aucune icône vérifiée n'existe. |
| data[].market_cap | number | — | Capitalisation boursière. |
| data[].price | number | — | Dernier prix dans la devise de cotation (USD ou USDT sauf mention contraire). |
| data[].change_pct | number | % | Variation en pourcentage. |
| data[].volume_usd | number | USD | Volume en notionnel USD. |
| data[].rsi_1h | number | — | RSI(14) sur bougies 1h. |
| data[].rsi_4h | number | — | RSI(14) sur bougies 4h. |
| data[].rsi_1d | number | — | RSI(14) sur bougies quotidiennes. |
| data[].basis_pct | number|null | % | (futures − spot) / spot × 100. |
| data[].basis_annual_pct | null | % per year | Basis annualisé selon le nombre de jours avant l'échéance. |
| data[].oi_usd | number | USD | Positions ouvertes en notionnel USD. |
| data[].funding_avg | number | — | Taux de financement moyen sur l'ensemble des plateformes. |
| data[].ls_account | number|null | — | Ratio long/short par comptes. |
| data[].ls_taker | number|null | — | Ratio achats/ventes taker. |
| data[].liq_24h_usd | number | USD | Liquidations sur 24h. |
| data[].oi_chg_1h_pct | number | % | Variation des positions ouvertes sur 1h. |
| data[].oi_chg_24h_pct | number | % | Variation des positions ouvertes sur 24h. |
| data[].vol_chg_24h_pct | number | % | Variation du volume sur 24h. |
| data[].updated_at | number | ms | Date 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"
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
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 →
| Code | HTTP | Signification | Que faire |
|---|---|---|---|
| INVALID_PARAM | 400 | Un 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. |
| UNAUTHORIZED | 401 | L'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. |
| FORBIDDEN | 403 | La route ne fait pas partie de l'API publique (interne ou réservée aux comptes). | Ne réessayez pas. |
| NOT_FOUND | 404 | Route 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_LIMITED | 429 | Plus 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. |
| INTERNAL | 500 | Erreur 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_FAILED | 503 | La 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. |
| UNAVAILABLE | 501 / 503 | Le 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_FAILED | 200 | Certains 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
/api/derivatives/coinsDisponibleinteger · 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 (%).
https://www.coinboss.com/api/derivatives/coins?limit=50Autres endpoints de cette catégorie
- Lot complet d'une crypto en un appel (OI, financement, liquidations, volume, long/short) /api/sd/coin
- Volume futures d'une crypto /api/sd/volume
- Screener de dérivés par crypto /api/derivatives/coins
- Tableau complet des dérivés par crypto /api/derivatives/coins-full
- Bougies des dérivés d'une crypto /api/derivatives/kline
- Liste des RSI par crypto /api/derivatives/rsi
- Série MACD d'une crypto /api/indicators/ta/macd/:coin
- Séries historiques d'une crypto /api/market/history
- Tickers de dérivés agrégés par crypto /api/market/tickers
- Classement des volumes de dérivés /api/market/volume-rank