Ofertas públicas de distribuição (mercado primário)

Registro de ofertas públicas (IPO/follow-on de ações, debêntures, cotas de fundos), unificando o histórico ICVM 400/476/555 e o rito automático RCVM 160. Grão: SÉRIE da oferta — um processo multissérie tem uma linha por série, e o valor pode diferir entre elas. Filtrável por emissor, regime, instrumento/família e período; ordena por `sort`/`order` (default: `data_referencia` decrescente). Fonte: CVM. COBERTURA. O acervo de esforços restritos (ICVM 476, 2008-2022) é 44% da base e não tem `data_registro` nem `numero_processo` — use `data_referencia` para série temporal e `regime_registro` para separar ofertas registradas de dispensadas. ANTES DE SOMAR `valor_total`: é o valor REGISTRADO, não o colocado, e é campo livre na fonte. Exclua `value_is_sentinel` (preenchimento com noves; um único registro de 2022 infla o ano em 40x) e `value_pre_real_currency` (cruzeiro/cruzado não convertido).

Authorization

AuthorizationBearer <token>

In: header

Query Parameters

cursor?string

limit?integer

Default100

Range1 <= value <= 1000

search?string

Nome ou CNPJ do emissor.

regime?string

Value in"ICVM_400_476" | "RCVM_160"

instrumento?string

Instrumento CANÔNICO — o filtro recomendado. A fonte usa um vocabulário por regime (60 grafias para ~28 instrumentos), então instrumento=debenture recupera tanto 'Debêntures' quanto 'DEBÊNTURES SIMPLES'.

Value in

"acao" | "unit" | "bdr" | "bonus_subscricao" | "warrant" | "debenture" | "debenture_conversivel" | "debenture_permutavel" | "token_debenture" | "nota_comercial" | "letra_financeira" | "ccb" | "cpr_financeira" | "warrant_agropecuario" | "cri" | "cra" | "cr" | "cdca" | "outros_securitizacao" | "cota_fidc" | "cota_fii" | "cota_fip" | "cota_fiagro" | "cota_fundo" | "cota_fundo_infra" | "cota_funcine" | "token_cota_fundo" | "cert_audiovisual" | "cert_energia" | "tic" | "nao_mapeado"

familia?string

Agrupamento do instrumento: divida | securitizacao | equity | fundo | outro.

tipo_ativo?string

Grafia AS-FILED da fonte, casada sem acento e sem caixa. Não expande para as grafias irmãs do mesmo instrumento — para o conjunto completo use instrumento. Aceita também um valor de instrumento/familia, e nesse caso filtra pela coluna canônica.

from?string

Recorta por data_referencia, a mesma coluna da ordenação default.

Match^\d{4}-\d{2}-\d{2}$

to?string

Recorta por data_referencia, a mesma coluna da ordenação default.

Match^\d{4}-\d{2}-\d{2}$

sort?string

Campo de ordenação. data_registro e data_referencia são sinônimos e ordenam por data_referencia (data_registro > data_inicio > data_processo): o acervo ICVM 476 não tem data de registro, e ordenar pela coluna crua o empurrava todo para o fim.

Default"data_registro"

Value in"data_referencia" | "data_registro" | "data_processo" | "data_encerramento" | "valor_total"

order?string

Default"desc"

Value in"asc" | "desc"

fields?string

Projeção: lista de campos separada por vírgula (ex.: instrumento,valor_total,data_referencia). offering_id sempre incluído. Sem o parâmetro, a resposta traz todos os 29 campos.

Response Body

curl -X GET "https://api.databolsa.com/v1/offerings?cursor=string&limit=100&search=string&regime=ICVM_400_476&instrumento=acao&familia=divida&tipo_ativo=string&from=string&to=string&sort=data_referencia&order=asc&fields=string"

curl -X GET "https://api.databolsa.com/v1/offerings?cursor=string&limit=100&search=string&regime=ICVM_400_476&instrumento=acao&familia=divida&tipo_ativo=string&from=string&to=string&sort=data_referencia&order=asc&fields=string"

{
  "data": [
    {
      "offering_id": "string",
      "regime": "string",
      "numero_processo": "string",
      "numero_requerimento": "string",
      "numero_registro": "string",
      "serie": "string",
      "emissao": "string",
      "cnpj_emissor": "string",
      "nome_emissor": "string",
      "nome_lider": "string",
      "tipo_ativo": "string",
      "instrumento": "string",
      "familia": "string",
      "tipo_oferta": "string",
      "rito": "string",
      "modalidade_registro": "string",
      "regime_registro": "string",
      "status": "string",
      "data_processo": "string",
      "data_registro": "string",
      "data_inicio": "string",
      "data_referencia": "string",
      "data_encerramento": "string",
      "valor_total": 0,
      "value_is_sentinel": true,
      "value_pre_real_currency": true,
      "quantidade_total": 0,
      "preco_unitario": 0,
      "incentivo_fiscal": true
    }
  ],
  "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
  }
}