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

Financement d'une crypto

Couche de données interne : financement d'une crypto (normalisé sur 8h, pondéré)

GET/api/sd/funding

Requête

Paramètres de requête

NomTypeRequisPar défautValeurs autoriséesDescription
coinstringRequis——Symbole de la crypto ; 400 s'il est absent. Alias : `base`. Exemple: BTC

Exemple de requête

curl -s "https://www.coinboss.com/api/sd/funding?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 }`.
coinstring—Symbole de la crypto, en majuscules (par exemple BTC).
nownumbermsHeure du serveur au moment où la réponse a été construite.
unitstring—Unité de tous les champs de taux de cette réponse : `fraction` (0.0001 = 0.01 %).
avg_8hnumberfraction per 8hMoyenne simple des taux normalisés sur 8h, un contrat par plateforme.
oi_weighted_8hnumberfraction per 8hMoyenne des taux normalisés sur 8h, pondérée par les positions ouvertes.
apr_pctnumber% per yearAnnualisation simple : taux 8h × 3 × 365 × 100.
apr_basisstring—Agrégat sur lequel repose la valeur principale `apr_pct`.
n_exchangesnumber—Nombre de plateformes contributrices.
n_normalizednumber—Plateformes dont l'intervalle de financement est connu et a pu être normalisé sur 8h.
n_unknown_intervalnumber—Plateformes exclues des agrégats parce que leur intervalle de financement est inconnu.
settled_cum_7dobject—Somme des taux de financement effectivement réglés sur les 7 derniers jours, moyennée sur les plateformes disposant d'un historique de règlements.
settled_cum_7d.avgnumberfractionMoyenne simple entre plateformes.
settled_cum_7d.oi_weightednumberfractionMoyenne pondérée par les positions ouvertes.
settled_cum_7d.nnumber—Plateformes dont la fenêtre est complète.
settled_cum_30dobject—Idem, sur 30 jours.
settled_cum_30d.avgnumberfractionMoyenne simple entre plateformes.
settled_cum_30d.oi_weightednumberfractionMoyenne pondérée par les positions ouvertes.
settled_cum_30d.nnumber—Plateformes dont la fenêtre est complète.
by_exchangearray—Une ligne par plateforme : son contrat principal pour cette crypto (celui dont les positions ouvertes sont les plus importantes).
by_exchange[]object—Détail par plateforme.
by_exchange[].exchangestring—Identifiant de la plateforme, en minuscules (par exemple `binance`).
by_exchange[].symbolstring—Symbole de l'instrument tel que normalisé par CoinBoss (par exemple BTCUSDT).
by_exchange[].marginstring—Classe de devise de marge.
by_exchange[].kindstring—Nature.
by_exchange[].primaryboolean—true pour le contrat qui représente la plateforme dans les agrégats.
by_exchange[].ratenumber—Taux de financement de la période en cours, tel que publié par la plateforme.
by_exchange[].interval_hnumberhIntervalle de financement.
by_exchange[].rate_8hnumber—Taux normalisé sur une période de 8 heures : taux × 8 / interval_h.
by_exchange[].apr_pctnumber% per yearPourcentage annualisé.
by_exchange[].next_funding_timenumber|nullmsHeure du prochain règlement.
by_exchange[].next_derivedboolean—true lorsque l'heure du prochain règlement a été déduite de l'intervalle au lieu d'être publiée par la plateforme.
by_exchange[].predicted_ratenull—Taux indicatif de la période suivante lorsque la plateforme en publie un ; sinon null.
by_exchange[].oi_usdnumber|nullUSDPositions ouvertes en notionnel USD.
by_exchange[].updated_atnumbermsDate de dernière mise à jour de cette ligne.
by_exchange[].age_snumbersSecondes écoulées depuis la dernière mise à jour de cette ligne.
by_exchange[].is_staleboolean—true lorsque la ligne est plus ancienne que la fenêtre de fraîcheur ; les lignes périmées ne sont pas utilisées dans les totaux.
by_exchange[].settledobject|null—Enregistrements de règlements effectifs pour ce contrat ; null lorsque la plateforme n'a pas d'historique public.
by_exchange[].settled.last_ratenumber—Taux du règlement le plus récent. peut être absent
by_exchange[].settled.last_timenumbermsHeure du règlement le plus récent. peut être absent
by_exchange[].settled.interval_hnumberhIntervalle de financement. peut être absent
by_exchange[].settled.cum_7dnumber—Somme des taux réglés sur les 7 derniers jours. peut être absent
by_exchange[].settled.n_7dnumber—Règlements trouvés sur les 7 derniers jours. peut être absent
by_exchange[].settled.n_7d_expectednumber—Règlements attendus en 7 jours avec cet intervalle. peut être absent
by_exchange[].settled.cum_7d_completeboolean—true lorsqu'aucun règlement ne manque dans la fenêtre de 7 jours. peut être absent
by_exchange[].settled.cum_30dnumber—Somme des taux réglés sur les 30 derniers jours. peut être absent
by_exchange[].settled.n_30dnumber—Règlements trouvés sur les 30 derniers jours. peut être absent
by_exchange[].settled.n_30d_expectednumber—Règlements attendus en 30 jours avec cet intervalle. peut être absent
by_exchange[].settled.cum_30d_completeboolean—true lorsqu'aucun règlement ne manque dans la fenêtre de 30 jours. peut être absent
by_exchange[].settled.history_fromnumbermsEnregistrement de règlement le plus ancien conservé pour ce contrat. peut être absent
other_contractsarray—Autres contrats de la même crypto (USDC, à marge en crypto, …). Ils ne font pas partie des agrégats.
other_contracts[]object—Un contrat de financement supplémentaire d'une plateforme (à marge crypto, USDC, …) qui n'est pas son contrat principal et qui est exclu des agrégats.
other_contracts[].exchangestring—Identifiant de la plateforme, en minuscules (par exemple `binance`).
other_contracts[].symbolstring—Symbole de l'instrument tel que normalisé par CoinBoss (par exemple BTCUSDT).
other_contracts[].marginstring—Classe de devise de marge.
other_contracts[].kindstring—Nature.
other_contracts[].primaryboolean—true pour le contrat qui représente la plateforme dans les agrégats.
other_contracts[].ratenumber—Taux de financement de la période en cours, tel que publié par la plateforme.
other_contracts[].interval_hnumber|nullhIntervalle de financement.
other_contracts[].rate_8hnumber|null—Taux normalisé sur une période de 8 heures : taux × 8 / interval_h.
other_contracts[].apr_pctnumber|null% per yearPourcentage annualisé.
other_contracts[].next_funding_timenumber|nullmsHeure du prochain règlement.
other_contracts[].next_derivedboolean—true lorsque l'heure du prochain règlement a été déduite de l'intervalle au lieu d'être publiée par la plateforme.
other_contracts[].predicted_ratenumber|null—Taux indicatif de la période suivante lorsque la plateforme en publie un ; sinon null.
other_contracts[].oi_usdnumber|nullUSDPositions ouvertes en notionnel USD.
other_contracts[].updated_atnumbermsDate de dernière mise à jour de cette ligne.
other_contracts[].age_snumbersSecondes écoulées depuis la dernière mise à jour de cette ligne.
other_contracts[].is_staleboolean—true lorsque la ligne est plus ancienne que la fenêtre de fraîcheur ; les lignes périmées ne sont pas utilisées dans les totaux.
other_contracts[].settledobject|null—Enregistrements de règlements effectifs pour ce contrat ; null lorsque la plateforme n'a pas d'historique public.
other_contracts[].settled.last_ratenumber—Taux du règlement le plus récent. peut être absent
other_contracts[].settled.last_timenumbermsHeure du règlement le plus récent. peut être absent
other_contracts[].settled.interval_hnumberhIntervalle de financement. peut être absent
other_contracts[].settled.cum_7dnumber—Somme des taux réglés sur les 7 derniers jours. peut être absent
other_contracts[].settled.n_7dnumber—Règlements trouvés sur les 7 derniers jours. peut être absent
other_contracts[].settled.n_7d_expectednumber—Règlements attendus en 7 jours avec cet intervalle. peut être absent
other_contracts[].settled.cum_7d_completeboolean—true lorsqu'aucun règlement ne manque dans la fenêtre de 7 jours. peut être absent
other_contracts[].settled.cum_30dnumber—Somme des taux réglés sur les 30 derniers jours. peut être absent
other_contracts[].settled.n_30dnumber—Règlements trouvés sur les 30 derniers jours. peut être absent
other_contracts[].settled.n_30d_expectednumber—Règlements attendus en 30 jours avec cet intervalle. peut être absent
other_contracts[].settled.cum_30d_completeboolean—true lorsqu'aucun règlement ne manque dans la fenêtre de 30 jours. peut être absent
other_contracts[].settled.history_fromnumbermsEnregistrement de règlement le plus ancien conservé pour ce contrat. peut être absent
coverageobject—Ce qui est inclus ou non dans les chiffres ci-dessus. Comparez ces éléments avant de comparer les totaux avec une autre source.
coverage.settle_history_exchangesarray—Plateformes pour lesquelles les enregistrements de règlements effectifs sont collectés.
coverage.settle_history_exchanges[]string—Identifiant d'une plateforme pour laquelle les enregistrements de règlement de financement effectifs sont collectés pour cette crypto.
coverage.no_settle_historyarray—Plateformes sans source publique d'historique de règlements ; leur `settled` vaut null.
coverage.no_settle_history[]string—Identifiant de la plateforme d'un contrat principal sans historique de règlement collecté ; son bloc `settled` vaut donc null.
coverage.unknown_intervalarray—Lignes dont l'intervalle de financement n'a pas pu être déterminé. vide dans les échantillons ayant servi à générer ce tableau
coverage.no_liveness_excludedarray—Lignes exclues parce que le contrat ne montre aucun signe d'activité (ni ticker récent, ni positions ouvertes, ni cotation). vide dans les échantillons ayant servi à générer ce tableau
methodobject—Énoncé en texte brut des formules utilisées pour cette réponse.
method.ratestring—Taux de financement de la période en cours, tel que publié par la plateforme.
method.rate_8hstring—Taux normalisé sur une période de 8 heures : taux × 8 / interval_h.
method.apr_pctstring% per yearPourcentage annualisé.
method.aggregatestring—Agrégat multi-plateformes.
method.settledstring—Enregistrements de règlements effectifs pour ce contrat ; null lorsque la plateforme n'a pas d'historique public.
method.predicted_ratestring—Taux indicatif de la période suivante lorsque la plateforme en publie un ; sinon null.
method.livenessstring—Règle en texte brut d'élimination des contrats morts : une ligne de financement n'est comptée que si elle dispose d'un ticker de moins de 1h, de positions ouvertes de moins de 3h ou d'une cotation propre de moins de 3h.

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

