Volume 24h—Positions ouvertes—Liquidations 24h$1.36BLong/Short 24h—Dominance BTC—Dominance ETH—
App
Langue ▾
€ EUR ▾
/api/currency/overview
GETDisponible

Vue d'ensemble détaillée d'une crypto

Vue d'ensemble détaillée d'une crypto (prix, capitalisation, offre, synthèse des dérivés)

GET/api/currency/overview

Requête

Paramètres de requête

NomTypeRequisPar défautValeurs autoriséesDescription
coinstringRequis——Symbole de la crypto de base (en majuscules, p. ex. BTC). Exemple: BTC

Exemple de requête

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

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 }`.
dataobject—Charge utile.
data.coinstring—Symbole de la crypto, en majuscules (par exemple BTC).
data.supplyobject—Offre, en unités de la crypto.
data.supply.price_usdstring(decimal)USDPrix.
data.supply.market_cap_usdstring(decimal)USDCapitalisation boursière.
data.supply.mcap_ranknumber—Rang par capitalisation boursière.
data.supply.vol_24h_usdstring(decimal)USDVolume sur 24h.
data.supply.circulatingstring(decimal)—Offre en circulation, en unités de la crypto.
data.supply.total_supplystring(decimal)—Offre totale, en unités de la crypto.
data.supply.max_supplystring(decimal)|null—Offre maximale, en unités de la crypto ; null lorsqu'elle est illimitée ou inconnue.
data.supply.change_24h_pctstring(decimal)%Variation en pourcentage sur 24h.
data.supply.image_urlstring—Chemin d'icône de même origine servi par CoinBoss ; null lorsqu'aucune icône vérifiée n'existe.
data.supply.website_urlstring—Site officiel du projet, issu des métadonnées de la crypto.
data.supply.reddit_urlstring|null—Subreddit du projet ; null lorsqu'aucun n'est répertorié.
data.supply.github_urlstring|null—Dépôt de code source principal du projet ; null lorsqu'aucun n'est répertorié.
data.supply.whitepaper_urlstring—Lien vers le livre blanc du projet.
data.supply.explorer_urlstring—Lien vers un explorateur de blocs pour la crypto.
data.supply.categorystring—Catégorie.
data.supply.asofnumbermsHeure de la donnée la plus récente utilisée.
data.supply.staleboolean—Lignes ou indicateur signalant des données plus anciennes que la fenêtre de fraîcheur.
data.supply.spot_vol_usdnumberUSDSomme du volume spot 24h de la crypto sur les plateformes spot que CoinBoss collecte lui-même (dernier instantané) ; null lorsqu'il n'est pas collecté.
data.supply.futures_vol_usdnumberUSDSomme du volume futures 24h sur toutes les plateformes dont le ticker date de moins de 1 heure, même valeur que `futures_vol.total_usd` ; null en l'absence de données propres.
data.supply.oi_total_usdnumberUSDPositions ouvertes agrégées de la crypto sur l'ensemble des plateformes et des types de contrats, même valeur que `oi.total_usd` ; null en l'absence de données propres.
data.supply.high_24hstring(decimal)—Plus haut sur 24h.
data.supply.low_24hstring(decimal)—Plus bas sur 24h.
data.futures_vol_chg_pctnumber%Variation sur 24h du volume futures : plateformes présentes à la fois maintenant et dans l'instantané horaire d'il y a environ 24 heures, (Σ actuel − Σ précédent) ÷ Σ précédent.
data.oi_chg_pctnumber%Variation sur 24h des positions ouvertes, calculée sur les contrats présents à la fois maintenant et dans l'instantané horaire le plus proche d'il y a 24 heures.
data.oiobject—Positions ouvertes.
data.oi.total_usdnumberUSDTotal.
data.oi.local_usdnumberUSDPositions ouvertes additionnées à partir de la collecte par plateforme propre à CoinBoss ; identiques à `oi.total_usd`.
data.oi.by_exchangearray—Détail par plateforme.
data.oi.by_exchange[]object—Détail par plateforme.
data.oi.by_exchange[].exchangestring—Identifiant de la plateforme, en minuscules (par exemple `binance`).
data.oi.by_exchange[].oi_usdnumberUSDPositions ouvertes en notionnel USD.
data.oi.n_exchangesnumber—Nombre de plateformes contributrices.
data.oi.asofnumbermsHeure de la donnée la plus récente utilisée.
data.oi.chg_basisobject—Entrées de `oi_chg_pct` : sommes actuelle et précédente appariées (`cur`, `prev`), nombre de plateformes appariées, heure de référence et contrats figés exclus.
data.oi.chg_basis.curnumber—Valeur actuelle.
data.oi.chg_basis.prevnumber—Valeur précédente (base de comparaison).
data.oi.chg_basis.n_matchednumber—Éléments présents aux deux extrémités de la comparaison.
data.oi.chg_basis.prev_hour_tsnumbermsDébut de la tranche horaire précédente.
data.oi.chg_basis.frozen_excludedobject—Lignes exclues parce que la valeur source n'a pas bougé.
data.oi.chg_basis.frozen_excluded.n_baselinenumber—Éléments dans l'instantané de référence.
data.oi.chg_basis.frozen_excluded.n_currentnumber—Éléments dans l'instantané actuel.
data.oi.chg_basis.frozen_excluded.cur_usdnumberUSDValeur actuelle.
data.oi.chg_basis.frozen_excluded.prev_usdnumberUSDValeur de référence.
data.futures_volobject—Volume futures.
data.futures_vol.total_usdnumberUSDTotal.
data.futures_vol.n_exchangesnumber—Nombre de plateformes contributrices.
data.futures_vol.chg_basisobject—Entrées de `futures_vol_chg_pct` : sommes de volume actuelle et précédente appariées (`cur`, `prev`), nombre de plateformes appariées et heure de référence.
data.futures_vol.chg_basis.curnumber—Valeur actuelle.
data.futures_vol.chg_basis.prevnumber—Valeur précédente (base de comparaison).
data.futures_vol.chg_basis.n_matchednumber—Éléments présents aux deux extrémités de la comparaison.
data.futures_vol.chg_basis.prev_hour_tsnumbermsDébut de la tranche horaire précédente.
data.fundingnumber—Bloc ou valeur du taux de financement.
data.funding_detailobject—Détail sous-jacent à `funding` : taux normalisés sur 8h, en moyenne simple et pondérée par les positions ouvertes, taux annualisé, nombres de plateformes et une entrée par plateforme.
data.funding_detail.basisstring—Prix futures moins prix spot, ou bloc basis.
data.funding_detail.avg_8hnumber—Moyenne des taux normalisés sur 8h.
data.funding_detail.oi_weighted_8hnumber—Moyenne des taux normalisés sur 8h, pondérée par les positions ouvertes.
data.funding_detail.apr_pctnumber% per yearPourcentage annualisé.
data.funding_detail.n_exchangesnumber—Nombre de plateformes contributrices.
data.funding_detail.n_normalizednumber—Plateformes normalisées sur 8h.
data.funding_detail.n_unknown_intervalnumber—Plateformes dont l'intervalle de financement est inconnu.
data.funding_detail.by_exchangearray—Détail par plateforme.
data.funding_detail.by_exchange[]object—Détail par plateforme.
data.funding_detail.by_exchange[].exchangestring—Identifiant de la plateforme, en minuscules (par exemple `binance`).
data.funding_detail.by_exchange[].symbolstring—Symbole de l'instrument tel que normalisé par CoinBoss (par exemple BTCUSDT).
data.funding_detail.by_exchange[].ratenumber—Taux.
data.funding_detail.by_exchange[].interval_hnumberhIntervalle.
data.funding_detail.by_exchange[].rate_8hnumber—Taux normalisé sur une période de 8 heures.
data.funding_detail.by_exchange[].next_funding_timenumber|nullmsHorodatage.
data.long_shortobject—Bloc long/short.
data.long_short.longnumber—Valeur côté long.
data.long_short.shortnumber—Valeur côté short.
data.long_short.rationumber—Ratio.
data.long_short.typestring—Type.
data.long_short.n_exchangesnumber—Nombre de plateformes contributrices.
data.derivedobject—Indicateurs de la crypto recalculés périodiquement (RSI, basis, positions ouvertes agrégées, financement moyen, parts long/short, liquidations 24h) ; null lorsqu'ils ne sont pas calculés.
data.derived.rsi_1hstring(decimal)—RSI(14) sur bougies 1h.
data.derived.rsi_4hstring(decimal)—RSI(14) sur bougies 4h.
data.derived.rsi_1dstring(decimal)—RSI(14) sur bougies quotidiennes.
data.derived.basis_pctstring(decimal)|null%(futures − spot) / spot × 100.
data.derived.basis_annual_pctnull% per yearBasis annualisé selon le nombre de jours avant l'échéance.
data.derived.oi_usd_aggstring(decimal)USDPositions ouvertes agrégées sur l'ensemble des plateformes et des types de contrats lors de la dernière actualisation des indicateurs ; peut être légèrement en retard sur `oi.total_usd`.
data.derived.funding_avgstring(decimal)—Taux de financement moyen sur l'ensemble des plateformes.
data.derived.ls_accountstring(decimal)—Ratio long/short par comptes.
data.derived.ls_takerstring(decimal)|null—Ratio achats/ventes taker.
data.derived.liq_24h_usdstring(decimal)USDLiquidations sur 24h.
data.liquidationobject—Bloc liquidations. clés dynamiques: 1h,4h,12h,24h
data.liquidation.{*}object—Bloc liquidations.
data.liquidation.{*}.winstring—Libellé de fenêtre de l'entrée, identique à sa clé (`1h`, `4h`, `12h` ou `24h`).
data.liquidation.{*}.long_usdnumberUSDCôté long.
data.liquidation.{*}.short_usdnumberUSDCôté short.
data.liquidation.{*}.total_usdnumberUSDTotal.
data.liquidation.{*}.cntnumber—Nombre.

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

Exemple de réponse

/api/currency/overview?coin=BTC · Réponse réelle (capture : 2026-11-13 03:57:31 UTC). Les tableaux et dictionnaires longs sont abrégés pour l'affichage : data.liquidation comptait 4 éléments; data.oi.by_exchange comptait 22 éléments; data.funding_detail.by_exchange comptait 23 éléments.

  • {
    • "success": true,
    • "data": {
      • "coin": "BTC",
      • "supply": { … 22 },
      • "futures_vol_chg_pct": 67.76,
      • "oi_chg_pct": -3.65,
      • "oi": { … 6 },
      • "futures_vol": { … 3 },
      • "funding": 0.000057831612725940206,
      • "funding_detail": { … 8 },
      • "long_short": { … 5 },
      • "derived": { … 10 },
      • "liquidation": { … 2 }
      }
    }

Échantillons vérifiés

Outre l'exemple ci-dessus, la sonde appelle cet endpoint avec les paramètres suivants et vérifie le schéma à chaque fois.

ParamètresHTTPLatenceRésultat
coin=ETH20086 msRéussi
coin=SOL20081 msRéussi
coin=ARKM20079 msRéussi

Vérifié : 2026-11-13 03:57:31 UTC

Détails

Authentification
Aucune. Endpoint public.
Limite de requêtes
1200 requêtes par minute et par IP
Cache serveur
30s
Micro-cache en périphérie
10s
Fréquence de mise à jour
agrégateur tiers de données de marché toutes les 10 min ; tickers toutes les 1 min ; OI/financement/long-short toutes les 5 min (cryptos principales toutes les 1 min) ; volume spot toutes les 10 min ; cache mémoire 30 s
Fenêtre
24h glissantes pour le volume et les liquidations ; dernier instantané pour l'OI, le financement et le long/short
Sources de données
L'offre, la capitalisation et le rang proviennent d'un agrégateur tiers de données de marché ; le prix, les positions ouvertes, le financement, le long/short et les volumes futures et spot sont agrégés en interne à partir des API publiques des plateformes ; les liquidations proviennent des flux de liquidations des plateformes.
Couverture des plateformes
Toute crypto présente dans la table alimentée par l'agrégateur tiers de données de marché ou disposant d'un contrat dérivé coté
Pagination
aucun
Unités
USD; rates as decimals; changes in percent
Méthode
OI = SUM(oi_usd) over fresh contracts incl. multiplier contracts (3h; CME 120h); funding = OI-weighted mean of rate normalized to 8h (rate * 8 / interval_hours)
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 03:57:31 UTCHTTP 20095 msSchéma conformePoint de données le plus récent : il y a 20s

Disponibilité, 30 derniers jours

99.76 % des 411 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/currency/overviewDisponible
Paramètres

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

URL de la requêtehttps://www.coinboss.com/api/currency/overview?coin=BTC
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.