Trade

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

post

Body

application/json

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

HTTPcURLJavaScriptPython

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
}