Desarrolladores
API abierta para Pulse, el archivo, las conexiones y las fechas oficiales: sin clave y con atribución.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"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"])Pruébalo
La API no está disponible en este momento.
RespuestaEndpoints
Solo lectura, solo GETGET/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
| Nombre | Valores permitidos | Predeterminado | Descripción |
|---|---|---|---|
kind | stock | crypto | index | etf | commodity | fx | rate | – | Solo esta clase de activos |
limit | 1–100 | 50 | Elementos 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
| Nombre | Valores permitidos | Predeterminado | Descripción |
|---|---|---|---|
date | YYYY-MM-DD | – | Solo este día (AAAA-MM-DD) |
symbol | string | – | Solo este símbolo, p. ej. NVDA |
cursor | string | – | Token de continuación de meta.next |
limit | 1–100 | 25 | Elementos 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
| Nombre | Valores permitidos | Predeterminado | Descripción |
|---|---|---|---|
month | string | – | 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
| Nombre | Valores permitidos | Predeterminado | Descripción |
|---|---|---|---|
evidence_id | string | Obligatorio | ID de la prueba: el identificador de 12 caracteres de una tarjeta de Pulse, tal como lo lista /api/v1/evidence |
as_of | YYYY-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
| Nombre | Valores permitidos | Predeterminado | Descripción |
|---|---|---|---|
symbol | string | – | Solo este símbolo, p. ej. NVDA |
date | YYYY-MM-DD | – | Solo este día (AAAA-MM-DD) |
cursor | string | – | Token de continuación de meta.next |
limit | 1–100 | 25 | Elementos 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
| Nombre | Valores permitidos | Predeterminado | Descripción |
|---|---|---|---|
symbol | string | Obligatorio | Sí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
| Nombre | Valores permitidos | Predeterminado | Descripción |
|---|---|---|---|
event | cpi | 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
| Nombre | Valores permitidos | Predeterminado | Descripción |
|---|---|---|---|
days | 1–14 | 7 | Nú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.nextLas listas se entregan por páginas. La continuación está en meta.next y falta en la última página.
ETag If-None-MatchCada 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-ResetEstas cabeceras muestran el límite, lo que queda y los segundos hasta que termina el minuto.
move_pct x_usualSolo 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.
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
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.
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.