方法论：参考价格如何构建

参考价格如何构建

CantonCap API 约每分钟重新计算一次每个资产的参考价格，覆盖其发布的每种货币。其输入是 Canton 公开交易场所对该资产的报价：每个市场的行情数据；若某市场不发布行情，则采用其资金池状态。以另一资产（如稳定币或 Canton Coin）计价的价格，会通过该资产自身的参考价格换算，因此不会假定任何稳定币恰好价值一美元。

参考价格仅由满足以下条件的观测值构建：足够新鲜、流动性足以具有意义，并且能以所请求的货币取得。交易场所的资金池状态、可执行的订单簿档位以及已结算的交易场所成交，均可作为直接成分。带货币标签的外部参考价可将这些观测值换算为目标货币，但通常本身不会成为独立的价格成分。

报价只有在运营方设定的范围内才会计入：背后有足够的流动性；与同类报价的偏离不超过异常值阈值；价差和价格冲击在限定范围内；单一交易场所对结果的影响设有上限；换算步骤数有限制；并设有最长时效。通过检查的报价经加权合成为一个数值。每个资产单独计算，因此一个资产出现故障绝不会拖累其他资产。

Canton Coin 的美元价格取三家独立中心化交易所参考价的中位数，即 Bybit CC/USDT、OKX CC/USDT 和 Kraken CC/USD，其中 USDT 交易对按 Kraken 的 USDT/USD 汇率以精确十进制换算。该价格以带标签的汇总值形式发布，附带其三个来源，既是换算路径，也是直接成分。

每个价格旁的依据

每个资产页面都会显示各交易场所的报价：每个交易场所对该资产的最新价格、最低价与最高价之间的价差，以及它们的中位数。仅使用该资产作为基础资产的市场，并且只取市场数量最多的那一种计价资产，因为以不同计价资产表示的价格无法共用一条坐标轴。

交易场所数量为偶数时，中位数取中间两个报价中较低的一个，而非二者的平均值，因此它始终是某个交易场所实际报出的价格。依据是对参考价格的公开核对，而非计算本身；计算所用的权重和排除项属于管理记录。

价格来源

AMM 资金池venue_pool: 由 Canton 交易场所的链上资金池储备推导得出。
订单簿venue_book: 由 Canton 交易场所可执行的订单簿档位推导得出。
交易场所成交venue_trade: 取自交易场所成交日志中的已结算成交。
外部参考价external_reference: 带货币标签的参考价，用于换算，而非直接设定价格。
派生derived: 由其他已采纳的观测值计算得出，而非直接观测。

每个观测值需通过的检查

观测值须先经过 15 项检查评分，才能支撑已发布的数据。任一检查未通过，都会记录为质量事件，并注明所处阶段和对应的检查项。

这些记录属于管理信息而非公开信息：公共 API 发布的是最终保留的数值及其最后更新时间，而非审计记录。公共用户可以直接查看的是各交易场所之间的价差，参见任一资产页面。

小数有效性decimal_validity: 报告的数值无法解析为精确的小数。
时间戳有效性timestamp_validity: 观测值的时间缺失或不合理。
身份解析identity_resolution: 该记录无法关联到已知的资产或市场。
价格有效性price_validity: 价格不为正数，或超出该金融工具可取值的范围。
储备有效性reserve_validity: 资金池储备与其声称遵循的曲线不一致。
订单簿交叉book_crossed: 最优买价高于最优卖价，因此订单簿内部不一致。
空订单簿book_empty: 订单簿的一侧或两侧没有可用于定价的档位。
序列号缺口sequence_gap: 数据源的序列号出现跳号，因此至少遗漏了一次更新。
数据过期staleness: 观测值早于本次计算的时效窗口。
价格异常值price_outlier: 价格超出了同类报价可接受的离散区间。
供应量跳变supply_jump: 两次观测之间报告的代币供应量变动超出了发行所允许的范围。
OHLC 一致性ohlc_invariant: 某根 K 线违反了其自身的约束条件——最高价低于开盘价、最低价高于收盘价等。
重复事件duplicate_event: 同一数据源事件到达了两次，仅计入一次。
交易量核对volume_reconciliation: 报告的交易量与同一时间窗口内观测到的成交不一致。
依赖项不可用dependency_availability: 计算该数据时，其所依赖的某项输入不可用。

流动性与流动性评分

