DataBolsa docs
Referência da APIExtensõesWalletCarteiras

Lançar transação

Lança uma transação na carteira real do dono da chave; ativo ausente é adicionado automaticamente. buy/sell exigem `quantity`; `price` é opcional; split usa `ratio` (2 = 2:1). Confirme os valores com o usuário.

POST
/v1/portfolios/{id}/transactions

Authorization

AuthorizationBearer <token>

In: header

Path Parameters

idstring

Id da carteira.

Request Body

entity_id?string

O objeto do grafo (pub_…). Dispensa asset_type/symbol.

asset_type?string

Tipo do ativo (com symbol; dispensável com entity_id).

Value in"stock" | "fii" | "etf" | "bdr" | "index" | "tesouro" | "crypto" | "option" | "renda_fixa" | "debenture" | "fund" | "us"
symbol?string

Ticker (ex.: PETR4) ou nome oficial do título do Tesouro (com asset_type; dispensável com entity_id).

kindstring

Tipo da transação.

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

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

quantity?number

Quantidade (> 0; obrigatória em buy/sell).

price?number

Preço unitário em BRL (omita se desconhecido).

fees?number

Custos/corretagem em BRL (default 0).

ratio?number

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

note?string

Observação livre (até 280 caracteres).

Response Body

curl -X POST "https://api.databolsa.com/v1/portfolios/string/transactions" \  -H "Content-Type: application/json" \  -d '{    "kind": "buy",    "trade_date": "string"  }'
{
  "transaction": {
    "id": "string",
    "kind": "string",
    "trade_date": "string",
    "quantity": 0,
    "price": 0,
    "fees": 0,
    "ratio": 0,
    "currency": "string",
    "note": "string",
    "event_kind": "string"
  }
}
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "details": {
    "property1": null,
    "property2": null
  }
}

Adicionar ativo à carteira

Adiciona um ativo de forma idempotente; sem transações, ele funciona como watchlist. Prefira `entity_id`. Alternativamente, use tipo e símbolo: nome oficial para Tesouro, CNPJ da classe para fundo, código do papel para debênture e código de balcão para outras rendas fixas. A marcação usa negócio recente quando disponível; caso contrário, accrual.

Criar carteira

CRIA uma carteira REAL na conta do dono da chave. O número de carteiras é limitado pelo plano (resposta 402 quando o teto é atingido). Nome único por conta (409 em duplicidade).