QuantBrasil
Documentação

quantbrasil holdings create

Cria uma carteira

Sintaxe

quantbrasil holdings create <name>

Esta é uma operação de alteração. Modos de saída: json, human.

Argumentos e opções

NomeTipoObrigatórioDescriçãoPadrão
nameArgumentoSimNome da carteira
--mode <mode>OpçãoNãoModo inicial: target ou positiontarget
--target <target>OpçãoNãoPeso-alvo inicial no formato TICKER:PESO_PERCENTUAL
--jsonOpçãoNãoExibe saída JSON

Exemplos

quantbrasil holdings create "Longo Prazo"
quantbrasil holdings create "Teórica" --target PRIO3:50 --target VALE3:50
quantbrasil holdings create "Real" --mode position

Saída (--json)

Estrutura da resposta retornada com --json:

export interface PortfolioCreateResponse {
  ok: boolean;
  summary_markdown: string;
  portfolio: PortfolioOut;
}

export interface PortfolioOut {
  id: number;
  name: string;
  kind: "WATCHLIST" | "HOLDING" | "SYSTEM" | null;
  symbols: string[];
  weights: Record<string, number> | null;
  default_allocation_input: "TARGET_WEIGHT" | "POSITION" | null;
  has_target_weights: boolean;
  has_positions: boolean;
}

Exemplo de resposta

{
  "ok": true,
  "summary_markdown": "Carteira **Longo Prazo** criada com PETR4 e VALE3.",
  "portfolio": {
    "id": 182,
    "name": "Longo Prazo",
    "kind": "HOLDING",
    "symbols": ["PETR4", "VALE3"],
    "weights": {
      "PETR4": 0.6,
      "VALE3": 0.4
    },
    "default_allocation_input": "TARGET_WEIGHT",
    "has_target_weights": true,
    "has_positions": false
  }
}