---
title: "Consultar a posição de um trade especifico"
method: GET
path: "/trades/{tradeId}"
tags: ["Trade"]
---

# Consultar a posição de um trade especifico

`GET /trades/{tradeId}`

## Request

- Base URL: `https://api.sandbox.empresas.btgpactual.com`
- URL: `https://api.sandbox.empresas.btgpactual.com/trades/{tradeId}`
- 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`

O objetivo dessa rota é pesquisar a posição de uma operação especifica realizada anteriormente.

## Path parameters

- `tradeId` string, required: Identificador

## Response `200`

Sucesso na consulta de posição de trade.

- 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

## Other responses

- `400`: Erro de validação
- `401`: Não autorizado
- `404`: Trade com esse 'tradeId' não encontrado.
- `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)
