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

# Consultar carteira de operações

`GET /trades`

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.net/btgpactual/apis/folha-de-pagamentos.md) · [All operations](https://skmtc.net/btgpactual/apis/folha-de-pagamentos/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/btgpactual/folha-de-pagamentos/revisions/2a24d3da114c/schema)