빠른 시작
키도 로그인도 필요 없습니다. 응답은 고정된 봉투 형식의 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"])사용해 보기
지금은 API에 연결할 수 없습니다.
응답엔드포인트 목록
읽기 전용, 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근거가 있는 요인과 함께 보는 현재의 이례적 움직임
| 이름 | 허용 값 | 기본값 | 설명 |
|---|---|---|---|
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/archive1거래일 및 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 | 필수 | 근거 ID: Pulse 카드의 12자리 ID로, /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근거 ID 목록(간단한 필드와 링크 포함)
| 이름 | 허용 값 | 기본값 | 설명 |
|---|---|---|---|
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이 API의 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이 헤더는 한도, 남은 횟수, 그리고 해당 1분이 끝날 때까지의 초를 보여 줍니다.
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 일일 요약을 피드로
브리핑을 피드로
이 API의 OpenAPI 3.1 명세
이용 조건
- 출처 표시: 데이터를 보여 주거나 전달하는 경우 ‘데이터: CUNEX’를 눈에 띄게 표시하고 https://cunex.app 링크를 달아야 합니다.
- 접근 재판매 금지: 무료 등급을 자체 데이터 서비스로 전달·미러링하거나 캐시해 판매할 수 없습니다.
- 자체 데이터와 공식 데이터만 제공: API는 가격, 가격 추이, 외부 뉴스 제목을 제공하지 않습니다.
- 한도: 키 없이 주소당 분당 최대 60회 요청. 초과하면 429로 응답하며 대기 시간은 Retry-After에 표시됩니다.
- 가용성에 대한 보장이 없으며 정확성과 완전성에 대한 보증도 하지 않습니다.
- 모든 내용은 정보일 뿐 투자 조언이나 예측이 아닙니다.
- API는 쿠키를 설정하지 않고 요청 기록도 남기지 않습니다. 한도 카운터는 메모리에 잠시만 존재합니다.
버전
- 버전은 경로에 들어 있습니다. v1 안에서는 새 필드와 새 엔드포인트만 추가되며 기존 필드의 의미는 유지됩니다.
- 클라이언트는 알 수 없는 필드를 무시해야 합니다. 삭제되거나 바뀌는 내용은 v2로 나오며 v1은 그 뒤로 최소 6개월 동안 계속 운영됩니다.
변경 내역
추가됨: 기록 체인의 헤드, 모든 근거의 분류 필드(F 또는 S), 과거 시점을 조회할 수 있는 근거 엔드포인트.
첫 릴리스: Pulse, 아카이브, 성과, 연결, 시나리오, 캘린더, 브리핑, 용어집, 상태.
준비 중
계정별 API 키(자체 할당량 포함)와 한도가 더 높은 유료 등급을 준비 중입니다. 일정은 약속하지 않으며 키 없이도 모두 계속 작동합니다.