Détail d'un ETF
Détail d'un ETF (fiche et historique des flux)
/api/etf/fund/:tickerRequête
Paramètres de requête
| Nom | Type | Requis | Par défaut | Valeurs autorisées | Description |
|---|---|---|---|---|---|
| ticker path | string | Requis | — | — | Ticker du fonds (lettres uniquement, converti en majuscules) ; 404 s'il est inconnu. Exemple: IBIT |
Les paramètres marqués « path » font partie de l'URL.
Exemple de requête
curl -s "https://www.coinboss.com/api/etf/fund/IBIT"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 }`. |
| ticker | string | — | Ticker du fonds. |
| asset | string | — | Symbole de l'actif. |
| issuer | string | — | Émetteur du fonds. |
| price | object | — | Dernier prix dans la devise de cotation (USD ou USDT sauf mention contraire). |
| price.currency | string | — | Symbole de la devise / de l'actif. |
| price.latest | object | — | Enregistrement le plus récent. |
| price.latest.date | string | — | Date calendaire (UTC). |
| price.latest.close | number | — | Prix de clôture de la période. |
| price.latest.open | number | — | Prix d'ouverture de la période. |
| price.latest.high | number | — | Plus haut de la période. |
| price.latest.low | number | — | Plus bas de la période. |
| price.latest.volume | number | — | Volume. |
| price.change_abs | number | USD | Dernière clôture quotidienne de la part du fonds moins la clôture du jour de bourse précédent. |
| price.change_pct | number | % | Variation en pourcentage. |
| price.week52_high | number | USD | Plus haut quotidien le plus élevé de la part du fonds sur les 365 jours civils précédant la dernière date de prix, celle-ci incluse. |
| price.week52_low | number | USD | Plus bas quotidien le plus faible de la part du fonds sur les 365 jours civils précédant la dernière date de prix, celle-ci incluse. |
| price.avg_volume_10d | number | shares | Volume de trading quotidien moyen du fonds sur les 10 derniers jours de bourse, en parts. |
| price.count | number | — | Nombre d'éléments. |
| price.data | array | — | Charge utile. |
| price.data[] | object | — | Charge utile. |
| price.data[].date | string | — | Date calendaire (UTC). |
| price.data[].open | number | — | Prix d'ouverture de la période. |
| price.data[].high | number | — | Plus haut de la période. |
| price.data[].low | number | — | Plus bas de la période. |
| price.data[].close | number | — | Prix de clôture de la période. |
| price.data[].volume | number | — | Volume. |
| fund | object | — | Valeurs instantanées au niveau du fonds ; chacune est la dernière valeur connue et elles peuvent dater de jours différents (voir `aum_as_of`). |
| fund.aum_usd_million | number | million USD | Dernière valeur non nulle des actifs sous gestion du fonds, valable à la date `aum_as_of`. |
| fund.aum_as_of | string | — | Jour de bourse (YYYY-MM-DD) auquel se rapporte `aum_usd_million`. |
| fund.estimated_holdings | number | coin | Nombre estimé de cryptos détenues par le fonds : dernier AUM connu ÷ prix spot actuel de l'actif ; il s'agit d'une estimation, et non d'avoirs déclarés par l'émetteur. |
| fund.fee_pct | number | % | Frais de gestion annuels du fonds en pourcentage (0.25 = 0,25 % par an) ; dernière valeur connue issue d'une source tierce. |
| fund.mkt_share_pct | number | % | AUM du fonds en pourcentage de la capitalisation totale de la crypto sous-jacente (et non sa part parmi les ETF) ; dernière valeur connue issue d'une source tierce. |
| fund.volume_usd_million | number | million USD | Volume de trading du fonds le dernier jour où une source tierce l'a déclaré. |
| fund.cum_inflow_official_million | number | million USD | Flux net entrant cumulé depuis le lancement, tel que publié par une source tierce (dernière valeur connue) ; peut différer de la somme `flows.latest.cum_total`. |
| flows | object | — | Historique quotidien des flux nets du fonds avec total cumulé ; les montants sont en millions USD (`unit`). |
| flows.unit | string | — | Unité des valeurs de cet objet. |
| flows.latest | object | — | Enregistrement le plus récent. |
| flows.latest.date | string | — | Date calendaire (UTC). |
| flows.latest.flow | number | — | Flux net de créations / rachats du jour. |
| flows.latest.cum_total | number | — | Total cumulé. |
| flows.latest.sum_7d | number | — | Somme sur 7 jours. |
| flows.count | number | — | Nombre d'éléments. |
| flows.data | array | — | Charge utile. |
| flows.data[] | object | — | Charge utile. |
| flows.data[].date | string | — | Date calendaire (UTC). |
| flows.data[].flow | number | — | Flux net de créations / rachats du jour. |
| flows.data[].cum | number | — | Flux net cumulé depuis la cotation. |
| premium | object | — | Prime (+) ou décote (−) du cours de marché par rapport à la NAV. |
| premium.unit | string | — | Unité des valeurs de cet objet. |
| premium.note | string | — | Remarque. |
| premium.count | number | — | Nombre d'éléments. |
| premium.data | array | — | Charge utile. |
| premium.data[] | object | — | Charge utile. |
| premium.data[].date | string | — | Date calendaire (UTC). |
| premium.data[].premium | number | — | Prime (+) ou décote (−) du cours de marché par rapport à la NAV. |
Généré à partir de 1 réponses réelles (2026-11-11 23:00 UTC).
Exemple de réponse
/api/etf/fund/IBIT · Réponse réelle (capture : 2026-11-13 04:02:51 UTC). Les tableaux et dictionnaires longs sont abrégés pour l'affichage : flows.data comptait 712 éléments; price.data comptait 713 éléments; premium.data comptait 64 éléments.
- "success"true
- "ticker""IBIT"
- "asset""BTC"
- "issuer""BlackRock"
- "price"
- "currency""USD"
- "latest"
- "change_abs"-1.88
- "change_pct"-4.4508
- "week52_high"59.56
- "week52_low"32.84
- "avg_volume_10d"52099530
- "count"713
- "data"
- "fund"
- "aum_usd_million"62297.756
- "aum_as_of""2026-11-11"
- "estimated_holdings"905689.4173
- "fee_pct"0.25
- "mkt_share_pct"3.995
- "volume_usd_million"2604.817
- "cum_inflow_official_million"65711.051
- "flows"
- "unit""million_usd"
- "latest"
- "count"712
- "data"
- "premium"
- "unit""pct"
- "note""sparse_snapshot"
- "count"64
- "data"
Détails
- Authentification
- Aucune. Endpoint public.
- Limite de requêtes
- 1200 requêtes par minute et par IP
- Cache serveur
- 5m
- Micro-cache en périphérie
- 10s
- Fréquence de mise à jour
- toutes les heures (prix à la minute 20, flux à la minute 15) ; bougies quotidiennes
- Fenêtre
- historique quotidien stocké des prix et des flux ; plus haut / plus bas sur 52 semaines et volume moyen sur 10 jours
- Sources de données
- Données de la page d'un fonds : prix quotidiens du fonds issus d'un site public de données de marché, flux issus d'un site public de suivi des flux d'ETF.
- Couverture des plateformes
- 36 tickers d'ETF spot américains suivis (404 pour les tickers inconnus).
- Tri
- date croissante
- Unités
- USD (fund price), million USD (flows, AUM), percent (premium, fee), coins (estimated holdings)
- Méthode
- estimated_holdings = fund AUM in USD / latest coin price (an estimate, not issuer-reported holdings).
- 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 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 →
| 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/etf/fund/:tickerDisponiblestring — Fund ticker (letters only, upper-cased); 404 if unknown.
https://www.coinboss.com/api/etf/fund/IBITAutres endpoints de cette catégorie
- Fonds ETF spot /api/sd/etf/funds
- Historique des ETF spot /api/sd/etf/history
- Vue d'ensemble des ETF spot (publications des émetteurs) /api/sd/etf/overview
- Flux nets quotidiens des ETF spot par fonds /api/etf/detail
- Historique des flux nets quotidiens des ETF spot /api/etf/flows
- Détail d'un ETF /api/etf/fund/:ticker
- Liste des fonds ETF /api/etf/funds
- Avoirs en crypto des ETF par fonds /api/etf/holdings
- Produits ETF / trusts d'un émetteur /api/etf/issuer
- Vue d'ensemble des ETF /api/etf/overview
- Prime / décote des trusts Grayscale /api/grayscale/premium
- Volumes des ETF adossés à des futures /api/indicators/futures-etf-volumes