Documentação Técnica Feed Preços e Índices

ANBIMA Feed Preços e Índices

1. Sobre Nossa API

O ANBIMA Feed Preços Índices é composto por APIs RESTFul baseadas no protocolo HTTP, utilizadas para a disponibilização de dados de precificação e de índices de mercado da ANBIMA. As informações são divididas nos seguintes pacotes: Títulos Públicos, Debêntures, Índices+, Índices, IMA-ETF e Certificados de Recebíveis (CRI e CRA).

2. Primeiros passos

  • Conheça nossos ambientes

    Nossas APIs podem ser acessadas através de dois ambientes: Sandbox e Produção.
    O ambiente de Sandbox pode ser utilizado para testes gerais do serviço, tal como verificar o formato de resposta de um recurso específico da API. Neste momento os dados retornados serão fixos e fictícios.
    Já as informações oficiais poderão ser obtidas apenas através do ambiente de produção.

  • Como realizar chamadas aos recursos de nossa API?

    Já as informações oficiais poderão ser obtidas apenas através do ambiente de produção. https://<ambiente>/<produto>/<versão>/<pacote>/<recursos>/<parâmetros>, sendo:

    • protocolo: https
    • ambiente: api.anbima.com.br (Produção) ou api-sandbox.anbima.com.br/mocks (Sandbox)
    • produto: feed/precos-indices
    • versão: v1

  • Logo, a URI a ser utilizada para acesso a qualquer uma das APIs do ANBIMA Feed seria https://<ambiente>/feed/precos-indices/v1/<pacote>/<recursos>.

    Lembrando que todos recursos desta API são privados e apenas podem ser acessados em ambientes de sandbox e produção através do padrão de autenticação O-Auth 2 (explicado em detalhes na seção Autenticação).

    Para maiores detalhes sobre os campos de cada API, por favor, consulte a nossa documentação funcional).

    Títulos Públicos

    Mercado Secundário de TPF

    Esta API retorna registros de mercado secundário correspondentes aos títulos públicos federais em mercado. Se uma data não for especificada, serão retornados os registros da data mais recente disponível.

    Para acessá-la, deve-se utilizar a seguinte URI: https://<ambiente>/feed/precos-indices/v1/titulos-publicos/mercado-secundario-TPF.

    O método utilizado para acesso aos recursos deve ser o GET, pois nossa API é exclusivamente utilizada para consultas a informações. Um exemplo de chamada real em ambiente de produção seria: GET https://api.anbima.com.br/feed/precos-indices/v1/titulos-publicos/mercado-secundario-TPF.

    Para especificar uma data na consulta, deve-se realizar a chamada informando o parâmetro, conforme o exemplo: GET https://api.anbima.com.br/feed/precos-indices/v1/titulos-publicos/mercado-secundario-TPF?data=AAAA-MM-DD.

    VNA

    Esta API retorna valores nominais atualizados. Se uma data não for especificada, serão retornados os registros da data mais recente disponível.

    Para acessá-la, deve-se utilizar a seguinte URI: https://<ambiente>/feed/precos-indices/v1/titulos-publicos/vna.

    O método utilizado para acesso aos recursos deve ser o GET, pois nossa API é exclusivamente utilizada para consultas a informações. Um exemplo de chamada real em ambiente de produção seria: GET https://api.anbima.com.br/feed/precos-indices/v1/titulos-publicos/vna.

    Para especificar uma data na consulta, deve-se realizar a chamada informando o parâmetro, conforme o exemplo: GET https://api.anbima.com.br/feed/precos-indices/v1/titulos-publicos/vna?data=AAAA-MM-DD.

    Curva de Juros

    Esta API retorna curvas de juros zero-cupom soberanas extraídas a partir das taxas dos títulos públicos prefixados e atrelados ao IPCA. Se uma data não for especificada, serão retornados os registros da data mais recente disponível.

    Para acessá-la, deve-se utilizar a seguinte URI: https://<ambiente>/feed/precos-indices/v1/titulos-publicos/curva-juros.

    O método utilizado para acesso aos recursos deve ser o GET, pois nossa API é exclusivamente utilizada para consultas a informações. Um exemplo de chamada real em ambiente de produção seria: GET https://api.anbima.com.br/feed/precos-indices/v1/titulos-publicos/curva-juros.

    Para especificar uma data na consulta, deve-se realizar a chamada informando o parâmetro, conforme o exemplo: GET https://api.anbima.com.br/feed/precos-indices/v1/titulos-publicos/curva-juros?data=AAAA-MM-DD.

    Difusão de Taxas

    Esta API retorna informações consolidadas na plataforma de difusão de taxas da ANBIMA sobre o mercado de títulos públicos federais, divulgadas ao longo do dia. Se uma data não for especificada, serão retornados os registros da data mais recente disponível.

    Para acessá-la, deve-se utilizar a seguinte URI: https://<ambiente>/feed/precos-indices/v1/titulos-publicos/difusao-taxas.

    O método utilizado para acesso aos recursos deve ser o GET, pois nossa API é exclusivamente utilizada para consultas a informações. Um exemplo de chamada real em ambiente de produção seria: GET https://api.anbima.com.br/feed/precos-indices/v1/titulos-publicos/difusao-taxas.

    Para especificar uma data na consulta, deve-se realizar a chamada informando o parâmetro, conforme o exemplo: GET https://api.anbima.com.br/feed/precos-indices/v1/titulos-publicos/difusao-taxas?data=AAAA-MM-DD.

    Curva Intradiária

    Esta API retorna informações extraídas a partir da coleta de spreads de compra e venda realizada pela Associação. Se uma data não for especificada, serão retornados os registros da data mais recente disponível.

    Para acessá-la, deve-se utilizar a seguinte URI: https://<ambiente>/feed/precos-indices/v1/titulos-publicos/curva-intradiaria.

    O método utilizado para acesso aos recursos deve ser o GET, pois nossa API é exclusivamente utilizada para consultas a informações. Um exemplo de chamada real em ambiente de produção seria: GET https://api.anbima.com.br/feed/precos-indices/v1/titulos-publicos/curva-intradiaria.

    Para especificar uma data na consulta, deve-se realizar a chamada informando o parâmetro, conforme o exemplo: GET https://api.anbima.com.br/feed/precos-indices/v1/titulos-publicos/curva-intradiaria?data=AAAA-MM-DD.

    PU Intradiário

    Esta API retorna informações dos PUs dos LTN, NTN-B e NTN-F relativos aos spreads apurados e utilizados na obtenção dos resultados intradiários do IMA. Se uma data não for especificada, serão retornados os registros da data mais recente disponível.

    Para acessá-la, deve-se utilizar a seguinte URI: https://<ambiente>/feed/precos-indices/v1/titulos-publicos/pu-intradiario.

    O método utilizado para acesso aos recursos deve ser o GET, pois nossa API é exclusivamente utilizada para consultas a informações. Um exemplo de chamada real em ambiente de produção seria: GET https://api.anbima.com.br/feed/precos-indices/v1/titulos-publicos/pu-intradiario.

    Para especificar uma data na consulta, deve-se realizar a chamada informando o parâmetro, conforme o exemplo: GET https://api.anbima.com.br/feed/precos-indices/v1/titulos-publicos/pu-intradiario?data=AAAA-MM-DD.

    Projeções IPCA e IGP-M

    Esta API retorna informações relativas às apurações das projeções para o IGP-M e IPCA cujos registros são do mês e ano de referência. Se mês e ano não forem especificados, serão retornados os registros do mês e ano mais recentes disponíveis.

    Para acessá-la, deve-se utilizar a seguinte URI: https://<ambiente>/feed/precos-indices/v1/titulos-publicos/projecoes.

    O método utilizado para acesso aos recursos deve ser o GET, pois nossa API é exclusivamente utilizada para consultas a informações. Um exemplo de chamada real em ambiente de produção seria: GET https://api.anbima.com.br/feed/precos-indices/v1/titulos-publicos/projecoes.

    Para especificar mês e ano na consulta, deve-se realizar a chamada informando os parâmetros, conforme o exemplo: GET https://api.anbima.com.br/feed/precos-indices/v1/titulos-publicos/projecoes?MM=01&AAAA=2019.

    Estimativa Selic

    Esta API retorna a estimativa da taxa Selic coletada diariamente pela ANBIMA junto a uma amostra de tesourarias. Se uma data não for especificada, serão retornados os registros da data mais recente disponível.

    Para acessá-la, deve-se utilizar a seguinte URI: https://<ambiente>/feed/precos-indices/v1/titulos-publicos/estimativa-selic.

    O método utilizado para acesso aos recursos deve ser o GET, pois nossa API é exclusivamente utilizada para consultas a informações. Um exemplo de chamada real em ambiente de produção seria: GET https://api.anbima.com.br/feed/precos-indices/v1/titulos-publicos/estimativa-selic.

    Para especificar uma data na consulta, deve-se realizar a chamada informando o parâmetro, conforme o exemplo: GET https://api.anbima.com.br/feed/precos-indices/v1/titulos-publicos/estimativa-selic?data=AAAA-MM-DD.

    Debêntures

    Mercado Secundário

    Esta API retorna registros de mercado secundário correspondentes às debêntures apuradas pela ANBIMA. Se uma data não for especificada, serão retornados os registros da data mais recente disponível.

    Para acessá-la, deve-se utilizar a seguinte URI: https://<ambiente>/feed/precos-indices/v1/debentures/mercado-secundario.

    O método utilizado para acesso aos recursos deve ser o GET, pois nossa API é exclusivamente utilizada para consultas a informações. Um exemplo de chamada real em ambiente de produção seria: GET https://api.anbima.com.br/feed/precos-indices/v1/debentures/mercado-secundario.

    Para especificar uma data na consulta, deve-se realizar a chamada informando o parâmetro, conforme o exemplo: GET https://api.anbima.com.br/feed/precos-indices/v1/debentures/mercado-secundario?data=AAAA-MM-DD.

    Curvas de Crédito

    Esta API retorna registros das curvas de crédito ANBIMA extraídas das debêntures precificadas pela Associação. Se uma data não for especificada, serão retornados os registros da data mais recente disponível.

    Para acessá-la, deve-se utilizar a seguinte URI: https://<ambiente>/feed/precos-indices/v1/debentures/curvas-credito.

    O método utilizado para acesso aos recursos deve ser o GET, pois nossa API é exclusivamente utilizada para consultas a informações. Um exemplo de chamada real em ambiente de produção seria: GET https://api.anbima.com.br/feed/precos-indices/v1/debentures/curvas-credito.

    Para especificar uma data na consulta, deve-se realizar a chamada informando o parâmetro, conforme o exemplo: GET https://api.anbima.com.br/feed/precos-indices/v1/debentures/curvas-credito?data=AAAA-MM-DD.

    Projeções IPCA e IGP-M

    Esta API retorna informações relativas às apurações das projeções para o IGP-M e IPCA cujos registros são do mês e ano de referência. Se mês e ano não forem especificados, serão retornados os registros do mês e ano mais recentes disponíveis.

    Para acessá-la, deve-se utilizar a seguinte URI: https://<ambiente>/feed/precos-indices/v1/debentures/projecoes.

    O método utilizado para acesso aos recursos deve ser o GET, pois nossa API é exclusivamente utilizada para consultas a informações. Um exemplo de chamada real em ambiente de produção seria: GET https://api.anbima.com.br/feed/precos-indices/v1/debentures/projecoes.

    Para especificar mês e ano na consulta, deve-se realizar a chamada informando os parâmetros, conforme o exemplo: GET https://api.anbima.com.br/feed/precos-indices/v1/debentures/projecoes?MM=01&AAAA=2019.

    Índices+

    IDA carteira teórica

    Esta API retorna informações relativas aos dados referentes às composições das carteiras teóricas mensais dos índices da família IDA. Se mês e ano não forem especificados, serão retornados os registros do mês e ano mais recentes disponíveis.

    Para acessá-la, deve-se utilizar a seguinte URI: https://<ambiente>/feed/precos-indices/v1/indices-mais/carteira-teorica-ida.

    O método utilizado para acesso aos recursos deve ser o GET, pois nossa API é exclusivamente utilizada para consultas a informações. Um exemplo de chamada real em ambiente de produção seria: GET https://api.anbima.com.br/feed/precos-indices/v1/indices-mais/carteira-teorica-ida.

    Para especificar mês e ano na consulta, deve-se realizar a chamada informando os parâmetros, conforme o exemplo: GET https://api.anbima.com.br/feed/precos-indices/v1/indices-mais/carteira-teorica-ida?MM=01&AAAA=2019.

    IDA resultados e componentes

    Esta API retorna resultados e composição do IDA. Se uma data não for especificada, serão retornados os registros da data mais recente disponível.

    Para acessá-la, deve-se utilizar a seguinte URI: https://<ambiente>/feed/precos-indices/v1/indices-mais/resultados-ida.

    O método utilizado para acesso aos recursos deve ser o GET, pois nossa API é exclusivamente utilizada para consultas a informações. Um exemplo de chamada real em ambiente de produção seria: GET https://api.anbima.com.br/feed/precos-indices/v1/indices-mais/resultados-ida.

    Para especificar uma data na consulta, deve-se realizar a chamada informando o parâmetro, conforme o exemplo: GET https://api.anbima.com.br/feed/precos-indices/v1/indices-mais/resultados-ida?data=AAAA-MM-DD.

    IHFA carteira teórica

    Esta API retorna informações relativas aos dados referentes às composições das carteiras teóricas trimestrais do IHFA. Se mês e ano não forem especificados, serão retornados os registros do mês e ano mais recentes disponíveis.

    Para acessá-la, deve-se utilizar a seguinte URI: https://<ambiente>/feed/precos-indices/v1/indices-mais/carteira-teorica-ihfa.

    O método utilizado para acesso aos recursos deve ser o GET, pois nossa API é exclusivamente utilizada para consultas a informações. Um exemplo de chamada real em ambiente de produção seria: GET https://api.anbima.com.br/feed/precos-indices/v1/indices-mais/carteira-teorica-ihfa.

    Para especificar mês e ano na consulta, deve-se realizar a chamada informando os parâmetros, conforme o exemplo: GET https://api.anbima.com.br/feed/precos-indices/v1/indices-mais/carteira-teorica-ihfa?MM=01&AAAA=2019.

    IHFA resultados e componentes

    Esta API retorna resultados e composição do IHFA. Se uma data não for especificada, serão retornados os registros da data mais recente disponível.

    Para acessá-la, deve-se utilizar a seguinte URI: https://<ambiente>/feed/precos-indices/v1/indices-mais/resultados-ihfa.

    O método utilizado para acesso aos recursos deve ser o GET, pois nossa API é exclusivamente utilizada para consultas a informações. Um exemplo de chamada real em ambiente de produção seria: GET https://api.anbima.com.br/feed/precos-indices/v1/indices-mais/resultados-ihfa.

    Para especificar uma data na consulta, deve-se realizar a chamada informando o parâmetro, conforme o exemplo: GET https://api.anbima.com.br/feed/precos-indices/v1/indices-mais/resultados-ihfa?data=AAAA-MM-DD.

    IDKA resultados

    Esta API retorna resultados diários dos índices da família IDKA. Se uma data não for especificada, serão retornados os registros da data mais recente disponível.

    Para acessá-la, deve-se utilizar a seguinte URI: https://<ambiente>/feed/precos-indices/v1/indices-mais/resultados-idka.

    O método utilizado para acesso aos recursos deve ser o GET, pois nossa API é exclusivamente utilizada para consultas a informações. Um exemplo de chamada real em ambiente de produção seria: GET https://api.anbima.com.br/feed/precos-indices/v1/indices-mais/resultados-idka.

    Para especificar uma data na consulta, deve-se realizar a chamada informando o parâmetro, conforme o exemplo: GET https://api.anbima.com.br/feed/precos-indices/v1/indices-mais/resultados-idka?data=AAAA-MM-DD.

    PU Intradiário

    Esta API retorna preços intradiários dos componentes do IRF-M, IMA-B e respectivos subíndices por faixa de prazos. Se uma data não for especificada, serão retornados os registros da data mais recente disponível.

    Para acessá-la, deve-se utilizar a seguinte URI: https://<ambiente>/feed/precos-indices/v1/indices-mais/pu-intradiario.

    O método utilizado para acesso aos recursos deve ser o GET, pois nossa API é exclusivamente utilizada para consultas a informações. Um exemplo de chamada real em ambiente de produção seria: GET https://api.anbima.com.br/feed/precos-indices/v1/indices-mais/pu-intradiario.

    Para especificar uma data na consulta, deve-se realizar a chamada informando o parâmetro, conforme o exemplo: GET https://api.anbima.com.br/feed/precos-indices/v1/indices-mais/pu-intradiario?data=AAAA-MM-DD.

    Resultados Intradiários IMA

    Esta API retorna resultados intradiários dos componentes do IRF-M, IMA-B e respectivos subíndices por faixa de prazos. Se uma data não for especificada, serão retornados os registros da data mais recente disponível.

    Para acessá-la, deve-se utilizar a seguinte URI: https://<ambiente>/feed/precos-indices/v1/indices-mais/resultados-intradiarios-ima.

    O método utilizado para acesso aos recursos deve ser o GET, pois nossa API é exclusivamente utilizada para consultas a informações. Um exemplo de chamada real em ambiente de produção seria: GET https://api.anbima.com.br/feed/precos-indices/v1/indices-mais/resultados-intradiarios-ima.

    Para especificar uma data na consulta, deve-se realizar a chamada informando o parâmetro, conforme o exemplo: GET https://api.anbima.com.br/feed/precos-indices/v1/indices-mais/resultados-intradiarios-ima?data=AAAA-MM-DD.

    IMA Resultados e Componentes

    Esta API retorna resultados e composição dos índices da família IMA. Se uma data não for especificada, serão retornados os registros da data mais recente disponível.

    Para acessá-la, deve-se utilizar a seguinte URI: https://<ambiente>/feed/precos-indices/v1/indices-mais/resultados-ima.

    O método utilizado para acesso aos recursos deve ser o GET, pois nossa API é exclusivamente utilizada para consultas a informações. Um exemplo de chamada real em ambiente de produção seria: GET https://api.anbima.com.br/feed/precos-indices/v1/indices-mais/resultados-ima.

    Para especificar uma data na consulta, deve-se realizar a chamada informando o parâmetro, conforme o exemplo: GET https://api.anbima.com.br/feed/precos-indices/v1/indices-mais/resultados-ima?data=AAAA-MM-DD.

    IMA carteira teórica

    Esta API retorna informações relativas aos dados referentes à carteira teórica dos índices da família IMA. Se mês e ano não forem especificados, serão retornados os registros do mês e ano mais recentes disponíveis.

    Para acessá-la, deve-se utilizar a seguinte URI: https://<ambiente>/feed/precos-indices/v1/indices-mais/carteira-teorica-ima.

    O método utilizado para acesso aos recursos deve ser o GET, pois nossa API é exclusivamente utilizada para consultas a informações. Um exemplo de chamada real em ambiente de produção seria: GET https://api.anbima.com.br/feed/precos-indices/v1/indices-mais/carteira-teorica-ima.

    Para especificar mês e ano na consulta, deve-se realizar a chamada informando os parâmetros, conforme o exemplo: GET https://api.anbima.com.br/feed/precos-indices/v1/indices-mais/carteira-teorica-ima?MM=01&AAAA=2019.

    Índices

    IDA carteira teórica

    Esta API retorna informações relativas aos dados referentes às composições das carteiras teóricas mensais dos índices da família IDA. Se mês e ano não forem especificados, serão retornados os registros do mês e ano mais recentes disponíveis.

    Para acessá-la, deve-se utilizar a seguinte URI: https://<ambiente>/feed/precos-indices/v1/indices/carteira-teorica-ida.

    O método utilizado para acesso aos recursos deve ser o GET, pois nossa API é exclusivamente utilizada para consultas a informações. Um exemplo de chamada real em ambiente de produção seria: GET https://api.anbima.com.br/feed/precos-indices/v1/indices/carteira-teorica-ida.

    Para especificar mês e ano na consulta, deve-se realizar a chamada informando os parâmetros, conforme o exemplo: GET https://api.anbima.com.br/feed/precos-indices/v1/indices/carteira-teorica-ida?MM=01&AAAA=2019.

    IDA resultados

    Esta API retorna resultados e composição do IDA. Se uma data não for especificada, serão retornados os registros da data mais recente disponível.

    Para acessá-la, deve-se utilizar a seguinte URI: https://<ambiente>/feed/precos-indices/v1/indices/resultados-ida-fechado.

    O método utilizado para acesso aos recursos deve ser o GET, pois nossa API é exclusivamente utilizada para consultas a informações. Um exemplo de chamada real em ambiente de produção seria: GET https://api.anbima.com.br/feed/precos-indices/v1/indices/resultados-ida-fechado.

    Para especificar uma data na consulta, deve-se realizar a chamada informando o parâmetro, conforme o exemplo: GET https://api.anbima.com.br/feed/precos-indices/v1/indices/resultados-ida-fechado?data=AAAA-MM-DD.

    IHFA carteira teórica

    Esta API retorna dados da composição da carteira teórica do IHFA. Se mês e ano não forem especificados, serão retornados os registros do mês e ano mais recentes disponíveis.

    Para acessá-la, deve-se utilizar a seguinte URI: https://<ambiente>/feed/precos-indices/v1/indices/carteira-teorica-ihfa.

    O método utilizado para acesso aos recursos deve ser o GET, pois nossa API é exclusivamente utilizada para consultas a informações. Um exemplo de chamada real em ambiente de produção seria: GET https://api.anbima.com.br/feed/precos-indices/v1/indices/carteira-teorica-ihfa.

    Para especificar mês e ano na consulta, deve-se realizar a chamada informando os parâmetros, conforme o exemplo: GET https://api.anbima.com.br/feed/precos-indices/v1/indices/carteira-teorica-ihfa?MM=01&AAAA=2019.

    IHFA resultados

    Esta API retorna resultados diários do IHFA. Se uma data não for especificada, serão retornados os registros da data mais recente disponível.

    Para acessá-la, deve-se utilizar a seguinte URI: https://<ambiente>/feed/precos-indices/v1/indices/resultados-ihfa-fechado.

    O método utilizado para acesso aos recursos deve ser o GET, pois nossa API é exclusivamente utilizada para consultas a informações. Um exemplo de chamada real em ambiente de produção seria: GET https://api.anbima.com.br/feed/precos-indices/v1/indices/resultados-ihfa-fechado.

    Para especificar uma data na consulta, deve-se realizar a chamada informando o parâmetro, conforme o exemplo: GET https://api.anbima.com.br/feed/precos-indices/v1/indices/resultados-ihfa-fechado?data=AAAA-MM-DD.

    IDKA resultados

    Esta API retorna resultados diários dos índices IDKA. Se uma data não for especificada, serão retornados os registros da data mais recente disponível.

    Para acessá-la, deve-se utilizar a seguinte URI: https://<ambiente>/feed/precos-indices/v1/indices/resultados-idka.

    O método utilizado para acesso aos recursos deve ser o GET, pois nossa API é exclusivamente utilizada para consultas a informações. Um exemplo de chamada real em ambiente de produção seria: GET https://api.anbima.com.br/feed/precos-indices/v1/indices/resultados-idka.

    Para especificar uma data na consulta, deve-se realizar a chamada informando o parâmetro, conforme o exemplo: GET https://api.anbima.com.br/feed/precos-indices/v1/indices/resultados-idka?data=AAAA-MM-DD.

    IMA resultados intradiários

    Esta API retorna resultados diários dos índices IDKA. Se uma data não for especificada, serão retornados os registros da data mais recente disponível.

    Para acessá-la, deve-se utilizar a seguinte URI: https://<ambiente>/feed/precos-indices/v1/indices/resultados-intradiarios-ima.

    O método utilizado para acesso aos recursos deve ser o GET, pois nossa API é exclusivamente utilizada para consultas a informações. Um exemplo de chamada real em ambiente de produção seria: GET https://api.anbima.com.br/feed/precos-indices/v1/indices/resultados-intradiarios-ima.

    Para especificar uma data na consulta, deve-se realizar a chamada informando o parâmetro, conforme o exemplo: GET https://api.anbima.com.br/feed/precos-indices/v1/indices/resultados-intradiarios-ima?data=AAAA-MM-DD.

    IMA resultados

    Esta API retorna resultados diários dos índices da família IMA. Se uma data não for especificada, serão retornados os registros da data mais recente disponível.

    Para acessá-la, deve-se utilizar a seguinte URI: https://<ambiente>/feed/precos-indices/v1/indices/resultados-ima.

    O método utilizado para acesso aos recursos deve ser o GET, pois nossa API é exclusivamente utilizada para consultas a informações. Um exemplo de chamada real em ambiente de produção seria: GET https://api.anbima.com.br/feed/precos-indices/v1/indices/resultados-ima.

    Para especificar uma data na consulta, deve-se realizar a chamada informando o parâmetro, conforme o exemplo: GET https://api.anbima.com.br/feed/precos-indices/v1/indices/resultados-ima?data=AAAA-MM-DD.

    IMA carteira teórica

    Esta API retorna dados da composição da carteira teórica dos índices da família IMA. Se mês e ano não forem especificados, serão retornados os registros do mês e ano mais recentes disponíveis.

    Para acessá-la, deve-se utilizar a seguinte URI: https://<ambiente>/feed/precos-indices/v1/indices/carteira-teorica-ima.

    O método utilizado para acesso aos recursos deve ser o GET, pois nossa API é exclusivamente utilizada para consultas a informações. Um exemplo de chamada real em ambiente de produção seria: GET https://api.anbima.com.br/feed/precos-indices/v1/indices/carteira-teorica-ima.

    Para especificar mês e ano na consulta, deve-se realizar a chamada informando os parâmetros, conforme o exemplo: GET https://api.anbima.com.br/feed/precos-indices/v1/indices/carteira-teorica-ima?MM=01&AAAA=2019.

    Certificados de Recebíveis (CRI e CRA)

    Mercado Secundário

    Esta API retorna registros de mercado secundário correspondentes aos CRIs e CRAs presentes na base ANBIMA. Se uma data não for especificada, serão retornados os registros da data mais recente disponível.

    Para acessá-la, deve-se utilizar a seguinte URI: https://<ambiente>/feed/precos-indices/v1/cri-cra/mercado-secundario.

    O método utilizado para acesso aos recursos deve ser o GET, pois nossa API é exclusivamente utilizada para consultas a informações. Um exemplo de chamada real em ambiente de produção seria: GET https://api.anbima.com.br/feed/precos-indices/v1/cri-cra/mercado-secundario.

    Para especificar uma data na consulta, deve-se realizar a chamada informando o parâmetro, conforme o exemplo: GET https://api.anbima.com.br/feed/precos-indices/v1/cri-cra/mercado-secundario?data=AAAA-MM-DD.

    Projeções IPCA e IGP-M

    Esta API retorna informações relativas às apurações das projeções para o IGP-M e IPCA cujos registros são do mês e ano de referência. Se mês e ano não forem especificados, serão retornados os registros do mês e ano mais recentes disponíveis.

    Para acessá-la, deve-se utilizar a seguinte URI: https://<ambiente>/feed/precos-indices/v1/cri-cra/projecoes.

    O método utilizado para acesso aos recursos deve ser o GET, pois nossa API é exclusivamente utilizada para consultas a informações. Um exemplo de chamada real em ambiente de produção seria: GET https://api.anbima.com.br/feed/precos-indices/v1/cri-cra/projecoes.

    Para especificar mês e ano na consulta, deve-se realizar a chamada informando os parâmetros, conforme o exemplo: GET https://api.anbima.com.br/feed/precos-indices/v1/cri-cra/projecoes?MM=01&AAAA=2019.

    3. Requisições às APIs

    Para as requisições a estas APIs é necessária a combinação dos seguintes componentes: método (ou verbo) HTTP e URI do recurso. Todas as chamadas a recursos das APIs consideram a seguinte estrutura:

    GET https://<ambiente>/feed/precos-indices/v1/<pacote>/<recurso>/<parâmetros>, sendo que a lista de recursos disponíveis encontram-se disponíveis no seguinte Swagger (acesso restrito).

    Códigos de erro retornados pelo serviço RESTFul:

    Código HTTP Descrição
    400 Requisição malformada. Por favor, verifique a URL da requisição e os parâmetros informados
    401 Requisição não foi devidamente autenticada. Os valores informados de client_id e/ou access_token não são válidos.
    403 Credenciais informadas não possuem permissão de acesso ao recurso requisitado.
    404 Dados não existentes ou não disponíveis para a requisição e parâmetros
    5XX Erro interno inesperado no servidor

    Códigos de sucesso

    Código HTTP Descrição
    200 Consulta com sucesso. Dados disponíveis e informados no body da resposta.

    4. Notificações via API

    O ANBIMA Feed possui recursos que permitem que os clientes sejam acionados com notificações em algumas situações, por exemplo quando existirem novas informações disponíveis em um determinado contexto, ou quando houver atraso para a disponibilização de determinadas informações. Para que este mecanismo funcione corretamente, é necessário que o cliente exponha uma API RESTFul para que o ANBIMA Feed possa fazer os respectivos acionamentos, e a API deverá ser implementada de acordo com a especificação abaixo:

    Método: POST
    URI: definida pelo cliente e informada à ANBIMA para cadastro (ex. https://endpoint-cliente.com/recurso-cliente/)
    Body:

    
     {
       "tipo_evento": "string",
       "nome_pacote": "string",
       "nome_item": "string",
       "descricao": "string",
       "data_referencia": "string"
     }
    

    Autenticação: É necessário que o tipo de autenticação seja a "Basic Authentication", conforme especificado em https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Authorization

    A seguir, veja a descrição dos campos que seriam enviados no body da chamada:

    Nome campo Descrição
    tipo_evento Tipo do evento de notificação (ex. NOVO, ATRASO, ATUALIZACAO). Esta informação refere-se ao tipo do evento que gerou a notificação, por ex: novos dados de Pacote/Item disponibilizados pela API.
    nome_pacote O nome do pacote para o qual foi gerada a notificação
    nome_item O nome do item do pacote para o qual foi gerada a notificação
    descricao Texto descritivo da notificação
    data_referencia A data de referência dos dados disponibilizados

    Intruções de como devem ser tratados os diferentes tipos de evento:

    • NOVO - Dados disponibilizados para o Pacote/Item e Data de Referência informados
      ATUALIZACAO - Dados corrigidos para o Pacote/Item e Data de Referência informados. Os dados que haviam sido armazenados anteriormente para este Pacote/Item e Data de Referência devem ser excluídos e substituídos pelos disponibilizados após a notificação deste tipo.
      ATRASO - Os dados de Pacote/Item e Data de Referência informados estão em atraso na sua geração.
  • Caminho das APIs

    Quando o ANBIMA Feed envia uma notificação, ele já possui novos dados para divulgar. Assim, logo após receber uma mensagem de notificação, seu sistema já poderá requisitar estes dados, invocando uma de nossas APIs.
    O quadro abaixo resume quais APIs devem ser chamadas para solicitar a atualização de dados para cada API do ANBIMA Feed:

    Pacote Item Caminho
    DEBENTURES MERCADO_SECUNDARIO_DEBENTURES debentures/mercado-secundario
    DEBENTURES CURVAS_CREDITO debentures/curvas-credito
    DEBENTURES PROJECAO_IPCA_IGPM debentures/projecoes
    INDICES CARTEIRA_TEORICA_IDA indices/carteira-teorica-ida
    INDICES CARTEIRA_TEORICA_IHFA indices/carteira-teorica-ihfa
    INDICES CARTEIRA_TEORICA_IMA indices/carteira-teorica-ima
    INDICES RESULTADOS_IHFA indices/resultados-ihfa-fechado
    INDICES RESULTADOS_IDKA indices/resultados-idka
    INDICES RESULTADOS_IMA indices/resultados-ima
    INDICES RESULTADOS_IDA indices/resultados-ida-fechado
    INDICES RESULTADO_INTRADIARIO indices/resultados-intradiarios-ima
    INDICES_MAIS CARTEIRA_TEORICA_IDA indices-mais/carteira-teorica-ida
    INDICES_MAIS CARTEIRA_TEORICA_IHFA indices-mais/carteira-teorica-ihfa
    INDICES_MAIS CARTEIRA_TEORICA_IMA indices-mais/carteira-teorica-ima
    INDICES_MAIS RESULTADOS_IDKA indices-mais/resultados-idka
    INDICES_MAIS RESULTADOS_COMPONENTE_IDA indices-mais/resultados-ida
    INDICES_MAIS RESULTADOS_COMPONENTE_IHFA indices-mais/resultados-ihfa
    INDICES_MAIS RESULTADOS_COMPONENTE_IMA indices-mais/resultados-ima
    INDICES_MAIS PU_INTRADIARIO indices-mais/pu-intradiario
    INDICES_MAIS RESULTADO_INTRADIARIO indices-mais/resultados-intradiarios-ima
    TITULOS_PUBLICOS PU_INTRADIARIO titulos-publicos/pu-intradiario
    TITULOS_PUBLICOS MERCADO_SECUNDARIO_TPF titulos-publicos/mercado-secundario-TPF
    TITULOS_PUBLICOS VNA titulos-publicos/vna
    TITULOS_PUBLICOS CURVAS_JUROS titulos-publicos/curvas-juros
    TITULOS_PUBLICOS DIFUSAO_TAXAS titulos-publicos/difusao-taxas
    TITULOS_PUBLICOS CURVA_INTRADIARIA titulos-publicos/curva-intradiaria
    TITULOS_PUBLICOS PROJECAO_IPCA_IGPM titulos-publicos/projecoes
    TITULOS_PUBLICOS ESTIMATIVA_SELIC titulos-publicos/estimativa-selic
    CRI_CRA PROJECAO_IPCA_IGPM cri-cra/projecoes
    CRI_CRA MERCADO_SECUNDARIO_CRICRA cri-cra/mercado-secundario
    Códigos de resposta

    Códigos de erro esperado no serviço RESTFul

    Código HTTP Descrição
    400 Requisição mal formada. Por favor, verificar a url da requisição.
    401 Requisição requer autenticação. Provavelmente o "código base64" enviado pela ANBIMA pode ter sido criado com credenciais inválidas, ou pode estar ausente no header da chamada.
    405 Método não permitido. O método da chamada deve ser POST, por favor, verificar.
    406 Conteúdo ou Content-Type inválido. Por favor verificar o conteúdo enviado no Body da chamada (esperamos um json contendo os campos referentes à notificação ).
    5XX Erro interno inesperado no servidor

    Códigos de sucesso

    Código HTTP Descrição
    200 Notificação recebida com sucesso.