Wallet

A Wallet adiciona carteiras ao workspace pessoal ou de uma organização. Ela guarda o ledger de transações e deriva posição, preço médio, custos, resultado, histórico e análises sem duplicar a identidade dos ativos do mercado.

No workspace pessoal, a Wallet é instalada por padrão. Em uma organização, a instalação e o acesso seguem as permissões daquele workspace.

No Notebook

A página Wallet reúne as carteiras acessíveis à pessoa. O antigo bloco de documento wallet.portfolios foi descontinuado; documentos que ainda o contêm mostram um aviso e direcionam para a página da extensão.

Carteiras de uma organização podem ser privadas, restritas a membros escolhidos ou compartilhadas no workspace. Ativos, transações e importações herdam o acesso da carteira.

No agente

O MCP hospedado acrescenta as tools da Wallet quando a extensão está instalada e a sessão tem acesso ao workspace. Leituras consultam os dados reais; escritas como criar uma carteira, importar um extrato ou lançar uma transação devem mostrar alvo e efeito e pedir confirmação.

Conecte o seu agente pelo guia em Agentes e integrações.

API e clientes

O contrato da Wallet é separado do contrato de mercado:

• Referência da API
• OpenAPI
• @databolsa/wallet-sdk
• @databolsa/wallet-cli
• @databolsa/wallet-mcp para uso local

SDK

import { DataBolsa } from "@databolsa/sdk";
import { wallet } from "@databolsa/wallet-sdk";

const db = new DataBolsa("https://api.databolsa.com", {
  apiKey: process.env.DATABOLSA_API_KEY,
});
const carteira = db.use(wallet({ workspace: process.env.DATABOLSA_WORKSPACE }));
const { data } = await carteira.listPortfolios();

O plugin reaproveita a origem e a credencial do cliente core. Também é possível instanciar DataBolsaWallet diretamente.

CLI

export DATABOLSA_API_KEY=db_live_SUACHAVE
npx -y @databolsa/wallet-cli --list
npx -y @databolsa/wallet-cli listPortfolios --json

DATABOLSA_WORKSPACE escolhe uma organização; sem ele, a extensão usa o workspace pessoal. A CLI principal mantém databolsa wallet como atalho, mas @databolsa/wallet-cli é a entrada canônica para scripts.

Comportamento de acesso

• Wallet ausente responde 404 wallet_not_installed.
• Organização inexistente ou inacessível responde 404 workspace_not_found.
• Suspensão preserva leitura e recusa escrita com 403 wallet_suspended.
• Apagar uma carteira exige permissão de administração sobre o recurso.

A Wallet registra posições e análises; não executa ordens nem recomenda investimentos.