DataBolsa docs
Referência da APIDados de mercadoScreeners

Screener de fundos de investimento (CVM 175)

Ranqueia o universo de fundos por patrimônio, retorno (1m/12m/YTD) ou nº de cotistas; filtra por classificação CVM e PL mínimo. `return_12m` fica null enquanto não houver 12m de histórico.

GET
/v1/screener/funds

Authorization

AuthorizationBearer <token>

In: header

Query Parameters

cursor?string
limit?integer
Default100
Range1 <= value <= 1000
classificacao?string

Filtra por classificação CVM do fundo (match exato), ex.: 'Renda Fixa', 'Ações'.

manager?string

Filtra pelo GESTOR, por substring da razão social publicada pela CVM (ex.: 'paramis').

min_net_worth?number

Patrimônio líquido mínimo (R$).

sort?string
Default"net_worth"
Value in"net_worth" | "return_1m" | "return_12m" | "return_ytd" | "shareholders"
order?string
Default"desc"
Value in"asc" | "desc"

Response Body

curl -X GET "https://api.databolsa.com/v1/screener/funds?cursor=string&limit=100&classificacao=string&manager=string&min_net_worth=0&sort=net_worth&order=asc"
{
  "data": [
    {
      "cnpj": "string",
      "name": "string",
      "tipo_classe": "string",
      "classificacao": "string",
      "classificacao_anbima": "string",
      "manager": "string",
      "admin_fee_pct": 0,
      "situacao": "string",
      "last_date": "string",
      "last_quota": 0,
      "net_worth": 0,
      "shareholders": 0,
      "return_1m": 0,
      "return_12m": 0,
      "return_ytd": 0,
      "net_flow_accumulated": 0
    }
  ],
  "meta": {
    "next_cursor": "string",
    "count": 0,
    "total": 0,
    "subject": {
      "property1": "string",
      "property2": "string"
    }
  }
}
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "details": {
    "property1": null,
    "property2": null
  }
}

Universo de FIIs filtrável por segmento e tijolo/papel

Lista o universo de FIIs ATIVOS (com informe mensal nos últimos 6 meses; include_stale=true inclui encerrados/incorporados), filtrável por segmento, tijolo/papel e PL mínimo (min_pl); ordena por `sort`. Paginação por cursor (meta.next_cursor). Retorna ticker, nome, segmento e indicadores (dy, pvp, vacância…).

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.