Exemple de réponse

/api/sd/funding?coin=BTC · Réponse réelle (capture : 2026-11-13 04:02:35 UTC). Les tableaux et dictionnaires longs sont abrégés pour l'affichage : by_exchange comptait 23 éléments; other_contracts comptait 18 éléments; coverage.settle_history_exchanges comptait 16 éléments.

  • {
    • "success": true,
    • "coin": "BTC",
    • "now": 1794542555395,
    • "unit": "fraction",
    • "avg_8h": 0.00005823565217391305,
    • "oi_weighted_8h": 0.000055271734505874884,
    • "apr_pct": 6.0523,
    • "apr_basis": "oi_weighted_8h",
    • "n_exchanges": 23,
    • "n_normalized": 23,
    • "n_unknown_interval": 0,
    • "settled_cum_7d": {
      • "avg": 0.001605814,
      • "oi_weighted": 0.0015308150106440065,
      • "n": 15
      },
    • "settled_cum_30d": {
      • "avg": 0.006684665333333334,
      • "oi_weighted": 0.006363754085135786,
      • "n": 15
      },
    • "by_exchange": [
      • { … 17 },
      • { … 17 }
      ],
    • "other_contracts": [
      • { … 17 },
      • { … 17 }
      ],
    • "coverage": {
      • "settle_history_exchanges": [ … 8 ],
      • "no_settle_history": [ … 7 ],
      • "unknown_interval": [],
      • "no_liveness_excluded": []
      },
    • "method": {
      • "rate": "current funding-period rate as published by the exchange (charged at next settlement; may change until then)",
      • "rate_8h": "rate × 8 / interval_h (rows with unknown interval excluded from aggregates)",
      • "apr_pct": "per exchange: rate_8h × 3 × 365 × 100; headline apr_pct = oi_weighted_8h × 3 × 365 × 100 (falls back to avg_8h when no OI weights; see apr_basis). Simple annual…",
      • "aggregate": "one contract per exchange (largest OI); avg_8h = simple mean; oi_weighted_8h = Σ(rate_8h × oi_usd)/Σoi_usd",
      • "settled": "actual settlement records collected from each exchange funding-history endpoint; cum = Σ settled rates in window",
      • "predicted_rate": "exchange-published indicative/next-period rate where available",
      • "liveness": "a funding row is used only if the same contract on the same exchange has a ticker within 1h, open interest within 3h, or a self-collected quote within 3h; rows …"
      }
    }

