搜索⌘K

开发者

面向 Pulse、归档、关联和官方日期的开放接口——无需密钥,需注明来源。
API v11.1.0OpenAPI 3.1

快速开始

无需密钥或登录。响应是固定外层结构的 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"

在线试用

状态–耗时–剩余–
响应

接口列表

只读,仅 GET
GET/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带有记录在案原因的当前异常波动
名称允许的值默认说明
kindstock | crypto | index | etf | commodity | fx | rate–仅此资产类别
limit1–10050每页条数(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 个交易日后的结果
名称允许的值默认说明
dateYYYY-MM-DD–仅此日期(YYYY-MM-DD)
symbolstring–仅此代码,例如 NVDA
cursorstring–来自 meta.next 的后续令牌
limit1–10025每页条数(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记录哈希链的链头:每个文件、每天的最新哈希,用于核对内容未被改动
名称允许的值默认说明
monthstring–仅此月份(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_idstring必填依据标识:Pulse 卡片的 12 位标识,可由 /api/v1/evidence 列出
as_ofYYYY-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依据标识列表,含简要字段和链接
名称允许的值默认说明
symbolstring–仅此代码,例如 NVDA
dateYYYY-MM-DD–仅此日期(YYYY-MM-DD)
cursorstring–来自 meta.next 的后续令牌
limit1–10025每页条数(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}某个标的的已记录关联;相关性以百分比表示
名称允许的值默认说明
symbolstring必填代码,例如 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央行与通胀日期前后的历史分布
名称允许的值默认说明
eventcpi | 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未来几天的官方日期
名称允许的值默认说明
days1–147从今天起的天数(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 此后至少再运行六个月。

变更记录

1.1.0

新增:记录哈希链的链头、每条依据的类别字段(F 或 S),以及支持按过去时点查询的依据接口。

1.0.0

首个版本:Pulse、归档、战绩、关联、情景、日历、简报、词汇表和状态。

筹备中

按账户发放、带独立配额的 API 密钥,以及限额更高的付费层。不承诺具体时间;无密钥时一切照常可用。