REST API

链上与网络

链本身反映的情况,与订单簿无关:比特币网络的状态、相对使用量的估值,以及以太坊的八个数据族。这些接口都是全市场数据:不接受 ?symbol=。

#更新频率与范围

这些数据族不按市场节奏刷新,每分钟查询毫无意义。

  • 比特币网络:内存池和手续费每分钟变化,网络状态每五分钟,挖矿数据每十分钟。
  • 比特币链上估值:每天一个数据点。序列按 date 标注,而不是时间戳。
  • 以太坊:供应、Gas 和 DeFi 数分钟更新一次;质押一小时一次。历史为日度。

每个接口都在 /history 下有对应历史,并支持 limit。都不接受交易对:传入 ?symbol=BTCUSDT 会被拒绝而不是忽略,以免全市场数字被归到单一资产名下。

#比特币网络

GET/v1/btc/networkdata_type · btc_network
字段类型说明
tip_heightinteger最新区块高度。
difficultyfloat当前难度。
progress_percentfloat当前调整周期的进度。
difficulty_changefloat下次调整的预计变化,以百分比表示。
block_timeobject平均出块时间及其与十分钟目标的差距。
GET/v1/btc/mempooldata_type · btc_mempool
字段类型说明
tx_countinteger待确认交易。
vsizeinteger待确认交易的总权重。
total_feefloat待确认交易的累计手续费。
fee_histogramarray按档位划分的手续费分布。
trendobject填充信号:filling、draining 或 stable。
GET/v1/btc/feesdata_type · btc_fees
字段类型说明
recommendedobject按优先级推荐的手续费,单位为聪/虚拟字节,取整。
preciseobject同上,以小数表示:适合构建交易的服务。
fee_pressurestring对拥堵程度的定性解读。
GET/v1/btc/miningdata_type · btc_mining

矿池集中度、区块奖励与难度调整。历史接口接受 dataset 参数,可在集中度、奖励、调整和费率之间选择。

字段类型说明
concentrationobjecttop1_share 与 top3_share:最大矿池以及前三大矿池挖出的区块占比。
latest_rewardobject观测到的最新区块奖励。

#比特币链上估值

四个把价格与链的实际使用情况相对照的指标。每个都给出一个 zone:用于解读的参考,而绝非交易信号。

GET/v1/onchain/mvrvdata_type · onchain_mvrv
curl -H "X-API-KEY: $BYTNODE_KEY" \
  "https://api.bytnode.com/v1/onchain/mvrv"

MVRV 将市值与币最后一次转移时的价值相比。高于 3.5 时历史上对应狂热;低于 1 时,市场交易价格低于平均获取成本。

GET/v1/onchain/nvtdata_type · onchain_nvt

NVT 将市值与链上交易量相比:把市销率应用于一个网络。它按需计算,并附带 nvt_signal——九十日平滑版本,噪音更小。

GET/v1/onchain/active-addressesdata_type · onchain_active_addresses

活跃地址数,附七日和三十日均值以及比较两者的动量。这是衡量使用情况最直接的指标。

GET/v1/onchain/miner-stressdata_type · onchain_miner_stress

矿工收入与难度之比。当它骤降时,效率最低的矿工会卖出储备,形成在订单簿中看不到的抛压。

#以太坊链上

八个数据族,均为全市场数据,均有日度历史。

GET/v1/eth/supplydata_type · eth_supply
字段类型说明
eth_supplyfloat流通供应量。
eth2_stakingfloat质押锁定量。
burnt_feesfloat自创世以来的累计销毁量。
burn_24hfloat最近 24 小时的销毁量。
net_issuance_24hfloat发行减去销毁。为负时供应收缩。
signalstring对净发行的定性解读。
GET/v1/eth/gasdata_type · eth_gas
GET/v1/eth/gas-momentumdata_type · eth_gas_momentum

Gas 价格、拥堵程度及其动量:当前值与七日和三十日均值的比较,以及由此得出的状态。Gas 是以太坊区块需求最灵敏的指标。

GET/v1/eth/stakingdata_type · eth_staking
字段类型说明
staking_ratiofloat被锁定的供应占比。
aprfloat | null质押收益。仅在当前值中提供:历史中为 null。
yield_spreadfloat | null与参考利率的差距。同上。
GET/v1/eth/deflationdata_type · eth_deflation

年化的销毁与发行对比,以及由此得出的区间。这是以太坊的货币视角:活跃度高时,网络销毁的多于发行的。

GET/v1/eth/defidata_type · eth_defi
字段类型说明
tvl_usdfloat以太坊 DeFi 锁定总价值。
dex_volume_24h_usd / dex_volume_7d_usdfloat去中心化交易所的成交量。
eth_market_cap_usdfloatETH 市值。
defi_health_ratiofloatDeFi 活跃度与市值之比。
trend_30dfloat三十日趋势。
GET/v1/eth/squeezedata_type · eth_squeeze

一个综合指数,结合锁定率与供应收缩:越高说明可用供应越稀缺。

GET/v1/eth/ratiodata_type · eth_ratio

ETH/BTC 比率、相对市值及其七日动量:衡量两种基准资产之间轮动的指标。

需要了解的依赖

supply、gas、staking、deflation 和 squeeze 数据族来自同一个上游数据源。如果你的安装未接入该数据源,它们会返回空,快照中的原因为 no_api_key。defi 和 ratio 不依赖它,仍会正常提供。