Visão geral

Referência completa da API do DataBolsa Advisor, gerada do contrato OpenAPI do escritório.

A API do Advisor é a camada organizacional do DataBolsa em REST + JSON:

https://api.databolsa.com/v1/advisor

Contrato próprio, separado do core: api.databolsa.com/openapi-advisor.json. Nada dele entra no contrato do DataBolsa — as duas superfícies evoluem lado a lado e nunca colidem.

Autenticação

Header Authorization: Bearer <credencial>, em dois formatos:

Chave de organização db_org_... — a credencial de serviço do escritório (escopo full ou read), criada no portal em Config.
Sessão do portal — quando quem chama é uma pessoa, o papel e a visibilidade seguem o assento dela. A chave pessoal do produto B2C não vale aqui: ela pertence a outro realm de identidade.

Grupo	O que cobre
Conta	identidade do chamador e aceite de convite
Organização	dados da org, membros, papéis, convites, licença e chaves
Clientes	clientes, famílias, assessor responsável e perfil
Carteiras	carteiras por cliente — ativos, ledger, posições e evolução
Auditoria	trilha de tudo que foi escrito na organização

404 é escopo. Recurso de outra organização — ou fora da sua visibilidade de clientes — responde 404, nunca 403.
402 é licença. Licença vencida bloqueia escritas com code: license_required; as leituras continuam.
Toda escrita é auditada, na mesma transação da mudança.
Erros seguem application/problem+json (RFC 9457).

A referência é gerada do contrato — cada página traz parâmetros, respostas e exemplos prontos.