Chaconne API alpha

代币化美股的溢价历史、流动性评级、资产清单——免费·申请制。面向做市商、研究者、媒体。数据供参考,非投资建议;使用须标注来源 Chaconne。

鉴权

每次请求带头部：

x-api-key: ck_your_key

默认限速 60 请求/分钟。数据缓存约 30s。

机器可读的接口描述（OpenAPI 3.1）：/openapi.json

端点

「公开」端点无需 key（有短缓存，请勿高频轮询）；「key」端点需申请。字段表与样例按 2026-09-21 现网响应整理，数值仅示意。所有 bps 为万分之一（100 bps = 1%）。

GET /api/v1/assetskey展开字段与样例 ▾

全部代币化美股清单（含发行商 / 链 / 合约地址 / 流动性评级）

响应字段

attribution	string	署名要求，固定值
count	number	资产条数
assets[].symbol	string	代币符号，如 TSLAx
assets[].underlying	string	标的股票代码，如 TSLA
assets[].name_en / name_cn	string	中英文名
assets[].issuer	string	发行商：xstocks / ondo / bstocks
assets[].chain	string	链：solana / bnb
assets[].address	string	代币合约（mint）地址
assets[].tags	string[]	标签（板块等）
assets[].grade	'A'\|'B'\|'C'\|'D'\|null	流动性评级（无评级为 null）

响应样例

{"attribution":"Chaconne — chaconne.xyz","count":243,"assets":[{"symbol":"TSLAx","underlying":"TSLA","name_en":"Tesla xStock","name_cn":"特斯拉","issuer":"xstocks","chain":"solana","address":"XsDoVfqeBukxuZHWZ…","tags":["auto"],"grade":"A"}]}

错误码

401 missing_api_key — 缺 x-api-key
403 invalid_api_key / revoked_api_key / key_pending_approval — key 无效 / 已吊销 / 待审批
429 rate_limited — 超过每分钟限额（默认 60）
503 unavailable — 数据库不可用

GET /api/v1/liquidity-scoreskey展开字段与样例 ▾

流动性评级 A/B/C/D 与 $1k / $10k 价格冲击（7 日滚动中位）

响应字段

methodology	string	评级方法说明（固定文本）
scores[].symbol	string	代币符号
scores[].grade	'A'\|'B'\|'C'\|'D'	A≤50 / B≤150 / C≤500 bps@$10k，D>500 或无路由
scores[].impact_1k_bps / impact_10k_bps	number\|null	买入 $1k / $10k 的不利冲击（bps），无路由为 null
scores[].sample_n	number	7 日样本数（少于 3 请当作样本不足）
scores[].updated_at	ISO datetime	最近更新时间（UTC）

响应样例

{"attribution":"Chaconne — chaconne.xyz","methodology":"7-day rolling median price impact at $1k/$10k; A<=50/B<=150/C<=500 bps@10k, D>500 or no route","scores":[{"symbol":"NVDAx","grade":"A","impact_1k_bps":6,"impact_10k_bps":21,"sample_n":168,"updated_at":"2026-09-21T08:00:00.000Z"}]}

错误码

401 / 403 / 429 / 503 — 同上

GET /api/v1/premium-history?symbol=NVDAx&days=30key展开字段与样例 ▾

某资产的小时级溢价历史（bps，最多 90 天）

参数

symbol	string（必填，1–12 位字母数字）	代币符号
days	number（1–90，默认 30）	回看天数

响应字段

symbol / days	string / number	回显参数
points[].ts	ISO datetime	小时桶起点（UTC）
points[].premium_bps	number\|null	该小时收盘溢价（正 = 链上比股市贵）；参考价缺失时为 null

响应样例

{"attribution":"Chaconne — chaconne.xyz","symbol":"NVDAx","days":30,"points":[{"ts":"2026-09-19T14:00:00.000Z","premium_bps":-42}]}

错误码

400 bad_symbol — symbol 不合法
401 / 403 / 429 / 503 — 同上

GET /api/market-overview?days=90公开展开字段与样例 ▾

全市场总量：实时 24h 成交 / 流动性 / 资产数 + 本站自采的逐日快照（全市场 / 发行商 / 链三层）

参数

days

number（1–365，默认 90）

历史窗口

响应字段

live.vol24Usd / liquidityUsd	number\|null	实时 24h 链上成交额 / 流动性（USD）
live.assetCount	number	已上架代币数（与站内统计页、/api/v1/assets 的 count 同一口径）
live.tokensWithDexData	number	其中有 DEX 成交 / 流动性数据的代币数（X Layer 暂无）
series[].day	YYYY-MM-DD	快照日（UTC）
series[].scope	string	all / issuer:xstocks / chain:solana …
series[].vol / liq / cnt	number	当日 24h 成交 / 流动性（USD）/ 有 DEX 数据的代币数

响应样例

{"days":90,"series":[{"day":"2026-09-20","scope":"all","vol":"71234567.12","liq":"43876543.10","cnt":243}],"live":{"vol24Usd":77489938.29,"liquidityUsd":44184814.89,"assetCount":284,"tokensWithDexData":243}}

错误码

200 {series:[],live:null} — 数据库不可用时返回空（不报错）

GET /api/premium/history?symbol=GLDx&days=7公开展开字段与样例 ▾

某资产小时级溢价 + 净价差历史（含每小时最小/最大）

参数

symbol	string（必填）	代币符号
days	number（1–30，默认 7）	回看天数

响应字段

points[].t	number（Unix 秒）	小时桶起点
points[].premium / lo / hi	number\|null（bps）	小时收盘 / 最小 / 最大溢价
points[].net_edge	number\|null（bps）	扣平台费与 $1k 冲击后的净价差（负 = 比股市贵）

响应样例

{"symbol":"GLDx","days":7,"points":[{"t":1789992000,"premium":-38,"lo":-55,"hi":-12,"net_edge":-102}]}

错误码

200 {points:[]} — 无数据 / 数据库不可用

GET /api/basis/history?underlying=TSLA&days=7公开展开字段与样例 ▾

现货-永续基差小时历史（对应 /basis 页），含资金费年化

参数

underlying	string（必填，股票代码）	标的，如 TSLA
days	number（1–30，默认 7）	回看天数

响应字段

points[].t	number（Unix 秒）	小时桶起点
points[].basis / lo / hi	number\|null（bps）	小时收盘 / 最小 / 最大基差
points[].funding_annual	number\|null（bps）	资金费年化（小时收盘）

响应样例

{"underlying":"TSLA","days":7,"points":[{"t":1789992000,"basis":12,"lo":-4,"hi":31,"funding_annual":820}]}

错误码

200 {points:[]} — 该标的暂无基差数据（永续对照源未覆盖）

# key 端点
curl https://chaconne.xyz/api/v1/liquidity-scores \
  -H "x-api-key: ck_your_key"
# 公开端点
curl "https://chaconne.xyz/api/premium/history?symbol=GLDx&days=7"

给 Agent 的核验与受约束执行 API（报告 / 规划 / 授权计划 / 证据包）在子站 verify.chaconne.xyz/developers。

鉴权

端点

申请 key（免费）