AMM 资金池的流动性是其储备的美元价值：每项储备按其资产的参考价格计算，并通过 Canton 身份进行匹配。若某项储备的资产没有价格，该数值将留空而不作猜测；空资金池的流动性为零。订单簿则以深度衡量，因此订单簿市场没有单一的流动性数值。

2% 以内深度是指价格偏离参考价 2% 之前可买入或卖出的美元价值：订单簿的深度读取自其自身的价格档位，AMM 的深度则根据资金池存储的状态（含费率）建模得出。建模深度衡量的是曲线，既不是报价，也不是成交承诺。

流动性评分按在某市场交易的成本，为其给出 0 到 100 的评分。API 针对该市场的当前状态模拟 $100、$500、$1,000、$5,000和$10,000 的买入和卖出（不含费用），并将价格冲击以及每笔能否成交综合为一个评分。输入不足的市场没有评分，这与零分绝不相同。

资产的评分是其评分最高的三个市场（交易对任一方）评分的平均值；评分市场不足三个时取全部评分市场的平均值，因此只有一个评分市场的资产即采用该市场的评分。交易场所的评分则是其所有市场评分的平均值。“流动性最高”视图按资产评分对资产排名。

24 小时交易量

交易量在全站只有一个定义，因此表格与总计不会互相矛盾。市场以美元计的 24 小时交易量，优先采用 API 对其的活动测量值；若无，则采用交易场所在其行情中报告的美元交易量；再无，则采用其以计价资产计的交易量，并按该资产的参考价格换算。资产的交易量是其参与交易的所有市场（交易对任一方）之和；交易场所的交易量是其所有市场之和；网络的交易量则将每个市场只计一次。

活动测量为每个时段选定一个名义价值，优先采用基于不超过三分钟的交易所锚定价格得出的美元值，并且绝不将交易场所报告的交易量与从其成交中观测到的交易量相加。测量值由每小时切片汇总而成，每五分钟生成一次新快照。

交易量数据会附带其注意事项。某次刷新没有可用数值时，API 会保留最近一次的数值及其时间；一旦该时间超过一小时，该数据将以弱化样式显示并标注其所属时间，绝不当作当前数据。部分数据只覆盖 24 小时中的一部分，并会如实注明；估算值也会标为估算。未知数据绝不显示为零；若总计包含较旧、部分或估算的数据，会注明其数量。

Rocky 报告的交易量会显示在其自身的市场上，以弱化样式显示并注明原因，在与其成交记录核对一致之前不计入任何总计：其最初的数据高达所上线资产供应量的数倍。

完全稀释估值

FDV 是经采纳的参考价格与经批准登记机构最新发布的、符合政策的总供应量观测值的精确十进制乘积。如果供应量观测值超过方法论允许的最长时效，或尚无经批准的登记机构发布该数据，则不计算 FDV，并在数字的位置说明原因。

总供应量是经批准的登记机构为该金融工具发布的数值，完全按报告值保留：绝不取整、缩放或插值。若两次观测之间的供应量变动超出发行所允许的范围，供应量跳变检查会将其标记。流通供应量和最大供应量不予发布。

市值

不发布市值。市值需要流通供应量数据，而 Canton 金融工具尚无经审核的流通供应量方法论；将流通供应与锁定、金库持有及受合约限制的供应区分开来，是治理问题而非数据问题。

API 会在返回数据中说明这一点，而不是返回空字段：全局指标响应中包含 market_cap.semantics = "unavailable_circulating_supply"。在该方法论建立之前，Canton 资产的市值只是猜测，而本产品不发布猜测。

排名与比率

排名依据每个收录资产的 FDV、资金池流动性和滚动 24 小时交易量对其排序。排名在整个收录列表上统一计算一次，因此资产在每个页面、每种货币和每种排序方式下的排名都相同。

流动性 / FDV 是将资产 AMM 资金池中的美元流动性除以其 FDV，每个符合条件的资金池只计算一次。不含订单簿深度。该比率不设上限：估值较小而资金池较深的资产可能超过 100%。

交易量 / FDV 是将资产可获得的最佳滚动 24 小时美元交易量（采用报告值或观测到的成交，但绝不将两者相加）除以其 FDV：即估值中在一天内易手的比例。

当 FDV 缺失、过期或为零，或没有可除的数值时（例如没有资金池的资产就没有流动性比率），相应比率不予显示。每个比率都附带其覆盖范围，因此仅基于部分市场计算的数据会如实注明。