É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=ETH20043 msRéussi
coin=SOL20044 msRéussi
coin=ARKM20041 msRéussi
—4001 msRéussi renvoie l'erreur attendue

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

Détails

Authentification
Aucune. Endpoint public.
Limite de requêtes
1200 requêtes par minute et par IP
Cache serveur
20s
Micro-cache en périphérie
10s
Fréquence de mise à jour
toutes les 60 s pour la plupart des plateformes (écriture en même temps que les tickers ; tâche dédiée de 60 s pour binance) ; autres tâches de financement et contrats à marge en crypto toutes les 5 min ; enregistrements de règlements toutes les heures
Fenêtre
dernier instantané (lignes de financement de moins de 4 h sur les contrats ayant un ticker / un OI actif) ; sommes réglées sur 7 d et 30 d
Sources de données
Taux de financement actuels interrogés par des collecteurs internes auprès des API REST publiques de 24 plateformes de perpétuels (p. ex. binance, okx, bybit, bitget, gate, hyperliquid).
Couverture des plateformes
24 plateformes pour les taux actuels ; historique des règlements issu de 16 plateformes (les perpétuels à marge en crypto de binance, okx et bybit sont conservés séparément)
Unités
unit = 'fraction' (0.0001 = 0.01%); rate_8h normalized to 8 h; apr_pct in percent; times in Unix ms
Méthode
one contract per exchange (largest OI); rate_8h = rate x 8 / interval_hours; avg_8h = simple mean; oi_weighted_8h = SUM(rate_8h x oi_usd) / SUM(oi_usd); apr_pct = rate_8h x 3 x 365 x 100; settled 7 d / 30 d = SUM of settlement records with a completeness flag (>= 90% of expected settlements)
Horodatages
Millisecondes depuis l'epoch Unix (UTC), sauf indication contraire dans la description du champ
Format de réponse
json
Stabilité
Stable
Disponible depuis
2026-11-11

Statut en direct

DisponibleVérifié : 2026-11-13 04:02:35 UTCHTTP 20036 msSchéma conformePoint de données le plus récent : il y a 36s

Disponibilité, 30 derniers jours

100 % 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/sd/fundingDisponible
Paramètres

string — Coin symbol; 400 when missing. Alias: `base`.

URL de la requêtehttps://www.coinboss.com/api/sd/funding?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.