Trade

Cria uma operação de compra e venda de título.

post
Body

Uma operação de compra e venda. Apenas instituições financeiras possuem cnpj8, se for uma oferta para para um cliente, é necessário utilizar o endereço da carteira.

operationIdintegerRequired

Número de operação + data vigente no formato yyyyMMdd.

Example: 12320231003
cnpj8SenderintegerOptional

CNPJ8 do vendedor.

Example: 12345678
cnpj8ReceiverintegerOptional

CNPJ8 do comprador.

Example: 12345678
callerPartstring · enumRequired

ENUM para identificar se comprador ou vendedor. * TPFTSender caso for vendedor. * TPFtReceiver caso for comprador.

Possible values:
addressSenderstringOptional

A carteira do vendedor.

Example: 0xe69d9b02e31da15cf78184078e250633b69753cc
addressReceiverstringOptional

A carteira do comprador.

Example: 0xe69d9b02e31da15cf78184078e250633b69753cc
amountnumber · doubleRequired

Quantidade de títulos.

Example: 123.45
unitPricenumber · doubleRequired

Preço, real digital, da operação.

Example: 123.45
Responses
200

Successful operation

application/json
post
/tpft/trade
POST /v2/tpft/trade HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 340

{
  "operationId": 12320231003,
  "cnpj8Sender": 12345678,
  "cnpj8Receiver": 12345678,
  "callerPart": "TPFtSender",
  "addressSender": "0xe69d9b02e31da15cf78184078e250633b69753cc",
  "addressReceiver": "0xe69d9b02e31da15cf78184078e250633b69753cc",
  "tpftData": {
    "acronym": "Meu titulo",
    "code": "123009",
    "maturityDate": "12/12/2025"
  },
  "amount": 123.45,
  "unitPrice": 123.45
}
200

Successful operation

{
  "operationId": 12320231003,
  "cnpj8Sender": 12345678,
  "cnpj8Receiver": 12345678,
  "callerPart": "TPFtSender",
  "addressSender": "0xe69d9b02e31da15cf78184078e250633b69753cc",
  "addressReceiver": "0xe69d9b02e31da15cf78184078e250633b69753cc",
  "tpftData": {
    "acronym": "Meu titulo",
    "code": "123009",
    "maturityDate": "12/12/2025"
  },
  "amount": 123.45,
  "unitPrice": 123.45
}