Buscar⌘K

Desarrolladores

API abierta para Pulse, el archivo, las conexiones y las fechas oficiales: sin clave y con atribución.
API v11.1.0OpenAPI 3,1

Inicio rápido

No hace falta clave ni inicio de sesión. La respuesta es JSON en un sobre fijo.

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"

Pruébalo

Estado–Duración–Restantes–
Respuesta

Endpoints

Solo lectura, solo GET
GET/api/v1Índice de endpoints disponibles
Ejemplo
{
 "endpoints": [
 {
 "path": "/api/v1/pulse",
 "summary": "Current unusual moves with documented triggers"
 }
 ],
 "openapi": "/api/v1/openapi.json",
 "docs": "/developers"
}
GET/api/v1/pulseMovimientos inusuales actuales con causas documentadas
NombreValores permitidosPredeterminadoDescripción
kindstock | crypto | index | etf | commodity | fx | rate–Solo esta clase de activos
limit1–10050Elementos por página (1 a 100)
Ejemplo
[
 {
 "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 de movimientos pasados con resultado tras 1 y 5 días de negociación
NombreValores permitidosPredeterminadoDescripción
dateYYYY-MM-DD–Solo este día (AAAA-MM-DD)
symbolstring–Solo este símbolo, p. ej. NVDA
cursorstring–Token de continuación de meta.next
limit1–10025Elementos por página (1 a 100)
Ejemplo
[
 {
 "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/qualityBalance del registro: proporción de continuaciones tras 1 y 5 días de negociación
Ejemplo
{
 "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/headCabezas de cadena del registro: último hash por archivo y día, para comprobar que nada se ha modificado
NombreValores permitidosPredeterminadoDescripción
monthstring–Solo este mes (AAAA-MM), con valores diarios
Ejemplo
{
 "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}Una prueba del registro como un único objeto: fuentes, versiones, resultado y prueba de integridad
NombreValores permitidosPredeterminadoDescripción
evidence_idstringObligatorioID de la prueba: el identificador de 12 caracteres de una tarjeta de Pulse, tal como lo lista /api/v1/evidence
as_ofYYYY-MM-DDTHH:MM:SSZ–Estado en este momento (ISO 8601, UTC, p. ej. 2026-11-10T07:30:00Z)
Ejemplo
{
 "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/evidenceLista de identificadores de pruebas con campos breves y enlaces
NombreValores permitidosPredeterminadoDescripción
symbolstring–Solo este símbolo, p. ej. NVDA
dateYYYY-MM-DD–Solo este día (AAAA-MM-DD)
cursorstring–Token de continuación de meta.next
limit1–10025Elementos por página (1 a 100)
Ejemplo
[
 {
 "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}Conexiones documentadas de un valor; correlaciones en porcentaje
NombreValores permitidosPredeterminadoDescripción
symbolstringObligatorioSímbolo, p. ej. NVDA o ^GSPC
Ejemplo
{
 "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/scenarioDistribuciones históricas en torno a las fechas de bancos centrales e inflación
NombreValores permitidosPredeterminadoDescripción
eventcpi | fomc | ecb–Solo este tipo de evento
Ejemplo
[
 {
 "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/calendarFechas oficiales de los próximos días
NombreValores permitidosPredeterminadoDescripción
days1–147Número de días desde hoy (1 a 14)
Ejemplo
[
 {
 "date": "2026-11-12",
 "event": "Fed rate decision",
 "kind": "central_bank",
 "class": "F"
 }
]
GET/api/v1/briefingDatos de la edición actual del resumen
Ejemplo
{
 "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/topicsVocabulario: temas, tipos de causa, clases de activos
Ejemplo
{
 "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/statusEstado de los datos
Ejemplo
{
 "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.jsonDescripción OpenAPI 3,1 de esta API

Formato de respuesta

{ data, meta }

Cada respuesta tiene la forma data y meta. En meta figuran la versión, la hora, la licencia y la obligación de atribución.

{ error: { code, message } }

Los errores tienen la forma error con code y message y un estado HTTP adecuado: 400, 401, 404, 405, 429 o 503.

cursor limit meta.next

Las listas se entregan por páginas. La continuación está en meta.next y falta en la última página.

ETag If-None-Match

Cada respuesta incluye ETag y Cache-Control. Con If-None-Match la API responde 304 si los datos no han cambiado.

Access-Control-Allow-Origin: *

Las rutas de datos envían cabeceras CORS para GET; las aplicaciones web pueden llamarlas directamente desde el navegador.

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

Estas cabeceras muestran el límite, lo que queda y los segundos hasta que termina el minuto.

move_pct x_usual

Solo hay porcentajes: ni precios ni series de precios. Los títulos de noticias, mercados de predicción y avisos del Congreso no se devuelven; solo se indica el tipo.

Ejemplo de respuesta
{
 "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"
 }
}
Ejemplo de error
{
 "error": {
 "code": "invalid_parameter",
 "message": "Parameter 'limit' must be between 1 and 100."
 }
}

Incrustaciones y feeds

Bloques listos para sitios web: calendario económico, Pulse con causas oficiales y tarjeta de escenario.

Tarjetas de Pulse como feed

Resumen diario de Pulse como feed

Resumen como feed

Descripción OpenAPI 3,1 de esta API

Condiciones

  • Atribución: quien muestre o transmita los datos debe indicar de forma visible «Datos: CUNEX» con un enlace a https://cunex.app.
  • Sin reventa del acceso: el nivel gratuito no puede transmitirse, replicarse ni venderse en caché como un servicio de datos propio.
  • Solo datos propios y oficiales: la API no ofrece precios, series de precios ni titulares de terceros.
  • Límite: hasta 60 solicitudes por minuto y dirección sin clave. Por encima, la API responde 429 con el tiempo de espera en Retry-After.
  • Sin garantía de disponibilidad ni de exactitud o integridad.
  • Todo el contenido es información, no asesoramiento de inversión ni una previsión.
  • La API no usa cookies ni registra las solicitudes; los contadores del límite solo existen brevemente en memoria.

Condiciones de uso

Versiones

  • La versión va en la ruta. Dentro de v1 solo se añaden campos y endpoints nuevos; los campos existentes conservan su significado.
  • Los clientes ignoran los campos desconocidos. Lo que se elimine o cambie aparecerá como v2; v1 seguirá funcionando al menos seis meses.

Cambios

1.1.0

Novedades: cabezas de cadena del registro, el campo de clase (F o S) en cada prueba y los endpoints de pruebas con consultas a una fecha anterior.

1.0.0

Primera versión: pulso, archivo, balance, conexiones, escenarios, calendario, resumen, vocabulario y estado.

En preparación

Claves de API por cuenta con cuota propia y niveles de pago con límites mayores. No se promete fecha; todo sigue funcionando sin clave.