Additional Features

Notification via API

General Information

ANBIMA Feed has resources that allow subscribers to receive systemic notifications in some situations, such as when new information is available in a specific context, or when there is a delay to provide specific information.

For this mechanism to work properly, the subscriber needs to expose a RESTFul API so that ANBIMA Feed can make the requests. This exposed API must be implemented following the specification below:

Method: POST

URL: Defined by the subscriber and informed to ANBIMA for registration (ex. https://endpoint-subscriber.com/resource-subscriber/)

Body: It will vary according to the Package/Item to which the notification refers.

Autenticação: “Basic Authentication”, as specified in https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Authorization.

Pricing and Indices

Notifications will behave the same for all items that are part of the Pricing and Index API packages. The expected body is:

{
  "id_notificacao_cliente": "string",
  "tipo_evento": "string",
  "data_envio": "string",
  "nome_pacote": "string",
  "nome_item": "string",
  "descricao": "string",
  "data_referencia": "string"
  "url_api_feed": "string",
}

Details of body fields:

Body fieldsDescription
id_notificacao_clienteIdentifier of the message sent to the subscriber.
tipo_eventoThis information refers to the event type that generated the notification. Values:
– NOVO (NEW): Data made available to the Package/Item and Reference Date informed.
– ATUALIZACAO (UPDATING): Data updated for the Package/Item and Reference Date informed previously stored data for this Package/Item and Reference Date must be deleted and replaced with the new data when this type of notification occurs.
– ATRASO (DELAY): The generation of the Package/Item data and Reference Date informed is delayed.
data_envioDate the message was sent.
nome_pacoteName of package for which the notification was generated.
nome_itemName of package item for which the notification was generated.
descricaoDescriptive text of notification.
data_referenciaReference date of the data provided.
url_api_feedReference URL for data to be verified on Feed. Observation: The “date” or “month and year” parameters will already be filled on URL.

The next table summarizes which APIs must be called to request updating of data for each Package and Item of the ANBIMA Feed:

Descriptionnome_pacotenome_itemurl_api_feed
Federal Government Bonds Secondary MarketTITULOS_PUBLICOSMERCADO_SECUNDARIO_TPFhttps://api.anbima.com.br/feed/precos-indices/v1/titulos-publicos/mercado-secundario-TPF
Federal Government Bonds – Face ValueTITULOS_PUBLICOSVNAhttps://api.anbima.com.br/feed/precos-indices/v1/titulos-publicos/vna
Term Structure of Interest RateTITULOS_PUBLICOSCURVAS_JUROShttps://api.anbima.com.br/feed/precos-indices/v1/titulos-publicos/curvas-juros
Intraday CurveTITULOS_PUBLICOSCURVA_INTRADIARIAhttps://api.anbima.com.br/feed/precos-indices/v1/titulos-publicos/curva-intradiaria
Intraday Unit PricesTITULOS_PUBLICOSPU_INTRADIARIOhttps://api.anbima.com.br/feed/precos-indices/v1/titulos-publicos/pu-intradiario
ANBIMA’s Bond Market Reporting SystemTITULOS_PUBLICOSDIFUSAO_TAXAShttps://api.anbima.com.br/feed/precos-indices/v1/titulos-publicos/difusao-taxas
SELIC EstimateTITULOS_PUBLICOSESTIMATIVA_SELIChttps://api.anbima.com.br/feed/precos-indices/v1/titulos-publicos/estimativa-selic
IPCA and IGP-M ProjectionsTITULOS_PUBLICOSPROJECAO_IPCA_IGPMhttps://api.anbima.com.br/feed/precos-indices/v1/titulos-publicos/projecoes
Corporate Bonds Secondary MarketDEBENTURESMERCADO_SECUNDARIO_DEBENTUREShttps://api.anbima.com.br/feed/precos-indices/v1/debentures/mercado-secundario
Credit CurvesDEBENTURESCURVAS_CREDITOhttps://api.anbima.com.br/feed/precos-indices/v1/debentures/curvas-credito
IPCA and IGP-M ProjectionsDEBENTURESPROJECAO_IPCA_IGPMhttps://api.anbima.com.br/feed/precos-indices/v1/debentures/projecoes
Real State and Agribusiness Receivables Secondary MarketCRI_CRAMERCADO_SECUNDARIO_CRICRAhttps://api.anbima.com.br/feed/precos-indices/v1/cri-cra/mercado-secundario
IPCA and IGP-M ProjectionsCRI_CRAPROJECAO_IPCA_IGPMhttps://api.anbima.com.br/feed/precos-indices/v1/cri-cra/projecoes
IDA Theoretical PortfolioINDICES_MAISCARTEIRA_TEORICA_IDAhttps://api.anbima.com.br/feed/precos-indices/v1/indices-mais/carteira-teorica-ida
IDA Results and ComponentsINDICES_MAISRESULTADOS_COMPONENTE_IDAhttps://api.anbima.com.br/feed/precos-indices/v1/indices-mais/resultados-ida
IHFA Theoretical PortfolioINDICES_MAISCARTEIRA_TEORICA_IHFAhttps://api.anbima.com.br/feed/precos-indices/v1/indices-mais/carteira-teorica-ihfa
IHFA Results and ComponentsINDICES_MAISRESULTADOS_COMPONENTE_IHFAhttps://api.anbima.com.br/feed/precos-indices/v1/indices-mais/resultados-ihfa
IDkA ResultsINDICES_MAISRESULTADOS_IDKAhttps://api.anbima.com.br/feed/precos-indices/v1/indices-mais/resultados-idka
IMA Theoretical PortfolioINDICES_MAISCARTEIRA_TEORICA_IMAhttps://api.anbima.com.br/feed/precos-indices/v1/indices-mais/carteira-teorica-ima
IMA Results and ComponentsINDICES_MAISRESULTADOS_COMPONENTE_IMAhttps://api.anbima.com.br/feed/precos-indices/v1/indices-mais/resultados-ima
IMA Intraday ResultsINDICES_MAISRESULTADO_INTRADIARIOhttps://api.anbima.com.br/feed/precos-indices/v1/indices/resultados-intradiarios-ima
IMA Intraday Unit PricesINDICES_MAISPU_INTRADIARIOhttps://api.anbima.com.br/feed/precos-indices/v1/indices-mais/pu-intradiario
IDA Theoretical PortfolioINDICESCARTEIRA_TEORICA_IDAhttps://api.anbima.com.br/feed/precos-indices/v1/indices/carteira-teorica-ida
IDA ResultsINDICESRESULTADOS_IDAhttps://api.anbima.com.br/feed/precos-indices/v1/indices/resultados-ida-fechado
IHFA Theoretical PortfolioINDICESCARTEIRA_TEORICA_IHFAhttps://api.anbima.com.br/feed/precos-indices/v1/indices/carteira-teorica-ihfa
IHFA ResultsINDICESRESULTADOS_IHFAhttps://api.anbima.com.br/feed/precos-indices/v1/indices/resultados-ihfa-fechado
IDkA ResultsINDICESRESULTADOS_IDKAhttps://api.anbima.com.br/feed/precos-indices/v1/indices/resultados-idka
IMA Theoretical PortfolioINDICESCARTEIRA_TEORICA_IMAhttps://api.anbima.com.br/feed/precos-indices/v1/indices/carteira-teorica-ima
IMA ResultsINDICESRESULTADOS_IMAhttps://api.anbima.com.br/feed/precos-indices/v1/indices/resultados-ima
IMA Intraday ResultsINDICESRESULTADO_INTRADIARIOhttps://api.anbima.com.br/feed/precos-indices/v1/indices/resultados-intradiarios-ima
Forward-looking Index ConstituentsIMA_ETFPREVIA_CARTEIRA_TEORICA_IMAhttps://api.anbima.com.br/feed/precos-indices/v2/ima-etf/previa-carteira-teorica
Theoretical PortfolioIMA_ETFCARTEIRA_TEORICA_IMAhttps://api.anbima.com.br/feed/precos-indices/v2/ima-etf/carteira-teorica
Daily ResultIMA_ETFRESULTADO_DIARIOhttps://api.anbima.com.br/feed/precos-indices/v2/ima-etf/resultado-diario
Daily CompositionIMA_ETFCOMPOSICAO_DIARIAhttps://api.anbima.com.br/feed/precos-indices/v2/ima-etf/composicao-diaria
Intraday ResultsIMA_ETFRESULTADO_INTRADIARIOhttps://api.anbima.com.br/feed/precos-indices/v2/ima-etf/resultado-intradiario
Intraday Unit PricesIMA_ETFPU_INTRADIARIOhttps://api.anbima.com.br/feed/precos-indices/v2/ima-etf/pu-intradiario
Extragroup Trading DataIMA_ETFNEGOCIOS_EXTRAhttps://api.anbima.com.br/feed/precos-indices/v2/ima-etf/negocios-extra

Investment Funds

For notifications of Items that are part of the Investment Funds packages, all funds that had data update on a certain date will be grouped. For bodies, there will be some differences depending on the package, item and resource, as specified below.

Fund Details APIs

ICVM 555 and Offshore Funds:

  "id_notificacao_cliente": "string",
  "data_envio": "string",
  "nome_pacote": "string",
  "nome_item": "string",
  "descricao": "string",
  "total_registros": "int",
  "pagina": "int",
  "total_paginas": "int",
  "registros": [
    {
      "codigo_fundo": "string",
      "data_atualizacao": "string",
      "url_api_feed": [
        "string"
      ]
    }
  ]

Structured Funds:

{
  "id_notificacao_cliente": "string",
  "data_envio": "string",
  "nome_pacote": "string",
  "nome_item": "string",
  "descricao": "string",
  "total_registros": "int",
  "pagina": "int",
  "total_paginas": "int",
  "registros": [
    {
      "cnpj": "string",
      "data_atualizacao": "string",
      "url_api_feed": [
        "string"
      ]
    }
  ]
}

Fund Historical Serie APIs

ICVM 555 and Offshore Funds:

{
  "id_notificacao_cliente": "string",
  "data_envio": "string",
  "nome_pacote": "string",
  "nome_item": "string",
  "descricao": "string",
  "total_registros": "int",
  "pagina": "int",
  "total_paginas": "int",
  "registros": [
    {
      "codigo_fundo": "string",
      "data_referencia_inicio": "string",
      "data_referencia_fim": "string",
      "url_api_feed": [
        "string"
      ]
    }
  ]
}

Structured Funds:

{
  "id_notificacao_cliente": "string",
  "data_envio": "string",
  "nome_pacote": "string",
  "nome_item": "string",
  "descricao": "string",
  "total_registros": "int",
  "pagina": "int",
  "total_paginas": "int",
  "registros": [
    {
      "cnpj": "string",
      "data_referencia_inicio": "string",
      "data_referencia_fim": "string",
      "url_api_feed": [
        "string"
      ]
    }
  ]
}

Fund Explanatory Notes API

ICVM 555 Funds:

{
  "id_notificacao_cliente": "string",
  "data_envio": "string",
  "nome_pacote": "string",
  "nome_item": "string",
  "descricao": "string",
  "total_registros": "int",
  "pagina": "int",
  "total_paginas": "int",
  "registros": [
    {
      "codigo_fundo": "string",
      "url_api_feed": [
        "string"
      ]
    }
  ]
}

Details of body fields:

Body_fieldsDescription
id_notificacao_clienteIdentifier of the message sent to the subscriber.
data_envioDate the message was sent.
nome_pacoteName of package for which the notification was generated.
nome_itemName of package item for which the notification was generated.
descricaoDescriptive text of notification.
total_registrosTotal funds within the list of records.
paginaCurrent notification page.
total_paginasTotal pages that correspond to the notification on the given data_envio.
registrosList of updated funds that generated the notification.
codigo_fundoUpdated fund code. (applicable only for ICVM 555 or Offshore Funds APIs)
cnpjCNPJ (Corporate Taxpayer’s ID) of updated fund. (applicable only for Structured Funds APIs)
data_atualizacaoDate wherein fund’s registration data was updated. (applicable only for Fund Details APIs)
data_referencia_inicioInitial reference date of updated historical serie data. (applicable only for Historical Serie APIs)
data_referencia_fimFinal reference date of updated historical serie data. (applicable only for Historical Serie APIs)
url_api_feedReference URL for data to be verified on Feed. Observation: The “date” parameter will already be filled on URL.

The next table summarizes which APIs must be called to request updating of data for each Package and Item of the ANBIMA Feed:

Descriptionnome_pacotenome_itemurl_api_feed
ICVM 555 Fund DetailsFUNDOSFUNDOS_DETALHEShttps://api.anbima.com.br/feed/fundos/v1/fundos/{ANBIMAcode}
ICVM 555 Fund Explanatory NotesFUNDOSFUNDOS_NOTA_EXPLICATIVAhttps://api.anbima.com.br/feed/fundos/v1/fundos/{ ANBIMAcode}/notas-explicativas
ICVM 555 Fund Historical SerieFUNDOSFUNDOS_SERIE_HISTORICAhttps://api.anbima.com.br/feed/v1/fundos/{ ANBIMAcode o}/serie-historica
Structured Fund DetailsFUNDOS_ESTRUTURADOSFUNDOS_ESTRUTURADOS_DETALHEShttps://api.anbima.com.br/feed/fundos/v1/fundos/{CNPJ}
Structured Fund Historical SerieFUNDOS_ESTRUTURADOSFUNDOS_ESTRUTURADOS_SERIE_HISTORICAhttps://api.anbima.com.br/feed/fundos/v1/fundos-estruturados/{CNPJ}/serie-historica
Offshore Fund DetailsFUNDOS_OFFSHOREFUNDOS_OFFSHORE_DETALHEShttps://api.anbima.com.br/feed/fundos/v1/fundos-offshore/{ANBIMAcode}
Offshore Fund Historical SerieFUNDOS_OFFSHOREFUNDOS_OFFSHORE_SERIE_HISTORICAhttps://api.anbima.com.br/feed/v1/fundos-offshore/{ANBIMAcode}/serie-historica