DataBolsa docs
Referência da APIDados de mercadoEmpresas

Companhia por ticker, código CVM ou CNPJ

GET
/v1/companies/{company}

Authorization

AuthorizationBearer <token>

In: header

Path Parameters

companystring

Ticker do papel (BBAS3), código CVM numérico da companhia (1023) OU CNPJ de 14 dígitos (10531501000158). O CNPJ é a porta para a companhia SEM ação em bolsa: quem se registra na CVM apenas para emitir dívida (Categoria B) entrega demonstração financeira completa e não tem ticker. Debênture, FIDC e informe de securitização identificam o emissor por CNPJ, nunca por cd_cvm.

Length1 <= length <= 32

Response Body

curl -X GET "https://api.databolsa.com/v1/companies/string"
{
  "cvm_code": 0,
  "cnpj": "string",
  "name": "string",
  "trade_name": "string",
  "sector": "string",
  "subsector": "string",
  "listing_segment": "string",
  "tickers": [
    "string"
  ],
  "primary_ticker": "string",
  "shares_outstanding": {
    "common": 0,
    "preferred": 0,
    "total": 0
  },
  "free_float_pct": 0,
  "status": "string",
  "has_active_ticker": true
}
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "details": {
    "property1": null,
    "property2": null
  }
}

Filtra ações por múltiplos critérios fundamentalistas

Filtra o universo de ações por faixas de indicadores (pl_min/pl_max, pvp_min/pvp_max, dy_min, roe_min, ev_ebitda_max, div_liq_ebitda_max), liquidez mínima (min_volume), setor e segmento; ordena por `sort` (default `-market_cap`). Paginação por cursor (use meta.next_cursor). Retorna ticker, nome, setor e os indicadores principais por papel. Cada linha traz `quality_flags`: indicador estatisticamente implausível (DY > 20%, P/L < 1, ROE > 100%, payout > 200%) é MARCADO com o motivo, nunca escondido nem nulado. `sector` casa por igualdade EXATA e aceita UM valor. Grafia errada e pedido de dois setores devolvem página vazia, como um setor legítimo sem ação nenhuma — por isso `meta.unmatched_filters` nomeia o recorte que não casou ninguém, e `meta.available_sectors` traz o vocabulário quando o setor não existe. **Para cortar por vários setores, ou por qualquer propriedade categórica, use `rankObjects` / `aggregateObjects` com `where`** — lá o OU cabe dentro do campo (`where=sector=Bancos|Seguradoras`) e o vocabulário vem anunciado em `filterable_properties`, sem uma chamada extra para descobri-lo.

Lista companhias abertas (cadastro CVM)

Next Page