Buscar⌘K

Desenvolvedores

API aberta para o Pulse, o arquivo, as conexões e as datas oficiais – sem chave, com atribuição.
API v11.1.0OpenAPI 3,1

Início rápido

Não é preciso chave nem login. A resposta é JSON em um envelope fixo.

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"

Experimente

Status–Duração–Restantes–
Resposta

Endpoints

Somente leitura, apenas GET
GET/api/v1Índice dos endpoints disponíveis
Exemplo
{
 "endpoints": [
 {
 "path": "/api/v1/pulse",
 "summary": "Current unusual moves with documented triggers"
 }
 ],
 "openapi": "/api/v1/openapi.json",
 "docs": "/developers"
}
GET/api/v1/pulseMovimentos incomuns atuais com causas documentadas
NomeValores permitidosPadrãoDescrição
kindstock | crypto | index | etf | commodity | fx | rate–Somente esta classe de ativos
limit1–10050Itens por página (1 a 100)
Exemplo
[
 {
 "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 dos movimentos passados com resultado após 1 e 5 dias úteis de negociação
NomeValores permitidosPadrãoDescrição
dateYYYY-MM-DD–Somente este dia (AAAA-MM-DD)
symbolstring–Somente este símbolo, p. ex. NVDA
cursorstring–Token de continuação de meta.next
limit1–10025Itens por página (1 a 100)
Exemplo
[
 {
 "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/qualityBalanço do registro: parcela de continuações após 1 e 5 dias úteis de negociação
Exemplo
{
 "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/headCabeças da cadeia do registro: último hash por arquivo e dia, para verificar que nada foi alterado
NomeValores permitidosPadrãoDescrição
monthstring–Somente este mês (AAAA-MM), com valores diários
Exemplo
{
 "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}Uma evidência do registro como um único objeto: fontes, versões, resultado e prova de integridade
NomeValores permitidosPadrãoDescrição
evidence_idstringObrigatórioID da evidência: o identificador de 12 caracteres de um cartão do Pulse, como listado por /api/v1/evidence
as_ofYYYY-MM-DDTHH:MM:SSZ–Estado neste momento (ISO 8601, UTC, p. ex. 2026-11-10T07:30:00Z)
Exemplo
{
 "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 evidências com campos curtos e links
NomeValores permitidosPadrãoDescrição
symbolstring–Somente este símbolo, p. ex. NVDA
dateYYYY-MM-DD–Somente este dia (AAAA-MM-DD)
cursorstring–Token de continuação de meta.next
limit1–10025Itens por página (1 a 100)
Exemplo
[
 {
 "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}Conexões documentadas de um ativo; correlações em percentual
NomeValores permitidosPadrãoDescrição
symbolstringObrigatórioSímbolo, p. ex. NVDA ou ^GSPC
Exemplo
{
 "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/scenarioDistribuições históricas em torno de datas de bancos centrais e inflação
NomeValores permitidosPadrãoDescrição
eventcpi | fomc | ecb–Somente este tipo de evento
Exemplo
[
 {
 "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/calendarDatas oficiais dos próximos dias
NomeValores permitidosPadrãoDescrição
days1–147Número de dias a partir de hoje (1 a 14)
Exemplo
[
 {
 "date": "2026-11-12",
 "event": "Fed rate decision",
 "kind": "central_bank",
 "class": "F"
 }
]
GET/api/v1/briefingFatos da edição atual do resumo
Exemplo
{
 "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/topicsVocabulário: temas, tipos de causa, classes de ativos
Exemplo
{
 "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 dos dados
Exemplo
{
 "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.jsonDescrição OpenAPI 3,1 desta API

Formato da resposta

{ data, meta }

Toda resposta tem a forma data e meta. Em meta ficam a versão, o horário, a licença e a obrigação de atribuição.

{ error: { code, message } }

Os erros têm a forma error com code e message e um status HTTP adequado: 400, 401, 404, 405, 429 ou 503.

cursor limit meta.next

As listas vêm em páginas. A continuação está em meta.next e falta na última página.

ETag If-None-Match

Cada resposta traz ETag e Cache-Control. Com If-None-Match a API responde 304 quando os dados não mudaram.

Access-Control-Allow-Origin: *

Os caminhos de dados enviam cabeçalhos CORS para GET; aplicações web podem chamá-los diretamente do navegador.

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

Estes cabeçalhos mostram o limite, o restante e os segundos até o fim do minuto.

move_pct x_usual

Há apenas percentuais: nada de preços nem séries de preços. Os títulos de notícias, mercados de previsão e comunicados do Congresso não são devolvidos; só o tipo é informado.

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

Incorporações e feeds

Blocos prontos para sites: calendário econômico, Pulse com causas oficiais e cartão de cenário.

Cartões do Pulse como feed

Resumo diário do Pulse como feed

Resumo como feed

Descrição OpenAPI 3,1 desta API

Condições

  • Atribuição: quem exibir ou repassar os dados deve citar de forma visível «Dados: CUNEX» com um link para https://cunex.app.
  • Sem revenda do acesso: o nível gratuito não pode ser repassado, espelhado nem vendido em cache como serviço de dados próprio.
  • Apenas dados próprios e oficiais: a API não fornece preços, séries de preços nem manchetes de terceiros.
  • Limite: até 60 requisições por minuto por endereço sem chave. Acima disso, a API responde 429 com o tempo de espera em Retry-After.
  • Sem garantia de disponibilidade nem de exatidão ou integridade.
  • Todo o conteúdo é informação, não aconselhamento de investimento nem previsão.
  • A API não define cookies nem registra as requisições; os contadores do limite existem apenas brevemente na memória.

Termos de uso

Versões

  • A versão está no caminho. Dentro de v1 só são adicionados novos campos e novos endpoints; os campos existentes mantêm seu significado.
  • Os clientes ignoram campos desconhecidos. O que for removido ou alterado aparece na v2; a v1 continua por pelo menos seis meses.

Alterações

1.1.0

Novidades: cabeças da cadeia do registro, campo de classe (F ou S) em cada evidência e endpoints de evidências com consultas a um momento anterior.

1.0.0

Primeira versão: pulso, arquivo, balanço, conexões, cenários, calendário, resumo, vocabulário e status.

Em preparação

Chaves de API por conta com cota própria e níveis pagos com limites maiores. Nenhuma data é prometida; tudo continua funcionando sem chave.