Cerca⌘K

Sviluppatori

API aperta per Pulse, l'archivio, i collegamenti e le date ufficiali: senza chiave, con citazione della fonte.
API v11.1.0OpenAPI 3,1

Avvio rapido

Non servono chiave né accesso. La risposta è JSON in un involucro fisso.

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"

Provalo

Stato–Durata–Rimanenti–
Risposta

Endpoint

Sola lettura, solo GET
GET/api/v1Indice degli endpoint disponibili
Esempio
{
 "endpoints": [
 {
 "path": "/api/v1/pulse",
 "summary": "Current unusual moves with documented triggers"
 }
 ],
 "openapi": "/api/v1/openapi.json",
 "docs": "/developers"
}
GET/api/v1/pulseMovimenti insoliti attuali con cause documentate
NomeValori consentitiPredefinitoDescrizione
kindstock | crypto | index | etf | commodity | fx | rate–Solo questa classe di attività
limit1–10050Elementi per pagina (da 1 a 100)
Esempio
[
 {
 "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/archiveRegistro dei movimenti passati con esito dopo 1 e 5 giorni di borsa
NomeValori consentitiPredefinitoDescrizione
dateYYYY-MM-DD–Solo questo giorno (AAAA-MM-GG)
symbolstring–Solo questo simbolo, ad es. NVDA
cursorstring–Token di continuazione da meta.next
limit1–10025Elementi per pagina (da 1 a 100)
Esempio
[
 {
 "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/qualityBilancio del registro: quota di prosecuzioni dopo 1 e 5 giorni di borsa
Esempio
{
 "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/headTeste di catena del registro: ultimo hash per file e giorno, per verificare che nulla sia stato modificato
NomeValori consentitiPredefinitoDescrizione
monthstring–Solo questo mese (AAAA-MM), con i valori giornalieri
Esempio
{
 "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}Un'evidenza del registro come un unico oggetto: fonti, versioni, esito e prova di integrità
NomeValori consentitiPredefinitoDescrizione
evidence_idstringObbligatorioID dell'evidenza: l'identificatore di 12 caratteri di una scheda Pulse, come elencato da /api/v1/evidence
as_ofYYYY-MM-DDTHH:MM:SSZ–Stato a questo momento (ISO 8601, UTC, ad es. 2026-11-10T07:30:00Z)
Esempio
{
 "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/evidenceElenco degli identificatori delle evidenze con campi brevi e collegamenti
NomeValori consentitiPredefinitoDescrizione
symbolstring–Solo questo simbolo, ad es. NVDA
dateYYYY-MM-DD–Solo questo giorno (AAAA-MM-GG)
cursorstring–Token di continuazione da meta.next
limit1–10025Elementi per pagina (da 1 a 100)
Esempio
[
 {
 "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}Collegamenti documentati di un titolo; correlazioni in percentuale
NomeValori consentitiPredefinitoDescrizione
symbolstringObbligatorioSimbolo, ad es. NVDA o ^GSPC
Esempio
{
 "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/scenarioDistribuzioni storiche attorno alle date delle banche centrali e dell'inflazione
NomeValori consentitiPredefinitoDescrizione
eventcpi | fomc | ecb–Solo questo tipo di evento
Esempio
[
 {
 "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/calendarDate ufficiali dei prossimi giorni
NomeValori consentitiPredefinitoDescrizione
days1–147Numero di giorni da oggi (da 1 a 14)
Esempio
[
 {
 "date": "2026-11-12",
 "event": "Fed rate decision",
 "kind": "central_bank",
 "class": "F"
 }
]
GET/api/v1/briefingFatti dell'edizione attuale del briefing
Esempio
{
 "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/topicsVocabolario: temi, tipi di causa, classi di attività
Esempio
{
 "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/statusStato dei dati
Esempio
{
 "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.jsonDescrizione OpenAPI 3,1 di questa API

Formato della risposta

{ data, meta }

Ogni risposta ha la forma data e meta. In meta ci sono versione, ora, licenza e l'obbligo di citare la fonte.

{ error: { code, message } }

Gli errori hanno la forma error con code e message e uno stato HTTP adeguato: 400, 401, 404, 405, 429 o 503.

cursor limit meta.next

Gli elenchi arrivano a pagine. Il seguito è in meta.next e manca nell'ultima pagina.

ETag If-None-Match

Ogni risposta include ETag e Cache-Control. Con If-None-Match l'API risponde 304 se i dati non sono cambiati.

Access-Control-Allow-Origin: *

I percorsi dei dati inviano intestazioni CORS per GET; le app web possono richiamarli direttamente dal browser.

X-RateLimit-Limit X-RateLimit-Remaining X-RateLimit-Reset

Queste intestazioni mostrano il limite, il resto e i secondi che mancano alla fine del minuto.

move_pct x_usual

Ci sono solo percentuali: niente prezzi né serie di prezzi. I titoli di notizie, mercati predittivi e dichiarazioni del Congresso non vengono restituiti; compare solo il tipo.

Esempio di risposta
{
 "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"
 }
}
Esempio di errore
{
 "error": {
 "code": "invalid_parameter",
 "message": "Parameter 'limit' must be between 1 and 100."
 }
}

Incorporamenti e feed

Blocchi pronti per i siti web: calendario economico, Pulse con cause ufficiali e scheda scenario.

Schede Pulse come feed

Riepilogo giornaliero di Pulse come feed

Briefing come feed

Descrizione OpenAPI 3,1 di questa API

Condizioni

  • Citazione della fonte: chi mostra o inoltra i dati indica in modo visibile «Dati: CUNEX» con un link a https://cunex.app.
  • Nessuna rivendita dell'accesso: il livello gratuito non può essere inoltrato, replicato o venduto in cache come servizio dati proprio.
  • Solo dati propri e ufficiali: l'API non fornisce prezzi, serie di prezzi né titoli di notizie di terzi.
  • Limite: fino a 60 richieste al minuto per indirizzo senza chiave. Oltre, l'API risponde 429 con il tempo di attesa in Retry-After.
  • Nessuna garanzia di disponibilità, né di correttezza o completezza.
  • Tutti i contenuti sono informazioni, non consulenza finanziaria né previsioni.
  • L'API non imposta cookie e non registra le richieste; i contatori del limite esistono solo brevemente in memoria.

Condizioni d'uso

Versioni

  • La versione è nel percorso. Dentro v1 si aggiungono solo nuovi campi e nuovi endpoint; i campi esistenti mantengono il loro significato.
  • I client ignorano i campi sconosciuti. Ciò che viene rimosso o modificato compare in v2; v1 resta attiva per almeno sei mesi.

Modifiche

1.1.0

Novità: teste di catena del registro, campo classe (F o S) su ogni evidenza ed endpoint delle evidenze con interrogazioni a una data passata.

1.0.0

Prima versione: pulse, archivio, bilancio, collegamenti, scenari, calendario, briefing, vocabolario e stato.

In preparazione

Chiavi API per account con quota propria e livelli a pagamento con limiti più alti. Nessuna data è promessa; tutto continua a funzionare senza chiave.