---
title: "Consultar carteira de operações"
method: GET
path: "/trades"
tags: ["Trade"]
---

# Consultar carteira de operações

`GET /trades`

## Request

- Base URL: `https://api.sandbox.empresas.btgpactual.com`
- URL: `https://api.sandbox.empresas.btgpactual.com/trades`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://id.btgpactual.com/oauth2/token` scopes: `empresas.btgpactual.com/scf/trades`, `empresas.btgpactual.com/scf/trades.readonly`

Esta rota serve para consultar a carteira de operações. É obrigatorio o envio das informações do cursor ou do status ou dos tradeIds.

## Query parameters

- `status` 'Aberto' | 'EmAgendamento' | 'Agendado' | 'EmAprovacao' | 'Aprovado' | 'EmAntecipacao' | 'Antecipado' | 'Liquidado' | 'Cancelado' | 'EmAtraso' | 'Indisponivel' | 'Pago' | 'EmCancelamento': Status do trade
- `tradeIds` string
- `payerTaxId` string: CNPJ/CPF
- `payeeTaxId` string: CNPJ/CPF
- `cursor` string: Referência do cursor
- `limit` integer: Limite de registros por paginação

## Response `200`

Sucesso

- TradeWalletSchema
  - `trades` TradeSchema[]
    - `id` string: Identificador do trade
    - `maturityDate` string, date: Data de vencimento
    - `contractNumber` string: Número de contrato do trade
    - `status` 'Aberto' | 'EmAgendamento' | 'Agendado' | 'EmAprovacao' | 'Aprovado' | 'EmAntecipacao' | 'Antecipado' | 'Liquidado' | 'Cancelado' | 'EmAtraso' | 'Indisponivel' | 'Pago' | 'EmCancelamento': Status do trade
    - `balance` object
      - `principal` number, double: Valor de principal da operação
      - `interestArrears` number, double: Valor de mora
      - `penaltyFee` number, double: Valor de multa
      - `latePaymentFee` number, double: Valor de juros
  - `_links` object
    - `next` NextCursorSchema
      - `href` string: Link para a pesquisa da proxima pagina
      - `method` 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'HEAD' | 'OPTIONS': Método do protocolo HTTP

## Other responses

- `400`: Erro de validação
- `401`: Não autorizado
- `default`: Erro

---

[API](https://skmtc.dev/btgpactual/apis/folha-de-pagamentos.md) - [All operations](https://skmtc.dev/btgpactual/apis/folha-de-pagamentos/llms.txt) - [OpenAPI document](https://skmtc.dev/btgpactual/apis/folha-de-pagamentos/revisions/2a24d3da114c?raw)
