المطورون
واجهة مفتوحة لـ Pulse والأرشيف والروابط والمواعيد الرسمية – بلا مفتاح ومع ذكر المصدر.بداية سريعة
لا حاجة إلى مفتاح أو تسجيل دخول. الاستجابة بصيغة 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"])جرّب الآن
واجهة البرمجة غير متاحة حاليًا.
الاستجابةنقاط النهاية
للقراءة فقط، 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/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 | إلزامي | معرّف الدليل: المعرّف المكوّن من 12 حرفًا لبطاقة Pulse، كما يسرده /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 } }تأتي الأخطاء بالشكل error مع code وmessage وحالة 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: *ترسل مسارات البيانات ترويسات CORS لطلبات GET، ويمكن لتطبيقات الويب استدعاؤها مباشرة من المتصفح.
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.
- لا ضمان للتوفر ولا ضمان للدقة أو الاكتمال.
- كل المحتوى معلومات وليس نصيحة استثمارية ولا توقعًا.
- لا تضع الواجهة ملفات تعريف ارتباط ولا تحتفظ بسجل للطلبات؛ وعدّادات الحد موجودة مؤقتًا في الذاكرة فقط.
الإصدارات
- الإصدار موجود في المسار. داخل v1 تُضاف حقول ونقاط نهاية جديدة فقط، وتحتفظ الحقول الحالية بمعناها.
- تتجاهل التطبيقات الحقول غير المعروفة. ما يُحذف أو يتغير يظهر في v2، وتستمر v1 بعد ذلك ستة أشهر على الأقل.
التغييرات
إضافات: رؤوس سلسلة السجل، وحقل الفئة (F أو S) في كل دليل، ونقاط نهاية الأدلة مع الاستعلام عن حالة في وقت سابق.
الإصدار الأول: Pulse والأرشيف والحصيلة والروابط والسيناريوهات والتقويم والموجز والمفردات والحالة.
قيد الإعداد
مفاتيح API لكل حساب بحصة خاصة ومستويات مدفوعة بحدود أعلى. لا يوجد موعد مؤكد؛ ويستمر كل شيء بالعمل بدون مفتاح.