API-first · JSON 是产品，网页只是渲染层

开发者接口

同一个数据集三种消费方式：人看页面、程序读 JSON、Agent 调 MCP。 免费层永久提供 T+1 汇总水位，无需信用卡、无需审批。

REST

端点

Base URL https://spreadbench.com/api · 全部响应 UTF-8 JSON · 时间字段为 ISO 8601（美东日历日）。

GET/v1/latest最新三档水位 + 变动 · 免费
GET/v1/constituents成分券清单与逐券利差 · 免费
GET/v1/methodology方法论元数据、版本号、DOI · 免费
GET/v1/levels/{index}?from=&to=单档历史序列（composite / ig / hy）
GET/v1/constituents/{cusip}单券全字段 + 30 日利差路径
GET/v1/trades?cusip=&date=逐笔 TRACE 成交明细（时间 / 价格 / 面值）
POST/v1/webhooks水位突破阈值推送（如 HY 单日走阔 > 50bp）
Request
curl -s https://spreadbench.com/api/v1/latest.json \ -H "Authorization: Bearer ncsx_live_xxx" | jq
Response 200 OK
Live console

在线试一试

下面不是模拟响应——点击即真实请求本站 JSON 端点并回显结果。免费层无需 Key。

API 控制台

api/v1/latest.json
点击「发送请求」…
Downloads

数据下载

全部在浏览器本地生成，不经过服务器。CSV 带 UTF-8 BOM，Excel 直接打开不乱码。

成分券与逐券利差

CSV
20 只 · 20 个字段 · 含评级 / 分档 / 逐日变动
  • 与 /v1/constituents 同源
  • 含 trace_verified 标记

指数历史序列

CSV
90 交易日 · 三档水位 · 含全市场宽基背景层
  • 与 /v1/history 同源
  • 可直接做时间序列分析

变动归因

CSV
20 只 × 权重 × Δ利差 × 贡献 bp
  • Composite / HY / IG 三档
  • 1D / 5D / 30D 三周期可切换下载
Agents

MCP Server

利差是 Agent 做信用判断的天然输入——"CoreWeave 的信用贵了多少"一句话可查。 终端商没有 MCP 接口，这是 SpreadBench 的结构性空位。

Tools

$0.05 / 次
Tool说明
ncsx.get_latest取最新三档水位与变动
ncsx.get_constituent按 CUSIP / 发行人查单券利差
ncsx.get_history取指定档位历史序列
ncsx.compare跨发行人 / 跨档对比利差
ncsx.explain返回该值的复算路径与成交来源
{ "mcpServers": { "ncsx": { "command": "npx", "args": ["-y", "@ncsx/mcp"], "env": { "NCSX_API_KEY": "ncsx_live_xxx" } } } }
为什么按次计费：Agent 的调用频次高但单次价值低。$0.05/次让"顺手查一下"的成本趋近于零， 同时把高频深度使用自然导流到订阅层。
llms.txt

给模型看的站点说明

遵循 llms.txt 约定：把"这个站点是什么、数据怎么取、口径是什么"写成模型可直接解析的纯文本， 让引用方（模型 / 媒体 / 研究）不需要爬页面就能拿到准确口径。

打开 llms.txt
Tiers

接口权限对照

能力 免费层 Free订阅 Pro机构 Enterprise
T+1 三档汇总水位✓✓✓
成分券清单与逐券利差✓✓✓
完整历史序列仅 90 日全历史全历史
逐笔 TRACE 成交明细—✓✓
Webhook 阈值推送—✓✓
MCP 调用100 次/月10,000 次/月不限
速率限制60 req/min600 req/min定制
SLA / 再分发授权——✓
查看定价 申请 Key
Embed · 不想写代码？

用静态徽章，一行 <img> 就能嵌

320×86 紧凑徽章 / 480×200 带走势卡片 · 零 JS · 零外链 · 图内自带 as-of 日期。 Markdown、Notion、公众号、邮件签名都能直接用。

看嵌入说明 看一个徽章