DataBolsa docs
Referência da APIExtensõesAdvisorCarteiras

Lançar transação no ledger do ativo

Lança compra, venda ou split no ledger do ativo. `buy`/`sell` exigem `quantity` (e `price` quando conhecido); `split` usa `ratio` (2 = 2:1). `external_id` torna o lançamento idempotente.

POST
/v1/advisor/orgs/{org}/portfolios/{portfolioId}/assets/{assetId}/transactions

Authorization

AuthorizationBearer <token>

In: header

Path Parameters

orgstring

Id ou slug da organização (de advisorGetMe).

portfolioIdstring

Id da carteira do cliente (de advisorListClientPortfolios).

assetIdstring

Id do ativo na carteira (de advisorGetClientPortfolioLedger).

Request Body

kindstring

buy, sell ou split.

Value in"buy" | "sell" | "split"
trade_datestring

Data do negócio (AAAA-MM-DD).

Match^\d{4}-\d{2}-\d{2}$
quantitynumber

Quantidade (> 0).

price?number | null

Preço unitário na moeda da carteira; omita se desconhecido.

fees?number

Custos e corretagem (default 0).

ratio?number | null

Fator do split (2 = 2:1; 0.5 = grupamento 1:2).

note?string | null

Observação livre.

external_id?string | null

Id externo do lançamento; repetir o mesmo id não duplica.

Response Body

curl -X POST "https://api.databolsa.com/v1/advisor/orgs/string/portfolios/string/assets/string/transactions" \  -H "Content-Type: application/json" \  -d '{    "kind": "buy",    "trade_date": "string",    "quantity": 0  }'
{
  "id": "string",
  "kind": "string",
  "trade_date": "string",
  "quantity": 0,
  "price": 0,
  "fees": 0,
  "ratio": 0,
  "note": "string",
  "external_id": "string"
}
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "code": "string"
}

Adicionar ativo à carteira

Adiciona um ativo à carteira do cliente sem lançamentos (funciona como watchlist até o primeiro). `asset_type` e `symbol` seguem o vocabulário da Wallet: acao/PETR4, fii/HGLG11, tesouro/nome oficial do título, fund/CNPJ da classe.

Criar carteira para um cliente

`kind: proposal` marca estudo/realocação — fica fora do consolidado do cliente.