DataBolsa docs
Referência da APISistemaSistema

Busca unificada (typeahead) por ações/FIIs/ETFs/BDRs/índices/títulos/macro/cripto/EUA/crédito

Resolve ticker↔nome em todas as classes cobertas, incluindo crédito privado: debêntures pelo código de negociação (ELTN17) e CRI/CRA/LCI/LCA pelo código do instrumento no balcão. Para ações vem também o `cvm_code` da companhia, que abre os documentos e as demonstrações (esses endpoints também aceitam o ticker direto).

GET
/v1/search

Authorization

AuthorizationBearer <token>

In: header

Query Parameters

qstring

Termo de busca (ticker ou nome) — ações, FIIs, ETFs, BDRs, índices, títulos do Tesouro, séries macro, cripto, ativos dos EUA e crédito privado (debêntures e CRI/CRA/LCI/LCA do balcão). Acento-insensível; ótimo p/ resolver ticker↔nome.

Length1 <= length <= 64
limit?integer
Default20
Range1 <= value <= 50

Response Body

curl -X GET "https://api.databolsa.com/v1/search?q=string&limit=20"
{
  "data": [
    {
      "kind": "stock",
      "ticker": "string",
      "title": "string",
      "subtitle": "string",
      "href": "string",
      "score": 0,
      "cvm_code": 0
    }
  ],
  "meta": {
    "next_cursor": "string",
    "count": 0,
    "total": 0,
    "subject": {
      "property1": "string",
      "property2": "string"
    },
    "query": "string"
  }
}
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "details": {
    "property1": null,
    "property2": null
  }
}

Saúde da ingestão (pipeline, fontes, pollers, histórico)

`latest` é o último run do pipeline completo, não o último run a terminar: reparos e recargas pontuais têm trigger próprio e aparecem em `latest_by_trigger`, com as mensagens de erro em `errors`. Uma fonte pode estar fresca e oca ao mesmo tempo — `missing_ratio` mede a fração de partições sem dado e `status: incomplete` sinaliza quando ela deixa de ser sazonal. O frescor é julgado contra a cadência da própria fonte: `expected_max_age_days` é o intervalo de atualização que ela declara e `stale_after_days`, o silêncio tolerado antes de `status: stale`. **`latest.ok` fala do RUN, não da sua fonte.** Um run vermelho por causa de uma série do Banco Central não diz nada sobre as ofertas da CVM, que no mesmo run vieram inteiras — e quem lê só o booleano recusa uma pergunta que a base responde. `latest.error_sources` nomeia quais fontes falharam; `sources[]` traz a saúde de cada uma por si. **São 57 fontes.** Use `source` para recortar — casa por substring, então `oferta` acha `cvm_ofertas`. O recorte vale só para `sources[]`: o run e os pollers continuam inteiros, porque é cruzando os dois que se separa 'o pipeline falhou' de 'esta fonte falhou'.