Ranking do VET

URL: https://www3.bcb.gov.br/vet/rest/v2/ranking?mesAno=022017&valor=100&moeda=USD&finalidade=1&tipoOperacao=C&formaDeEntrega=1

Retorna uma relação de instituições com o VET médio praticado em operações que se enquadrem nos parâmetros informados.

Parâmetros:

  • mesAno: mês e ano de ocorrência das operações a serem consideradas na montagem do ranking. Formato - MMAAA: um inteiro de 2 dígitos para o mês, MM, e um inteiro de 4 dígitos para o ano AAAA. Exemplo: 012017;
  • valor: este valor será utilizado para determinar em que faixa de valores estarão as operações consideradas na montagem do ranking. Formato: numérico com duas casas decimais (separador decimal: "."). Exemplo: 150.10;
  • moeda: código da moeda das operações a serem consideradas na montagem do ranking. Formato - MMM: três letras. Exemplo: USD. As moedas com respectivos códigos existentes para a formação do ranking podem ser consultadas no recurso "Moedas", deste mesmo conjunto de dados;
  • finalidade: código da finalidade das operações a serem consideradas na montagem do ranking. Formato: um dígito numérico. Exemplo: 1. As finalidades com respectivos códigos existentes para a formação do ranking podem ser consultadas no recurso "Finalidades das operações de câmbio", deste mesmo conjunto de dados;
  • tipoOperacao: tipo das operações a serem consideradas na montagem do ranking. Formato: uma letra. Existem dois tipos disponíveis: C para Compra ou V para Venda.
  • formaDeEntrega: código da forma de entrega da moeda das operações a serem consideradas na montagem do ranking. Formato: um dígito numérico. Este parâmetro deve ser informado quando a finalidade das operações for 1 - Viagens Internacionais. As formas de entrega com respectivos códigos existentes para a formação do ranking podem ser consultadas no recurso "Formas de entrega da moeda estrangeira", deste mesmo conjunto de dados; e
  • pais: país de destino dos recursos das operações a serem consideradas na montagem do ranking. Formato - PP: duas letras. Exemplo: US. Este parâmetro deve ser informado quando a finalidade das operações for 2 - Transferências pessoais. Os países com respectivos códigos existentes para a formação do ranking podem ser consultados no recurso "Países de destino", deste mesmo conjunto de dados;

Campos de retorno do serviço:

  • codIf: CNPJ base (8 dígitos) da instituição autorizada a operar no mercado de câmbio;
  • nomeIf: nome da instituição;
  • numOperacoes: número de operações encontradas para a instituição de acordo com os parâmetros informados;
  • vet: valor efetivo total (vet) médio das operações consideradas. O tipo de retorno deste campo é numérico com 4 casas decimais, sem separador. Desta forma, deve ser dividido por 10.000;
  • valorSimulado: valor da operação sendo simulada calculado com base no parâmetro valor e no vet médio das operações consideradas. O tipo de retorno deste campo é numérico com 4 casas decimais, sem separador. Desta forma, deve ser dividido por 10.000; e
  • diferenca: número que determina a diferença entre o valor simulado deste registro em relação ao valor simulado do registro da primeira instituição do ranking. Desta forma, o valor do campo diferença para a instituição em primeiro no ranking é sempre 0.

Não há visões criadas para este recurso ainda.

Informações Adicionais

Campo Valor
Última atualização 30/Março/2017
Criado 30/Março/2017
Formato JSON
Licença Licença Aberta para Bases de Dados (ODbL) do Open Data Commons
createdhá 2 meses
formatJSON
idfceb44a9-0005-4ac4-9985-4705e0ee4b3d
package id3c89c0c6-78a0-4587-972f-548aa082061c
revision id2e2d7dfb-c812-4ac0-ab9f-aec60ebc379c
stateactive