两者都按同一套四级区间解读，以每个数据旁的条形标示。

区间	范围	流动性 / FDV	交易量 / FDV
稀薄, 清淡	低于 1%	稀薄	清淡
偏浅, 偏低	1%–5%	偏浅	偏低
适中, 活跃	5%–10%	适中	活跃
深厚, 旺盛	10% 及以上	深厚	旺盛

图表：K 线与折线

K 线以美元显示资产的开盘价、最高价、最低价和收盘价，由 API 汇总其用于为该资产定价的各市场数据；如有发布交易量，则显示在下方。选项按钮决定一根 K 线覆盖的时长：15m、1h、4h、24h、1W 或 1M。最短的三种约回溯两百根 K 线，24h 回溯一年，1W 和 1M 回溯全部历史。

API 提供的 K 线最长为一周，因此月 K 线由日 K 线按 UTC 日历月构建：以当月第一个开盘价开盘，以最后一个收盘价收盘，覆盖最高的最高价和最低的最低价，并将当月各日发布的交易量相加。

K 线连接成一条连续记录：每根 K 线都从前一根的收盘价开盘；没有任何成交的区间显示为位于前一收盘价、无交易量的平 K 线，而不是空缺。K 线的最高价和最低价会扩展以包含其开盘价，因此实体绝不会超出影线。

折线绘制参考价格本身，范围为 24h、1W、1M、1Y 或“全部”，每个区间一个点，取该区间内的最新价格：24 小时内每 15 分钟一个点，一周内每小时一个点，一个月内每 4 小时一个点，一年或更长时间则每天一个点。高于该范围第一个点时显示为绿色，低于时显示为红色。

图表能回溯多远，取决于 API 保存的历史以及本站访问权限所允许的范围，并以最长 31 天的窗口读取。若某数据源的历史始于 CantonCap 开始观测之时，则更早的时段并不存在。表格每一行中的小折线是该资产过去 24 小时的每小时参考价格。

更新频率与时间戳

交易场所每 30 秒到 5 分钟读取一次，视各交易场所的允许频率而定；参考价格约每分钟重新计算一次。本站会在短时间内复用每次应答：数据源状态为 30 秒，价格、收录列表和市场为 1 分钟，交易量、交易场所、图表和迷你走势图为 5 分钟。打开的市场表格每 45 秒检查一次新价格。

API 发布的所有时间均为 UTC，本站显示的时间也均为 UTC。计算得出的价格附带其计算时间；基于时间窗口的测量值附带其所覆盖窗口的结束时间，而非读取时间。窗口包含起点、不含终点。每项数据旁都会显示其时效；最新价格超过半小时后，应用会将价格标记为延迟。应用中的图表坐标轴按手机本地时间显示。

示例数据与实时数据

每项数据都在页面构建时从 CantonCap API 读取，每次读取都会记录返回的是否为实时数据。在生产环境中，若无法连接 API，页面会显示错误或如实留空，绝不会显示一整页编造的数据。

无法连接 API 时，开发版和预览版可以显示一套固定的示例数据集。基于该数据集生成的页面始终带有示例数据横幅并说明原因，其中的数据仅作示意，并非市场行情。示例数据绝不会被当作真实数据展示。

自选人数、会员情绪与发行方帖子

“N 人自选”统计当前将某资产加入自选的会员人数，仅计入已登录会员的列表。这只是一个总数，绝不会显示任何人的列表。本站最多每分钟刷新一次。

情绪仪表按会员计数，每位会员对每项资产只计一次。会员在资产页面投出的看涨或看跌票自投票起七天内有效；尚未投票的会员，则按其过去七天内关于该资产的最新一条主帖的倾向计入，不包括回复、已隐藏和已删除的帖子。在表明立场的会员中，看涨者所占的比例显示在一个均分为五个区间的表盘上，从强烈看跌到强烈看涨。这只是观点的统计，并非交易信号；无人表明倾向时，表盘保持空白。

发行方动态显示发行方或资产提供方在 X 上发布的帖子，仅限 API 列出该发行方与该资产之间存在经批准关联的情况；绝不通过匹配交易代码来选择动态。帖子按原样显示，附带 UTC 时间和原帖链接。已编辑的帖子显示其最新版本，被限制显示、受保护和已删除的帖子会被移除。打开的页面每 30 秒重新检查一次，所显示的帖子均来自 90 秒以内的应答。CantonCap 不为发行方发布的内容背书。