DataBolsa docs
Referência da APIExtensõesAdvisorCarteiras

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.

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

Authorization

AuthorizationBearer <token>

In: header

Path Parameters

orgstring

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

portfolioIdstring

Id da carteira do cliente (de advisorListClientPortfolios).

Request Body

asset_typestring

Tipo do ativo: acao, fii, etf, bdr, tesouro, renda_fixa, debenture, fund, us, crypto.

Length2 <= length
symbolstring

Ticker (PETR4), nome oficial do título do Tesouro, código do papel (ELTN17) ou CNPJ da classe do fundo.

Length1 <= length
note?string | null

Observação livre.

meta?unknown

Metadados livres do escritório (JSON).

Response Body

curl -X POST "https://api.databolsa.com/v1/advisor/orgs/string/portfolios/string/assets" \  -H "Content-Type: application/json" \  -d '{    "asset_type": "string",    "symbol": "string"  }'
{
  "id": "string",
  "asset_type": "string",
  "symbol": "string",
  "note": "string"
}
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "code": "string"
}

Atualizar objetivos/restrições/contexto do cliente

O perfil é o contexto que agente, MCP e relatórios leem. Histórico via trilha de auditoria.

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.