Referência da APIDados de mercadoScreeners
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), setor e segmento; ordena por `sort`. Paginação por cursor (use meta.next_cursor). Retorna ticker, nome, setor e os indicadores principais por papel.
AuthorizationBearer <token>
In: header
Query Parameters
cursor?string
limit?integer
Default
100Range
1 <= value <= 1000pl_min?number
pl_max?number
pvp_min?number
pvp_max?number
dy_min?number
roe_min?number
ev_ebitda_max?number
div_liq_ebitda_max?number
sector?string
Filtra por setor da empresa (match EXATO, case-sensitive). Valor desconhecido retorna página vazia, sem erro.
segment?string
Filtra por segmento de listagem B3 (substring, case-insensitive), ex.: 'Novo Mercado'.
sort?string
Ordena por indicador. Valores: pl, pvp, psr, dy, dy_12m, roe, roic, ev_ebitda, market_cap, margem_liquida. Prefixe com '-' para decrescente (ex.: -dy_12m). Nomes livres como 'dividend_yield' são inválidos.
Response Body
curl -X GET "https://api.databolsa.com/v1/screener/stocks?cursor=string&limit=100&pl_min=0&pl_max=0&pvp_min=0&pvp_max=0&dy_min=0&roe_min=0&ev_ebitda_max=0&div_liq_ebitda_max=0§or=string&segment=string&sort=string"{
"data": [
{
"ticker": "string",
"name": "string",
"sector": "string",
"indicators": {
"market_cap": 0,
"pl": 0,
"pvp": 0,
"dy": 0,
"roe": 0,
"roic": 0,
"ev_ebitda": 0,
"div_liq_ebitda": 0,
"margem_liquida": 0
}
}
],
"meta": {
"next_cursor": "string",
"count": 0
}
}{
"type": "string",
"title": "string",
"status": 0,
"detail": "string",
"instance": "string"
}