快速开始
无需密钥或登录。响应是固定外层结构的 JSON。
curl -s "https://cunex.app/api/v1/pulse?limit=5"
# conditional request
curl -s -H 'If-None-Match: "<etag>"' -i "https://cunex.app/api/v1/pulse?limit=5"const res = await fetch("https://cunex.app/api/v1/pulse?limit=5");
const { data, meta } = await res.json;
console.log(data[0].symbol, data[0].move_pct, meta.attribution.text);import json
import urllib.request
with urllib.request.urlopen("https://cunex.app/api/v1/pulse?limit=5") as r:
body = json.load(r)
print(body["data"][0]["symbol"], body["meta"]["attribution"]["text"])在线试用
接口目前无法访问。
响应接口列表
只读,仅 GETGET/api/v1可用接口索引
示例
{
"endpoints": [
{
"path": "/api/v1/pulse",
"summary": "Current unusual moves with documented triggers"
}
],
"openapi": "/api/v1/openapi.json",
"docs": "/developers"
}GET/api/v1/pulse带有记录在案原因的当前异常波动
| 名称 | 允许的值 | 默认 | 说明 |
|---|---|---|---|
kind | stock | crypto | index | etf | commodity | fx | rate | – | 仅此资产类别 |
limit | 1–100 | 50 | 每页条数(1 到 100) |
示例
[
{
"id": "3f9a1c0d2b7e",
"symbol": "NVDA",
"name": "Nvidia",
"kind": "stock",
"sector": "Information Technology",
"move_pct": 8.42,
"x_usual": 3.4,
"bucket": "own",
"causes": [
{
"type": "earnings",
"grade": "strong",
"title": "Earnings after market close the previous day",
"ts": "2026-11-09T21:05:00Z",
"class": "F"
}
],
"date": "2026-11-10",
"class": "S"
}
]GET/api/v1/pulse/archive过往波动记录,含 1 个和 5 个交易日后的结果
| 名称 | 允许的值 | 默认 | 说明 |
|---|---|---|---|
date | YYYY-MM-DD | – | 仅此日期(YYYY-MM-DD) |
symbol | string | – | 仅此代码,例如 NVDA |
cursor | string | – | 来自 meta.next 的后续令牌 |
limit | 1–100 | 25 | 每页条数(1 到 100) |
示例
[
{
"id": "3f9a1c0d2b7e",
"symbol": "NVDA",
"name": "Nvidia",
"kind": "stock",
"sector": "Information Technology",
"move_pct": 8.42,
"x_usual": 3.4,
"bucket": "own",
"causes": [
{
"type": "earnings",
"grade": "strong",
"title": "Earnings after market close the previous day",
"ts": "2026-11-09T21:05:00Z",
"class": "F"
}
],
"date": "2026-11-10",
"class": "S",
"outcomes": {
"t1": {
"return_pct": 0.9,
"continued": true,
"reversed": false,
"method_version": "t15-v1",
"class": "S"
},
"t5": null
},
"corrected": null
}
]GET/api/v1/pulse/quality记录战绩:1 个和 5 个交易日后延续的比例
示例
{
"entries": 214,
"since": "2026-10-13",
"last": "2026-11-10",
"days": 21,
"min_cases": 8,
"continued_next_day": {
"n": 120,
"k": 66,
"share_pct": 55.0,
"ci95": [
46.0,
63.7
],
"class": "S"
},
"continued_after_5_days": {
"n": 120,
"k": 66,
"share_pct": 55.0,
"ci95": [
46.0,
63.7
],
"class": "S"
},
"with_documented_cause": {
"n": 160,
"share_pct": 74.8,
"ci95": [
68.5,
80.2
],
"class": "S"
},
"class": "S",
"by_first_cause": [
{
"type": "macro",
"n": 61,
"continued_next_day": {
"n": 120,
"k": 66,
"share_pct": 55.0,
"ci95": [
46.0,
63.7
],
"class": "S"
},
"continued_after_5_days": {
"n": 120,
"k": 66,
"share_pct": 55.0,
"ci95": [
46.0,
63.7
],
"class": "S"
},
"class": "S"
}
],
"outcomes": {
"t1": {
"horizon_days": 1,
"logged": 214,
"results": 200,
"pending": 14,
"continued": {
"n": 200,
"k": 110,
"share_pct": 55.0,
"ci95": [
48.1,
61.7
],
"class": "S"
},
"reversed": {
"n": 200,
"k": 40,
"share_pct": 20.0,
"ci95": [
15.0,
26.1
],
"class": "S"
},
"neither": {
"n": 200,
"k": 50,
"share_pct": 25.0,
"ci95": [
19.5,
31.5
],
"class": "S"
},
"period": {
"from": "2026-10-13",
"to": "2026-11-09"
},
"state": "ok",
"class": "S"
},
"t5": {
"horizon_days": 5,
"logged": 214,
"results": 0,
"pending": 214,
"continued": {
"n": 0,
"k": 0,
"share_pct": null,
"ci95": null,
"class": "S"
},
"reversed": {
"n": 0,
"k": 0,
"share_pct": null,
"ci95": null,
"class": "S"
},
"neither": {
"n": 0,
"k": 0,
"share_pct": null,
"ci95": null,
"class": "S"
},
"period": null,
"state": "none",
"class": "S"
}
},
"protocol": {
"class": "S",
"entries": 214,
"explained": {
"n": 214,
"k": 160,
"share_pct": 74.8,
"ci95": [
68.5,
80.2
],
"class": "S"
},
"by_grade": {
"strong": {
"n": 120,
"k": 66,
"share_pct": 55.0,
"ci95": [
46.0,
63.7
],
"class": "S"
},
"weak": {
"n": 120,
"k": 66,
"share_pct": 55.0,
"ci95": [
46.0,
63.7
],
"class": "S"
},
"none": {
"n": 120,
"k": 66,
"share_pct": 55.0,
"ci95": [
46.0,
63.7
],
"class": "S"
}
},
"days": {
"first": "2026-10-13",
"last": "2026-11-10",
"logged": 21,
"weekdays_in_span": 21,
"weekday_coverage_pct": 100.0
},
"result_completeness": {
"t1": {
"eligible": 200,
"with_result": 198,
"complete_pct": 99.0,
"expired_without_result": 0
},
"t5": {
"eligible": 120,
"with_result": 118,
"complete_pct": 98.3,
"expired_without_result": 0
}
},
"assignment_review": {
"state": "none",
"sample": 0,
"misattributed": {
"n": 0,
"k": 0,
"share_pct": null,
"ci95": null,
"class": "S"
},
"counts_for_gate": false,
"date": null
}
}
}GET/api/v1/pulse/head记录哈希链的链头:每个文件、每天的最新哈希,用于核对内容未被改动
| 名称 | 允许的值 | 默认 | 说明 |
|---|---|---|---|
month | string | – | 仅此月份(YYYY-MM),含每日数值 |
示例
{
"chain": {
"id": "cunex-pulse-chain-1",
"algorithm": "sha256",
"canonical": "json, keys sorted, no spaces, UTF-8, no ASCII escapes",
"genesis_prev": "0000000000000000000000000000000000000000000000000000000000000000",
"hash_field": {
"log": "h",
"outcomes": "hc"
}
},
"files": [
{
"file": "log-2026-11.jsonl",
"kind": "log",
"lines": 340,
"pre_chain_lines": 300,
"chain_start_line": 301,
"chained_rows": 40,
"head": "9b1d5e7c0a3f4c82b6d9e1f07a52c8d3e4b6a1f90c27d85e3a4b7c6d1e0f2a35",
"head_line": 340,
"head_at": "2026-11-12T09:30:00Z",
"genesis": {
"hash": "9b1d5e7c0a3f4c82b6d9e1f07a52c8d3e4b6a1f90c27d85e3a4b7c6d1e0f2a35",
"at": "2026-11-12T07:00:00Z"
},
"verified": true,
"first_error": null,
"days": [
{
"date": "2026-11-12",
"rows": 40,
"head": "9b1d5e7c0a3f4c82b6d9e1f07a52c8d3e4b6a1f90c27d85e3a4b7c6d1e0f2a35",
"line": 340
}
]
}
]
}GET/api/v1/evidence/{evidence_id}记录中的一条依据,以单个对象呈现:来源、版本、结果和完整性证明
| 名称 | 允许的值 | 默认 | 说明 |
|---|---|---|---|
evidence_id | string | 必填 | 依据标识:Pulse 卡片的 12 位标识,可由 /api/v1/evidence 列出 |
as_of | YYYY-MM-DDTHH:MM:SSZ | – | 此时刻的状态(ISO 8601,UTC,例如 2026-11-10T07:30:00Z) |
示例
{
"evidence_id": "3f9a1c0d2b7e",
"class": "S",
"status": "active",
"grade": "strong",
"as_of": "2026-11-12T09:30:00Z",
"recorded_at": "2026-11-10T14:05:12Z",
"corrected_at": null,
"card": {
"symbol": "NVDA",
"name": "Nvidia",
"kind": "stock",
"sector": "Information Technology",
"move_pct": 8.42,
"x_usual": 3.4,
"bucket": "own",
"date": "2026-11-10",
"class": "S"
},
"causes": [
{
"type": "earnings",
"grade": "strong",
"class": "F",
"title": "Earnings after market close the previous day",
"src_ts": "2026-11-09T21:05:00Z",
"ingest_ts": "2026-11-10T14:05:12Z",
"origin_class": "official"
}
],
"origin_class": "derived",
"rule_version": "pulse-r494",
"outcome": {
"t1": {
"state": "recorded",
"return_pct": 0.9,
"continued": true,
"reversed": false,
"method_version": "t15-v1",
"recorded_at": "2026-11-12T08:00:03Z",
"class": "S",
"proof": {
"file": "outcomes-2026-11.jsonl",
"line": 12,
"hash": "9b1d5e7c0a3f4c82b6d9e1f07a52c8d3e4b6a1f90c27d85e3a4b7c6d1e0f2a35",
"prev": "5c0e8a1d7b3f49266d0c1e8a7f3b2d94a6e5c1b08f7d3a2e94b6c0d1e8f7a3b2",
"pre_chain": false,
"verified": true,
"day_head": {
"date": "2026-11-10",
"hash": "9b1d5e7c0a3f4c82b6d9e1f07a52c8d3e4b6a1f90c27d85e3a4b7c6d1e0f2a35",
"line": 340,
"rows": 40
}
}
},
"t5": {
"state": "pending",
"return_pct": null,
"continued": null,
"reversed": null,
"method_version": "t15-v1",
"recorded_at": null,
"class": "S",
"proof": null
}
},
"lineage": {
"current_version_id": "3f9a1c0d2b7e",
"versions": [
{
"version_id": "3f9a1c0d2b7e",
"kind": "original",
"supersedes": null,
"reason": null,
"at": "2026-11-10T14:05:12Z",
"removed": false,
"redacted": false,
"current": true,
"summary": {
"move_pct": 8.42,
"x_usual": 3.4,
"bucket": "own",
"cause_types": [
"earnings"
]
},
"proof": {
"file": "log-2026-11.jsonl",
"line": 304,
"hash": "9b1d5e7c0a3f4c82b6d9e1f07a52c8d3e4b6a1f90c27d85e3a4b7c6d1e0f2a35",
"prev": "5c0e8a1d7b3f49266d0c1e8a7f3b2d94a6e5c1b08f7d3a2e94b6c0d1e8f7a3b2",
"pre_chain": false,
"verified": true,
"day_head": {
"date": "2026-11-10",
"hash": "9b1d5e7c0a3f4c82b6d9e1f07a52c8d3e4b6a1f90c27d85e3a4b7c6d1e0f2a35",
"line": 340,
"rows": 40
}
}
}
]
},
"integrity": {
"file": "log-2026-11.jsonl",
"line": 304,
"hash": "9b1d5e7c0a3f4c82b6d9e1f07a52c8d3e4b6a1f90c27d85e3a4b7c6d1e0f2a35",
"prev": "5c0e8a1d7b3f49266d0c1e8a7f3b2d94a6e5c1b08f7d3a2e94b6c0d1e8f7a3b2",
"pre_chain": false,
"verified": true,
"day_head": {
"date": "2026-11-10",
"hash": "9b1d5e7c0a3f4c82b6d9e1f07a52c8d3e4b6a1f90c27d85e3a4b7c6d1e0f2a35",
"line": 340,
"rows": 40
},
"chain": "cunex-pulse-chain-1",
"algorithm": "sha256",
"canonical": "json, keys sorted, no spaces, UTF-8, no ASCII escapes",
"hash_field": "h",
"recomputable_from_api": false,
"not_served": [
"causes[].ref",
"causes[].title",
"causes[].url",
"peers",
"resid",
"resid_xu",
"rule_version",
"sec"
]
},
"links": {
"self": "/api/v1/evidence/3f9a1c0d2b7e",
"archive": "/pulse/archiv/NVDA/2026-11-10",
"head": "/api/v1/pulse/head?month=2026-11"
}
}GET/api/v1/evidence依据标识列表,含简要字段和链接
| 名称 | 允许的值 | 默认 | 说明 |
|---|---|---|---|
symbol | string | – | 仅此代码,例如 NVDA |
date | YYYY-MM-DD | – | 仅此日期(YYYY-MM-DD) |
cursor | string | – | 来自 meta.next 的后续令牌 |
limit | 1–100 | 25 | 每页条数(1 到 100) |
示例
[
{
"evidence_id": "3f9a1c0d2b7e",
"symbol": "NVDA",
"name": "Nvidia",
"kind": "stock",
"date": "2026-11-10",
"move_pct": 8.42,
"x_usual": 3.4,
"bucket": "own",
"grade": "strong",
"corrected": false,
"class": "S",
"link": "/api/v1/evidence/3f9a1c0d2b7e"
}
]GET/api/v1/graph/{symbol}某个标的的已记录关联;相关性以百分比表示
| 名称 | 允许的值 | 默认 | 说明 |
|---|---|---|---|
symbol | string | 必填 | 代码,例如 NVDA 或 ^GSPC |
示例
{
"symbol": "NVDA",
"name": "Nvidia",
"kind": "stock",
"sector": "Information Technology",
"as_of": "2026-11-10T02:00:00Z",
"edges": [
{
"type": "comove",
"symbol": "AMD",
"event_type": null,
"name": "AMD",
"strength": 0.78,
"correlation_pct": 78.0,
"n": 250,
"last": "2026-11-10",
"evidence": [
{
"kind": "corr_12m",
"date": "2026-11-10",
"label": null,
"grade": null,
"value": 78.0,
"unit": "pct",
"n": 250,
"low": null,
"high": null,
"class": "S"
}
],
"class": "S"
}
],
"notes": [],
"thresholds": {
"min_abs_correlation_pct": 50,
"min_common_days": 120,
"min_cases": 8
}
}GET/api/v1/scenario央行与通胀日期前后的历史分布
| 名称 | 允许的值 | 默认 | 说明 |
|---|---|---|---|
event | cpi | fomc | ecb | – | 仅此事件类型 |
示例
[
{
"event": "cpi",
"name": "US consumer prices (CPI)",
"source": "U.S. Bureau of Labor Statistics",
"n_events": 40,
"first": "2016-01-13",
"last": "2026-10-14",
"assets": [
{
"key": "spx",
"name": "S&P 500",
"unit": "pct",
"reaction": {
"0": {
"n": 38,
"median": -0.12,
"p25": -0.8,
"p75": 0.6,
"share_positive_pct": 45.0,
"class": "S"
}
},
"market_adjusted": null
}
]
}
]GET/api/v1/calendar未来几天的官方日期
| 名称 | 允许的值 | 默认 | 说明 |
|---|---|---|---|
days | 1–14 | 7 | 从今天起的天数(1 到 14) |
示例
[
{
"date": "2026-11-12",
"event": "Fed rate decision",
"kind": "central_bank",
"class": "F"
}
]GET/api/v1/briefing当前简报的事实数据
示例
{
"edition": {
"id": "2026-11-10-morning",
"kind": "morning",
"date": "2026-11-10"
},
"as_of": "2026-11-10T07:30:00Z",
"index_moves": [
{
"symbol": "^GSPC",
"name": "S&P 500",
"move_pct": -0.84,
"class": "S"
}
],
"counts": {
"unusual_moves": 9,
"with_documented_cause": 6,
"class": "S"
},
"moves": [
{
"id": "3f9a1c0d2b7e",
"symbol": "NVDA",
"name": "Nvidia",
"kind": "stock",
"sector": "Information Technology",
"move_pct": 8.42,
"x_usual": 3.4,
"bucket": "own",
"causes": [
{
"type": "earnings",
"grade": "strong",
"title": "Earnings after market close the previous day",
"ts": "2026-11-09T21:05:00Z",
"class": "F"
}
],
"date": "2026-11-10",
"class": "S"
}
],
"upcoming": [
{
"date": "2026-11-12",
"event": "Fed rate decision",
"kind": "central_bank",
"class": "F"
}
],
"track": null
}GET/api/v1/topics词汇表:主题、原因类型、资产类别
示例
{
"topics": [
{
"id": "c:aktien",
"group": "c",
"name": "Stocks"
}
],
"groups": [
{
"id": "c",
"name": "Asset class"
}
],
"cause_types": [
{
"id": "macro",
"label": "Economic release",
"title_included": true
}
],
"asset_kinds": [
"stock",
"crypto",
"index",
"etf",
"commodity",
"fx",
"rate",
"other"
],
"buckets": [
"own",
"sector",
"market"
],
"grades": [
"strong",
"weak"
],
"event_types": [
{
"id": "cpi",
"name": "US consumer prices (CPI)",
"source": "U.S. Bureau of Labor Statistics"
}
]
}GET/api/v1/status数据状态
示例
{
"status": "ok",
"version": "1.1.0",
"components": {
"pulse": {
"ready": true,
"age_s": 95,
"cards": 12
}
},
"keys_enabled": false,
"sources": {
"monitor": "ok",
"updated_age_s": 40,
"worst": "ok",
"items": [
{
"class": "official",
"topic": "company_filings",
"state": "ok",
"age_s": 600,
"coverage": 25
}
]
}
}GET/api/v1/openapi.json本接口的 OpenAPI 3.1 描述
响应格式
{ data, meta }每个响应都由 data 和 meta 组成。meta 包含版本、时间、许可和署名义务。
{ error: { code, message } }错误以包含 code 和 message 的 error 形式返回,并带有相应的 HTTP 状态:400、401、404、405、429 或 503。
cursor limit meta.next列表按页返回。后续游标在 meta.next 中,最后一页没有该字段。
ETag If-None-Match每个响应都带有 ETag 和 Cache-Control。携带 If-None-Match 时,数据未变化则返回 304。
Access-Control-Allow-Origin: *数据路径会为 GET 返回 CORS 响应头,网页应用可直接在浏览器中调用。
X-RateLimit-Limit X-RateLimit-Remaining X-RateLimit-Reset这些响应头显示上限、剩余次数以及距本分钟结束的秒数。
move_pct x_usual只提供百分比:没有价格,也没有价格序列。新闻、预测市场和国会申报的标题不会返回,只给出类型。
响应示例
{
"data": [
{
"id": "3f9a1c0d2b7e",
"symbol": "NVDA",
"name": "Nvidia",
"kind": "stock",
"sector": "Information Technology",
"move_pct": 8.42,
"x_usual": 3.4,
"bucket": "own",
"causes": [
{
"type": "earnings",
"grade": "strong",
"title": "Earnings after market close the previous day",
"ts": "2026-11-09T21:05:00Z",
"class": "F"
}
],
"date": "2026-11-10",
"class": "S"
}
],
"meta": {
"version": "1.1.0",
"generated_at": "2026-11-10T09:20:00Z",
"licence": "CUNEX-API-FREE-1",
"attribution_required": true,
"attribution": {
"text": "Daten: CUNEX",
"url": "https://cunex.app"
},
"notice": "Historical or documented data, not a forecast and not investment advice.",
"count": 1,
"as_of": "2026-11-10T07:30:00Z"
}
}错误示例
{
"error": {
"code": "invalid_parameter",
"message": "Parameter 'limit' must be between 1 and 100."
}
}嵌入与订阅源
可直接用于网站的现成组件:经济日历、带官方原因的 Pulse 和情景卡片。
以订阅源获取 Pulse 卡片
以订阅源获取 Pulse 每日汇总
以订阅源获取简报
本接口的 OpenAPI 3.1 描述
条款
- 署名要求:展示或转发数据时,须以醒目方式标注“数据:CUNEX”,并链接到 https://cunex.app。
- 禁止转售访问权限:免费层不得作为自有数据服务转接、镜像或缓存后出售。
- 仅限自有数据和官方数据:接口不提供价格、价格序列或第三方新闻标题。
- 限制:无密钥时,每个地址每分钟最多 60 次请求。超出后接口返回 429,并在 Retry-After 中给出等待时间。
- 不保证可用性,也不保证准确性与完整性。
- 所有内容仅为信息,不构成投资建议,也不是预测。
- 接口不设置 Cookie,也不记录请求日志;限流计数仅短暂保存在内存中。
版本
- 版本号在路径中。v1 内只会新增字段和接口,现有字段的含义保持不变。
- 客户端应忽略未知字段。被移除或更改的内容将以 v2 发布;v1 此后至少再运行六个月。
变更记录
新增:记录哈希链的链头、每条依据的类别字段(F 或 S),以及支持按过去时点查询的依据接口。
首个版本:Pulse、归档、战绩、关联、情景、日历、简报、词汇表和状态。
筹备中
按账户发放、带独立配额的 API 密钥,以及限额更高的付费层。不承诺具体时间;无密钥时一切照常可用。