クイックスタート
キーもログインも不要です。応答は固定の封筒形式の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ページあたりの件数(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ページあたりの件数(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}記録の根拠1件を1つのオブジェクトで:情報源、バージョン、結果、完全性の証明
| 銘柄名 | 指定可能な値 | デフォルト | 説明 |
|---|---|---|---|
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ページあたりの件数(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は価格、価格推移、第三者のニュース見出しを提供しません。
- 上限:キーなしの場合、1アドレスにつき1分あたり最大60リクエスト。超えると429を返し、待ち時間を Retry-After に示します。
- 提供状況の保証はなく、正確性・完全性についても保証しません。
- すべての内容は情報であり、投資助言でも予測でもありません。
- APIはCookieを設定せず、リクエストの記録も残しません。上限のカウンターはメモリ上に短時間あるだけです。
バージョン
- バージョンはパスに含まれます。v1の中では新しいフィールドとエンドポイントが追加されるだけで、既存フィールドの意味は変わりません。
- クライアントは未知のフィールドを無視してください。削除や変更はv2として提供され、v1はその後も少なくとも6か月続きます。
変更履歴
追加:記録のチェーン先頭値、各根拠のクラス項目(FまたはS)、過去の時点を指定できる根拠エンドポイント。
初回リリース:Pulse、アーカイブ、実績、つながり、シナリオ、カレンダー、ブリーフィング、用語集、ステータス。
準備中
アカウントごとのAPIキー(専用の利用枠付き)と、上限の高い有料プランを準備中です。時期は約束していません。キーなしでもこれまでどおり使えます。