Données de marché

API de tokenomics pour agents IA

L’offre et la valorisation de chaque actif dans une seule API : offre en circulation, totale et maximale, capitalisation et valorisation entièrement diluée, plus la capitalisation totale, le volume et la dominance de BTC et d’ETH. Pas de tracker de capitalisation à recouper : les chiffres arrivent avec la même clé et le même format que vos données de marché.

L’offre de chaque actif et ce qui en découle, capitalisation et valorisation diluée, plus l’état de tout le marché. Tokenomics prend un ?symbol= ; le marché global, non. Le marché global compte dans la famille Marché (prix et volume), pas dans Tokenomics : il est ouvert à toute offre qui a le marché.

#Données de tokenomics pour agents IA et LLM

« Quelle est la valorisation entièrement diluée de SOL ? », « Quelle part de l’offre de XRP circule ? », « Quelle est la dominance de Bitcoin aujourd’hui ? » : un agent IA répond par l’outil MCP get_pair_data pour un actif, et get_market_overview pour tout le marché.

MCP tools/call

L’offre et la valorisation de SOL en un appel MCP.

{
  "name": "get_pair_data",
  "arguments": {
    "symbol": "SOLUSDT",
    "fields": ["tokenomics"]
  }
}

Pour le LLM : la FDV n’est pas la capitalisation : elle valorise l’offre maximale, ou l’offre totale quand il n’y a pas de plafond, et vaut null sur un stablecoin.
Pour les développeurs : /v1/tokenomics et /v1/global font deux outils pour votre propre agent IA (tool calling) : l’un par actif, l’autre pour tout le marché.
Où ça tourne : Claude, ChatGPT, Cursor et tout client MCP, y compris les frameworks d’agents qui parlent MCP, comme LangChain ou n8n.

Branchez votre agent IA avec le guide du serveur MCP, ou apprenez-lui BytNode avec les Agent Skills open source.

#Tokenomics et marché global

GET/v1/tokenomicsdata_type · tokenomicsRéférence complète

Les 8 champs de cette route (d’après le contrat)

`time`	ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z)	Point-in-time value: the instant of the measurement (when the source was read).
`circulating_supply`	coins	Coins in circulation.
`total_supply`	coins	Total coins issued (circulating + locked), net of burns.
`max_supply`	coins	Hard cap on supply. `null` = no cap.
`price_usd`	USD	Price used for market_cap_usd and fdv_usd: the close of the latest closed one-minute candle (the USDT price of the pair, read as USD), refreshed every minute. Not the latest trade price: that is the `price` of `/v1/price-change`, i.e. the close of `/v1/klines?live=1`.
`priced_at`	ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z)	Instant of `price_usd` (the row's `time` is the instant of the supply data). `null` when the price is the stablecoin peg.
`market_cap_usd`	USD	circulating_supply × current price, in USD, derived at request time.
`fdv_usd`	USD	Fully diluted valuation: max_supply (or total_supply if uncapped) × price. `null` for stablecoins.

GET/v1/tokenomics/historydata_type · tokenomics_historyRéférence complète

Les 8 champs de cette route (d’après le contrat)

`time`	ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z)	The day the value refers to, at midnight UTC.
`price_usd`	USD	Daily closing price used for the derived values.
`circulating_supply`	coins	Coins in circulation.
`total_supply`	coins	Total coins issued (circulating + locked), net of burns.
`max_supply`	coins	Hard cap on supply. `null` = no cap.
`market_cap_usd`	USD	circulating_supply × current price, in USD, derived at request time.
`fdv_usd`	USD	Fully diluted valuation: max_supply (or total_supply if uncapped) × price. `null` for stablecoins.
`is_closed`		`true` = the row is final; `false` = provisional: the latest bucket while it still settles (a few seconds after its end, e.g. a candle whose volumes are not final yet), or the period in progress with `?live=1` on the routes that take it. Exception, rare: when a venue delivers trades LATE (seconds to minutes, e.g. during a burst), a closed row built from trades (trade candles, candle volumes, CVD, buy/sell ratio, trades per second) is corrected afterwards to include them, usually within minutes and at most one hour later; the correction only adds the late trades.

L’offre de l’actif et ce qui en découle. C’est la seule famille de cette page qui prend un ?symbol=.

Champ	Type	Description
`circulating_supply`	float	Offre en circulation.
`total_supply`	float	Offre totale émise.
`max_supply`	float \| null	Plafond, quand l’actif en a un.
`price_usd`	float	Le prix de référence utilisé pour le calcul, en USD.
`priced_at`	string \| null	Instant de price_usd (time est l’instant des données d’offre) ; null quand le prix est l’ancrage du stablecoin.
`market_cap_usd`	float	Capitalisation, dérivée à la demande (offre multipliée par le prix), jamais reprise telle quelle d’une source tierce.
`fdv_usd`	float \| null	Valorisation entièrement diluée. Calculée sur l’offre totale quand il n’y a pas de plafond ; null sur un stablecoin.

GET/v1/globaldata_type · globalRéférence complète

Les 7 champs de cette route (d’après le contrat)

`time`	ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z)	Point-in-time value: the instant the source states for its measurement (often the last millisecond of its minute, `…:59.999Z`).
`market_cap_total_usd`	USD	Total crypto market capitalisation.
`volume_total_usd`	USD	Total traded volume, USD.
`btc_dominance_pct`	percent (58.5 = 58.5 %)	Bitcoin share of the total market cap.
`eth_dominance_pct`	percent (58.5 = 58.5 %)	Ether share of the total market cap.
`others_dominance_pct`	percent (58.5 = 58.5 %)	Share of every other asset.
`active_cryptocurrency_count`	count	Number of tracked crypto assets.

GET/v1/global/historydata_type · global_historyRéférence complète

Les 8 champs de cette route (d’après le contrat)

`time`	ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z)	The instant the source states for each measurement.
`market_cap_total_usd`	USD	Total crypto market capitalisation.
`volume_total_usd`	USD	Total traded volume, USD.
`btc_dominance_pct`	percent (58.5 = 58.5 %)	Bitcoin share of the total market cap.
`eth_dominance_pct`	percent (58.5 = 58.5 %)	Ether share of the total market cap.
`others_dominance_pct`	percent (58.5 = 58.5 %)	Share of every other asset.
`active_cryptocurrency_count`	count	Number of tracked crypto assets.
`is_closed`		`true` = the row is final; `false` = provisional: the latest bucket while it still settles (a few seconds after its end, e.g. a candle whose volumes are not final yet), or the period in progress with `?live=1` on the routes that take it. Exception, rare: when a venue delivers trades LATE (seconds to minutes, e.g. during a burst), a closed row built from trades (trade candles, candle volumes, CVD, buy/sell ratio, trades per second) is corrected afterwards to include them, usually within minutes and at most one hour later; the correction only adds the late trades.

Champ	Type	Description
`market_cap_total_usd`	float	Capitalisation de tout le marché.
`volume_total_usd`	float	Volume échangé sur 24 h.
`btc_dominance_pct / eth_dominance_pct`	float	Part des deux actifs majeurs, en pourcentage : 58.5 signifie 58,5 %.
`others_dominance_pct`	float \| null	Le reste, dérivé : 100 moins les deux. null si l’un des deux manque.
`active_cryptocurrency_count`	integer	Nombre d’actifs listés.

/v1/global/history rend par défaut une ligne par publication de la source, à un rythme irrégulier ; ?timeframe=1h, 4h ou 1d garde la dernière valeur de chaque bucket clos, datée au début du bucket.