# Exchanges

Uma troca é uma operação de câmbio na Rede de Open Finance do Brasil. O recurso contém detalhes das operações de câmbio, incluindo taxas de câmbio, valores em moedas locais e estrangeiras, e informações de liquidação. Cada operação de câmbio pode ter eventos históricos associados que registram quaisquer modificações no contrato original.

## Listar exchanges

 - [GET /api/br/exchanges/](https://developers.belvo.com/pt-br/apis/belvoopenapispec/exchanges/listexchanges.md): {% admonition type="warning" name="Em Breve" %}
  Este endpoint está atualmente em desenvolvimento. Portanto, pequenas alterações ou bugs podem ocorrer. Se você encontrar algum problema, entre em contato com seu representante da Belvo.
{% /admonition %}

## ▶️ Uso

Com o método List Exchanges, você pode:
  
  1. [Obrigatório] Listar exchanges relacionadas a um link.id específico (usando o parâmetro de consulta link).
  2. Obter os detalhes de um exchange.id específico (usando o parâmetro de consulta id).

## 🔦 Filtrando Respostas

Consulte a lista de consultas abaixo para ver uma lista de campos pelos quais você pode filtrar suas respostas. Para mais informações sobre como usar filtros, veja nosso artigo Filtrando respostas.

## 📖 Paginação

Este método retorna uma resposta paginada (padrão: 100 itens por página). Você pode usar o parâmetro de consulta page_size para aumentar o número de itens retornados até um máximo de 1000 itens. Você pode usar o parâmetro de consulta page para navegar pelos resultados. Para mais detalhes sobre como navegar pelas respostas paginadas da Belvo, veja nosso artigo Dicas de Paginação.

## Recuperar trocas para um link

 - [POST /api/br/exchanges/](https://developers.belvo.com/pt-br/apis/belvoopenapispec/exchanges/retrieveexchanges.md): {% admonition type="warning" name="Em Breve" %}
  Este endpoint está atualmente em desenvolvimento. Portanto, pequenas alterações ou bugs podem ocorrer. Se você encontrar algum problema, entre em contato com seu representante da Belvo.
{% /admonition %}

Recupere operações de câmbio para um link existente. Por padrão, recuperamos dados de câmbio dos últimos 365 dias.

> Nota: Quando você recupera câmbios, nós automaticamente recuperamos o histórico de câmbio para cada operação de câmbio encontrada.

## Obter os detalhes de uma exchange

 - [GET /api/br/exchanges/{id}/](https://developers.belvo.com/pt-br/apis/belvoopenapispec/exchanges/detailexchange.md): {% admonition type="warning" name="Em Breve" %}
  Este endpoint está atualmente em desenvolvimento. Portanto, pequenas alterações ou bugs podem ocorrer. Se você encontrar algum problema, entre em contato com seu representante da Belvo.
{% /admonition %}

Obtenha os detalhes de uma exchange específica.

> Nota: Quando você exclui uma exchange, todos os registros de histórico associados a ela também são excluídos.

## Excluir uma exchange

 - [DELETE /api/br/exchanges/{id}/](https://developers.belvo.com/pt-br/apis/belvoopenapispec/exchanges/deleteexchange.md): {% admonition type="warning" name="Em Breve" %}
  Este endpoint está atualmente em desenvolvimento. Portanto, pequenas alterações ou bugs podem ocorrer. Se você encontrar algum problema, entre em contato com seu representante Belvo.
{% /admonition %}

Exclua uma exchange específica da sua conta Belvo.

> Nota: Quando você exclui uma exchange, todos os registros de histórico associados a ela também são excluídos.

## Listar o histórico de troca para uma troca específica

 - [GET /api/br/exchanges/{id}/history/](https://developers.belvo.com/pt-br/apis/belvoopenapispec/exchanges/listexchangehistory.md): {% admonition type="warning" name="Em Breve" %}
  Este endpoint está atualmente em desenvolvimento. Portanto, pequenas alterações ou bugs podem ocorrer. Se você encontrar algum problema, entre em contato com seu representante da Belvo.
{% /admonition %}

Obtenha o histórico de modificações (trilha de auditoria) para uma operação de câmbio específica.

## 📖 Paginação

Este método retorna uma resposta paginada (padrão: 100 itens por página). Você pode usar o parâmetro de consulta page_size para aumentar o número de itens retornados até um máximo de 1000 itens. Você pode usar o parâmetro de consulta page para navegar pelos resultados. Para mais detalhes sobre como navegar pelas respostas paginadas da Belvo, consulte nosso artigo Dicas de Paginação.