Screener de debêntures: indexação, spread, liquidez e demanda de fundos
Filtra e ranqueia o universo de debêntures por indexador, spread, vencimento, liquidez do secundário e demanda institucional. Como ler cada métrica: `spread_pct_aa` é a taxa aditiva sobre o indexador (indexer='DI' + indexer_pct=100 + spread=1,6 lê-se DI a 100% + 1,6% a.a.); `years_to_maturity` é o prazo restante em anos (null = vencida ou perpétua); `last_pct_of_curve` é o preço do último negócio como % do PU teórico na curva — <100 = deságio (risco percebido ou iliquidez), >100 = ágio; `trades_30d`/`volume_brl_30d` (e 90d) medem liquidez em janelas contadas do último pregão disponível, com volume aproximado por PU médio × quantidade; `fund_holders`/`funds_value_brl` dizem quantos fundos detêm o papel e o valor somado dessas posições na carteira mensal mais recente (null = fora das carteiras divulgadas, não zero). `is_incentivada` = isenta de IR para pessoa física (Lei 12.431). Default: só emissões vivas (active=true), ordenadas por volume_brl_30d desc.
In: header
Query Parameters
1001 <= value <= 1000Busca por código do papel ou nome do emissor (substring).
Indexador as-filed: DI, IPCA, IGP-M, PRÉ, TR…
true = só incentivadas (Lei 12.431, isentas de IR para pessoa física).
Default true = só emissões vivas. active=false lista as saídas (vencidas/resgatadas).
trueVencimento a partir de (YYYY-MM-DD).
^\d{4}-\d{2}-\d{2}$Vencimento até (YYYY-MM-DD).
^\d{4}-\d{2}-\d{2}$Spread mínimo em % a.a. sobre o indexador.
Spread máximo em % a.a. sobre o indexador.
Piso de liquidez: nº mínimo de negócios no secundário na janela de 30 dias.
Nº mínimo de fundos com posição no papel na última carteira mensal divulgada.
Critério de ordenação: spread (spread_pct_aa), maturity (vencimento), volume_30d, trades_30d, fund_holders ou pct_of_curve (last_pct_of_curve). Papel sem a métrica vai para o fim em qualquer sentido.
"volume_30d""spread" | "maturity" | "volume_30d" | "trades_30d" | "fund_holders" | "pct_of_curve""desc""asc" | "desc"Response Body
curl -X GET "https://api.databolsa.com/v1/screener/debentures?cursor=string&limit=100&q=string&indexer=string&incentivada=true&active=true&maturityFrom=string&maturityTo=string&minSpread=0&maxSpread=0&minTrades30d=0&minFundHolders=0&orderBy=spread&order=asc"{
"data": [
{
"code": "string",
"isin": "string",
"issuer_name": "string",
"issuer_cnpj": "string",
"is_active": true,
"indexer": "string",
"indexer_pct": 0,
"spread_pct_aa": 0,
"is_incentivada": true,
"guarantee_type": "string",
"maturity_date": "string",
"years_to_maturity": 0,
"face_value_current": 0,
"qty_outstanding": 0,
"listed_b3": true,
"last_trade_date": "string",
"last_pu_avg": 0,
"last_pct_of_curve": 0,
"trades_30d": 0,
"qty_traded_30d": 0,
"volume_brl_30d": 0,
"trades_90d": 0,
"volume_brl_90d": 0,
"fund_holders": 0,
"funds_value_brl": 0
}
],
"meta": {
"next_cursor": "string",
"count": 0
}
}{
"type": "string",
"title": "string",
"status": 0,
"detail": "string",
"instance": "string"
}Série intradiária da sessão (delay de 15 min)
Barras de minuto do pregão; `session` filtra o pregão (default = mais recente).
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…).