@databolsa/sdk 1.0.10 → 1.0.12

package/dist/schema.d.ts

@@ -896,6 +896,57 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/crypto": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Catálogo de criptoativos (velas diárias em BRL) */
+        get: operations["listCrypto"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/crypto/live": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Cotações quase-live de cripto (snapshot ~1 min, 24/7) */
+        get: operations["listCryptoLive"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/crypto/{symbol}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Perfil de um criptoativo */
+        get: operations["getCrypto"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/crypto/{symbol}/quotes": {
         parameters: {
             query?: never;
@@ -913,6 +964,80 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/us/assets": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Catálogo de ativos dos EUA (ações S&P 500/Nasdaq-100 + ETFs) */
+        get: operations["listUsAssets"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/us/assets/{ticker}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Perfil de um ativo dos EUA (com fundamentos SEC inline) */
+        get: operations["getUsAsset"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/us/assets/{ticker}/quotes": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Cotações EOD de um ativo dos EUA (USD)
+         * @description Preços diários em USD, ajustados por desdobramento na fonte.
+         */
+        get: operations["listUsAssetQuotes"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/us/assets/{ticker}/filings": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Filings SEC de uma empresa dos EUA (10-K, 10-Q, 8-K…)
+         * @description Metadados e link do documento oficial no EDGAR (SEC).
+         */
+        get: operations["listUsFilings"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/search": {
         parameters: {
             query?: never;
@@ -1087,7 +1212,7 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/v1/suitability": {
+    "/v1/portfolio/history": {
         parameters: {
             query?: never;
             header?: never;
@@ -1095,10 +1220,10 @@ export interface paths {
             cookie?: never;
         };
         /**
-         * Seu perfil de investidor
-         * @description Retorna o perfil de investidor (suitability) do dono da chave: nível (Conservador/Moderado/Arrojado), a posição na régua 0–100 (não é uma nota) e as respostas do questionário. `profile` é nulo se o usuário ainda não definiu o perfil.
+         * Histórico mensal consolidado
+         * @description Série mensal do patrimônio consolidado do dono da chave: valor de mercado, aporte acumulado, proventos recebidos e resultado realizado, mês a mês. Exclui carteiras marcadas como simulação.
          */
-        get: operations["getSuitability"];
+        get: operations["getPortfolioHistory"];
         put?: never;
         post?: never;
         delete?: never;
@@ -1107,7 +1232,7 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/v1/documents/search": {
+    "/v1/portfolios": {
         parameters: {
             query?: never;
             header?: never;
@@ -1115,10 +1240,34 @@ export interface paths {
             cookie?: never;
         };
         /**
-         * Busca semântica em documentos
-         * @description Busca semântica no TEXTO de documentos CVM/B3 (fatos relevantes, releases de resultado, balanços, relatórios gerenciais de FII, atas de assembleia). Ideal para perguntas qualitativas que os dados estruturados não respondem. Filtre por papel, categoria e ano quando souber.
+         * Suas carteiras
+         * @description Lista as carteiras do dono da chave (id, nome, nº de ativos, flag de simulação). Use o `id` nas demais operações de carteira.
          */
-        get: operations["searchDocuments"];
+        get: operations["listPortfolios"];
+        put?: never;
+        /**
+         * Criar carteira
+         * @description 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).
+         */
+        post: operations["createPortfolio"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/portfolios/import-template": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Template CSV de import manual
+         * @description Baixa o template CSV de preenchimento manual (colunas: ticker, operacao, data, quantidade, preco) aceito pelo import de planilha.
+         */
+        get: operations["getPortfolioImportTemplate"];
         put?: never;
         post?: never;
         delete?: never;
@@ -1127,7 +1276,7 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/v1/community/bots": {
+    "/v1/portfolios/{id}": {
         parameters: {
             query?: never;
             header?: never;
@@ -1135,23 +1284,47 @@ export interface paths {
             cookie?: never;
         };
         /**
-         * Seus bots registrados
-         * @description Lista os bots de comunidade registrados pela sua conta, com handle, status e data de criação.
+         * Detalhe de uma carteira
+         * @description Carteira computada: posições com preço médio, quantidade, valor de mercado, P&L, proventos e alocação, além dos totais. A posição é derivada do ledger de transações.
          */
-        get: operations["listCommunityBots"];
+        get: operations["getPortfolioDetail"];
         put?: never;
+        post?: never;
         /**
-         * Registrar um bot
-         * @description Registra um bot de comunidade na sua conta. O bot ganha um perfil público (@handle) e publica via API em nome dele; as publicações exibem o selo BOT. O número de bots por conta depende do plano.
+         * Apagar carteira
+         * @description APAGA a carteira REAL do dono da chave, com TODOS os ativos e transações (cascata, irreversível). Confirme com o usuário antes de chamar.
          */
-        post: operations["registerCommunityBot"];
+        delete: operations["deletePortfolio"];
+        options?: never;
+        head?: never;
+        /**
+         * Editar carteira
+         * @description ALTERA a carteira REAL do dono da chave: renomeia (`name`), muda a visibilidade (`visibility`) e/ou marca como simulação (`exclude_from_consolidated`, fora do consolidado). Informe ao menos um campo.
+         */
+        patch: operations["updatePortfolio"];
+        trace?: never;
+    };
+    "/v1/portfolios/{id}/history": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Histórico mensal de uma carteira
+         * @description Série mensal (patrimônio, aporte, proventos, realizado) de UMA carteira específica.
+         */
+        get: operations["getPortfolioHistoryById"];
+        put?: never;
+        post?: never;
         delete?: never;
         options?: never;
         head?: never;
         patch?: never;
         trace?: never;
     };
-    "/v1/community/bots/{handle}": {
+    "/v1/portfolios/{id}/assets": {
         parameters: {
             query?: never;
             header?: never;
@@ -1160,18 +1333,50 @@ export interface paths {
         };
         get?: never;
         put?: never;
-        post?: never;
         /**
-         * Desativar um bot
-         * @description Desativa um bot da sua conta (as publicações antigas permanecem, rotuladas como BOT).
+         * Adicionar ativo à carteira
+         * @description ADICIONA um ativo à carteira REAL do dono da chave (idempotente — repetir não duplica). Ativo sem transações funciona como watchlist; lance transações para rastrear posição. Para Tesouro Direto use o nome oficial do título (ex.: TESOURO SELIC 2029).
          */
-        delete: operations["deleteCommunityBot"];
+        post: operations["addPortfolioAsset"];
+        /**
+         * Remover ativo da carteira
+         * @description REMOVE um ativo da carteira REAL do dono da chave, APAGANDO o ledger de transações dele nesta carteira (cascata, irreversível). Confirme com o usuário antes de chamar.
+         */
+        delete: operations["removePortfolioAsset"];
+        options?: never;
+        head?: never;
+        /**
+         * Taxa contratada de renda fixa
+         * @description DEFINE a taxa contratada de uma posição de renda fixa (para o cálculo de rendimento): `rf_indexer` (cdi = % do CDI, prefixado = % a.a., ipca = IPCA + % a.a.) e `rf_rate`. Use `rf_indexer: none` para limpar.
+         */
+        patch: operations["updatePortfolioAsset"];
+        trace?: never;
+    };
+    "/v1/portfolios/{id}/transactions": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Ledger de um ativo
+         * @description Lista as transações (compras, vendas, splits, ajustes) de um ativo da carteira, em ordem cronológica.
+         */
+        get: operations["listPortfolioTransactions"];
+        put?: never;
+        /**
+         * Lançar transação
+         * @description LANÇA uma transação na carteira REAL do dono da chave. Se o ativo ainda não está na carteira, ele é adicionado automaticamente — "compra de 100 PETR4" é uma única chamada. buy/sell exigem `quantity`; `price` é opcional (custo desconhecido); split usa `ratio` (2 = 2:1). Confirme valores com o usuário.
+         */
+        post: operations["addPortfolioTransaction"];
+        delete?: never;
         options?: never;
         head?: never;
         patch?: never;
         trace?: never;
     };
-    "/v1/community/bots/{handle}/posts": {
+    "/v1/portfolios/{id}/transactions/{txId}": {
         parameters: {
             query?: never;
             header?: never;
@@ -1180,18 +1385,66 @@ export interface paths {
         };
         get?: never;
         put?: never;
+        post?: never;
         /**
-         * Publicar como bot
-         * @description Publica um post na comunidade EM NOME do bot informado (público, com selo BOT). Passa por moderação automática: conteúdo reprovado retorna 422 com o motivo. Sujeito a limite diário por bot conforme o plano. Cashtags ($PETR4) viram links.
+         * Remover transação
+         * @description REMOVE uma transação do ledger da carteira REAL do dono da chave (irreversível). Confirme com o usuário antes de chamar.
          */
-        post: operations["createCommunityBotPost"];
+        delete: operations["deletePortfolioTransaction"];
+        options?: never;
+        head?: never;
+        /**
+         * Editar transação
+         * @description ALTERA uma transação existente da carteira REAL do dono da chave (patch parcial: informe só os campos a mudar). Confirme com o usuário antes de chamar.
+         */
+        patch: operations["updatePortfolioTransaction"];
+        trace?: never;
+    };
+    "/v1/portfolios/{id}/imports": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Histórico de imports
+         * @description Lista os imports já feitos nesta carteira (arquivo, fonte, data e resumo persistido).
+         */
+        get: operations["listPortfolioImports"];
+        put?: never;
+        /**
+         * Importar planilha (B3 ou template manual)
+         * @description IMPORTA uma planilha para a carteira REAL do dono da chave: Negociação ou Movimentação da B3 (.xlsx) ou o template manual (.csv/.xlsx) — o formato é detectado automaticamente. Envie o arquivo em `content_base64` (máx. 8 MB). Idempotente: reenviar o mesmo arquivo não duplica lançamentos. A resposta resume o que entrou (importadas, duplicadas, ignoradas) e traz avisos.
+         */
+        post: operations["importPortfolioFile"];
         delete?: never;
         options?: never;
         head?: never;
         patch?: never;
         trace?: never;
     };
-    "/v1/community/bots/{handle}/replies": {
+    "/v1/portfolios/{id}/imports/{importId}/rows": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Linhas de um import
+         * @description Drill-down de um import: cada linha do arquivo com status (imported, ignored, duplicate, error) e motivo.
+         */
+        get: operations["listPortfolioImportRows"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/portfolios/{id}/reconcile": {
         parameters: {
             query?: never;
             header?: never;
@@ -1201,17 +1454,17 @@ export interface paths {
         get?: never;
         put?: never;
         /**
-         * Responder como bot
-         * @description Publica uma resposta EM NOME do bot num post existente da comunidade (pública, com selo BOT). Mesma moderação automática e limites diários por bot do plano.
+         * Reconciliar posição à B3
+         * @description AJUSTA a posição calculada de um ativo à quantidade declarada pela B3 (`target_qty` na data `as_of`), inserindo um ajuste idempotente — útil quando um evento (ex.: subscrição) não veio no extrato. Confirme a quantidade com o usuário antes de chamar.
          */
-        post: operations["createCommunityBotReply"];
+        post: operations["reconcilePortfolioAsset"];
         delete?: never;
         options?: never;
         head?: never;
         patch?: never;
         trace?: never;
     };
-    "/v1/community/feed": {
+    "/v1/suitability": {
         parameters: {
             query?: never;
             header?: never;
@@ -1219,10 +1472,10 @@ export interface paths {
             cookie?: never;
         };
         /**
-         * Feed da comunidade
-         * @description Feed público da comunidade (posts e perguntas), paginado por cursor. Filtre por ticker ou busque por texto.
+         * Seu perfil de investidor
+         * @description Retorna o perfil de investidor (suitability) do dono da chave: nível (Conservador/Moderado/Arrojado), a posição na régua 0–100 (não é uma nota) e as respostas do questionário. `profile` é nulo se o usuário ainda não definiu o perfil.
          */
-        get: operations["getCommunityFeed"];
+        get: operations["getSuitability"];
         put?: never;
         post?: never;
         delete?: never;
@@ -1231,7 +1484,7 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/v1/community/posts/{id}": {
+    "/v1/documents/search": {
         parameters: {
             query?: never;
             header?: never;
@@ -1239,10 +1492,10 @@ export interface paths {
             cookie?: never;
         };
         /**
-         * Um post com a discussão completa
-         * @description Retorna um post da comunidade com todas as respostas (thread completa).
+         * Busca semântica em documentos
+         * @description Busca semântica no TEXTO de documentos CVM/B3 (fatos relevantes, releases de resultado, balanços, relatórios gerenciais de FII, atas de assembleia). Ideal para perguntas qualitativas que os dados estruturados não respondem. Filtre por papel, categoria e ano quando souber.
          */
-        get: operations["getCommunityPost"];
+        get: operations["searchDocuments"];
         put?: never;
         post?: never;
         delete?: never;
@@ -1251,23 +1504,147 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-}
-export type webhooks = Record<string, never>;
-export interface components {
-    schemas: {
-        Health: {
-            /** @enum {string} */
-            status: "ok" | "degraded";
-            version: string;
-            data_freshness: {
-                [key: string]: string;
-            };
+    "/v1/community/bots": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
         };
-        Problem: {
-            type: string;
-            title: string;
-            status: number;
-            detail?: string;
+        /**
+         * Seus bots registrados
+         * @description Lista os bots de comunidade registrados pela sua conta, com handle, status e data de criação.
+         */
+        get: operations["listCommunityBots"];
+        put?: never;
+        /**
+         * Registrar um bot
+         * @description Registra um bot de comunidade na sua conta. O bot ganha um perfil público (@handle) e publica via API em nome dele; as publicações exibem o selo BOT. O número de bots por conta depende do plano.
+         */
+        post: operations["registerCommunityBot"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/community/bots/{handle}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post?: never;
+        /**
+         * Desativar um bot
+         * @description Desativa um bot da sua conta (as publicações antigas permanecem, rotuladas como BOT).
+         */
+        delete: operations["deleteCommunityBot"];
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/community/bots/{handle}/posts": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Publicar como bot
+         * @description Publica um post na comunidade EM NOME do bot informado (público, com selo BOT). Passa por moderação automática: conteúdo reprovado retorna 422 com o motivo. Sujeito a limite diário por bot conforme o plano. Cashtags ($PETR4) viram links.
+         */
+        post: operations["createCommunityBotPost"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/community/bots/{handle}/replies": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Responder como bot
+         * @description Publica uma resposta EM NOME do bot num post existente da comunidade (pública, com selo BOT). Mesma moderação automática e limites diários por bot do plano.
+         */
+        post: operations["createCommunityBotReply"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/community/feed": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Feed da comunidade
+         * @description Feed público da comunidade (posts e perguntas), paginado por cursor. Filtre por ticker ou busque por texto.
+         */
+        get: operations["getCommunityFeed"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/community/posts/{id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Um post com a discussão completa
+         * @description Retorna um post da comunidade com todas as respostas (thread completa).
+         */
+        get: operations["getCommunityPost"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+}
+export type webhooks = Record<string, never>;
+export interface components {
+    schemas: {
+        Health: {
+            /** @enum {string} */
+            status: "ok" | "degraded";
+            version: string;
+            data_freshness: {
+                [key: string]: string;
+            };
+        };
+        Problem: {
+            type: string;
+            title: string;
+            status: number;
+            detail?: string;
             instance?: string;
         };
         Company: {
@@ -1786,6 +2163,36 @@ export interface components {
             vega: number | null;
             theta: number | null;
         };
+        CryptoAsset: {
+            /** @description Ativo-base canônico, ex.: BTC */
+            symbol: string;
+            name: string | null;
+            /** @description Ordem curada por relevância/market cap */
+            rank: number | null;
+            first_date: string | null;
+            last_date: string | null;
+            close_brl: number | null;
+            close_usd: number | null;
+            change_pct_1d: number | null;
+            change_pct_7d: number | null;
+            /** @description Volume negociado em BRL na última vela diária */
+            volume_brl_1d: number | null;
+        };
+        CryptoLiveResponse: {
+            data: components["schemas"]["CryptoLiveQuote"][];
+            /** @description Timestamp mais recente do lote */
+            as_of: string | null;
+        };
+        CryptoLiveQuote: {
+            symbol: string;
+            price_brl: number;
+            price_usd: number | null;
+            /** @description Variação % em 24h rolantes */
+            change_pct_24h: number | null;
+            volume_usd_24h: number | null;
+            /** @description Timestamp do snapshot (UTC) */
+            ts: string;
+        };
         CryptoCandle: {
             open_time: string;
             close_time: string;
@@ -1798,10 +2205,67 @@ export interface components {
             /** @description Volume em BRL */
             quote_volume: number | null;
             trades: number | null;
+            /** @description Fechamento em USD */
+            close_usd: number | null;
+        };
+        UsAsset: {
+            ticker: string;
+            name: string | null;
+            /** @enum {string} */
+            type: "stock" | "etf";
+            in_sp500: boolean | null;
+            in_ndx100: boolean | null;
+            /** @description BDR correspondente na B3, quando mapeado */
+            bdr_ticker: string | null;
+            first_date: string | null;
+            last_date: string | null;
+            close_usd: number | null;
+            change_pct_1d: number | null;
+            change_pct_1m: number | null;
+            change_pct_1y: number | null;
+            high_52w: number | null;
+            low_52w: number | null;
+            volume_1d: number | null;
+        };
+        UsAssetDetail: {
+            fundamentals: components["schemas"]["UsFundamental"][];
+        } & components["schemas"]["UsAsset"];
+        UsFundamental: {
+            /** @enum {string} */
+            metric: "revenue" | "net_income" | "eps_diluted";
+            unit: string | null;
+            /** @description Ano fiscal */
+            fy: number | null;
+            /** @description Período fiscal (FY, Q1..Q4) */
+            fp: string | null;
+            period_start: string | null;
+            period_end: string | null;
+            value: number | null;
+            /** @description Formulário de origem (10-K, 10-Q…) */
+            form: string | null;
+            filed: string | null;
+        };
+        UsQuote: {
+            date: string;
+            open: number | null;
+            high: number | null;
+            low: number | null;
+            close: number | null;
+            volume: number | null;
+        };
+        UsFiling: {
+            accession: string;
+            /** @description 10-K, 10-Q, 8-K, 20-F, 6-K, DEF 14A */
+            form: string;
+            filed_at: string;
+            report_date: string | null;
+            description: string | null;
+            /** @description Documento principal no site da SEC (EDGAR) */
+            url: string;
         };
         SearchResult: {
             /** @enum {string} */
-            kind: "stock" | "fii" | "index" | "bond" | "macro";
+            kind: "stock" | "fii" | "index" | "bond" | "macro" | "crypto" | "us";
             ticker: string;
             title: string;
             subtitle: string | null;
@@ -1878,6 +2342,90 @@ export interface components {
             unrealizedPct: number;
             assets: number;
         };
+        PortfolioListItem: {
+            id: string;
+            name: string;
+            /** @description Nº de ativos na carteira. */
+            count?: number;
+            /** Format: date-time */
+            created_at?: string;
+            /** @description true = carteira de simulação. */
+            exclude_from_consolidated?: boolean;
+        };
+        /** @description Carteira computada: posições derivadas do ledger + métricas agregadas. */
+        PortfolioDetail: {
+            id?: string;
+            name?: string;
+            patrimonio?: number;
+            invested?: number;
+            unrealizedPL?: number;
+            unrealizedPct?: number;
+            realizedPL?: number;
+            /** @description Posições com qty, preço médio, valor de mercado, P&L, proventos e peso. */
+            holdings?: Record<string, never>[];
+        };
+        PortfolioTransaction: {
+            id: string;
+            /** @description buy | sell | split | adjust */
+            kind: string;
+            /** @description AAAA-MM-DD */
+            trade_date: string;
+            quantity: number;
+            /** @description Preço unitário (null = custo desconhecido). */
+            price?: number | null;
+            fees?: number;
+            /** @description Fator do split (só kind=split). */
+            ratio?: number | null;
+            currency?: string;
+            note?: string | null;
+        };
+        PortfolioHistoryResponse: {
+            /** @description Um ponto por mês: patrimônio, aporte acumulado, proventos e realizado. */
+            points?: Record<string, never>[];
+        };
+        /** @description Resumo de um import de planilha (o detalhe linha a linha fica em listPortfolioImportRows). */
+        PortfolioImportSummary: {
+            import_id: string;
+            /** @description negociacao | movimentacao | manual (detectado pelo cabeçalho). */
+            source: string;
+            /** @description Linhas entendidas no arquivo. */
+            parsed?: number;
+            /** @description Lançamentos novos gravados. */
+            imported: number;
+            /** @description Lançamentos já existentes (reimport) pulados. */
+            duplicates_skipped?: number;
+            rows_ignored?: number;
+            /** @description Trades pulados por já estarem cobertos por outra fonte. */
+            cross_source_skipped?: number;
+            symbols?: number;
+            period?: {
+                from?: string | null;
+                to?: string | null;
+            };
+            /** @description Até 10 avisos. */
+            warnings?: string[];
+            /** @description Nº de avisos omitidos além dos 10 primeiros. */
+            warnings_truncated?: number;
+        };
+        PortfolioImportListItem: {
+            id: string;
+            filename?: string | null;
+            source: string;
+            /** Format: date-time */
+            createdAt?: string;
+            summary?: Record<string, never>;
+            warnings?: string[];
+        };
+        PortfolioImportRow: {
+            row_index: number;
+            /** @description imported | ignored | duplicate | error */
+            status: string;
+            kind?: string | null;
+            label?: string | null;
+            reason?: string | null;
+            external_id?: string | null;
+            raw?: unknown;
+        };
         /** @description Carteira consolidada do usuário (mesmo resumo que o agente de IA usa). */
         PortfolioContext: {
             hasPortfolio: boolean;
@@ -3091,7 +3639,7 @@ export interface operations {
             query?: {
                 cursor?: string;
                 limit?: number;
-                source?: "bcb_sgs" | "bcb_focus" | "ibge_sidra" | "fred" | "ipeadata" | "tesouro_direto";
+                source?: "bcb_sgs" | "bcb_focus" | "ibge_sidra" | "fred" | "ipeadata" | "tesouro_direto" | "world_bank";
                 search?: string;
             };
             header?: never;
@@ -3799,24 +4347,917 @@ export interface operations {
                 to?: string;
             };
             header?: never;
-            path?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Página de ofertas */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        data: components["schemas"]["PublicOffering"][];
+                        meta: {
+                            next_cursor: string | null;
+                            /** @description Itens nesta página */
+                            count: number;
+                        };
+                    };
+                };
+            };
+            /** @description Erro (RFC 9457 application/problem+json) */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["Problem"];
+                };
+            };
+        };
+    };
+    getOptionsChain: {
+        parameters: {
+            query?: {
+                expiry?: string;
+                type?: "call" | "put";
+            };
+            header?: never;
+            path: {
+                ticker: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Cadeia de opções */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["OptionsChain"];
+                };
+            };
+            /** @description Erro (RFC 9457 application/problem+json) */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["Problem"];
+                };
+            };
+        };
+    };
+    listOptionExpiries: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                ticker: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Vencimentos */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["OptionExpiries"];
+                };
+            };
+            /** @description Erro (RFC 9457 application/problem+json) */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["Problem"];
+                };
+            };
+        };
+    };
+    listOptionQuotes: {
+        parameters: {
+            query?: {
+                cursor?: string;
+                limit?: number;
+                from?: string;
+                to?: string;
+            };
+            header?: never;
+            path: {
+                option: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Página de cotações */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        data: components["schemas"]["OptionQuote"][];
+                        meta: {
+                            next_cursor: string | null;
+                            /** @description Itens nesta página */
+                            count: number;
+                        };
+                    };
+                };
+            };
+            /** @description Erro (RFC 9457 application/problem+json) */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["Problem"];
+                };
+            };
+        };
+    };
+    listCrypto: {
+        parameters: {
+            query?: {
+                cursor?: string;
+                limit?: number;
+                search?: string;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Página de criptoativos */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        data: components["schemas"]["CryptoAsset"][];
+                        meta: {
+                            next_cursor: string | null;
+                            /** @description Itens nesta página */
+                            count: number;
+                        };
+                    };
+                };
+            };
+            /** @description Erro (RFC 9457 application/problem+json) */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["Problem"];
+                };
+            };
+        };
+    };
+    listCryptoLive: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Snapshot de cotações */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["CryptoLiveResponse"];
+                };
+            };
+            /** @description Erro (RFC 9457 application/problem+json) */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["Problem"];
+                };
+            };
+        };
+    };
+    getCrypto: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                symbol: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Criptoativo */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["CryptoAsset"];
+                };
+            };
+            /** @description Erro (RFC 9457 application/problem+json) */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["Problem"];
+                };
+            };
+        };
+    };
+    listCryptoQuotes: {
+        parameters: {
+            query?: {
+                cursor?: string;
+                limit?: number;
+                interval?: "1d" | "1h";
+                from?: string;
+                to?: string;
+            };
+            header?: never;
+            path: {
+                symbol: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Página de candles */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        data: components["schemas"]["CryptoCandle"][];
+                        meta: {
+                            next_cursor: string | null;
+                            /** @description Itens nesta página */
+                            count: number;
+                        };
+                    };
+                };
+            };
+            /** @description Erro (RFC 9457 application/problem+json) */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["Problem"];
+                };
+            };
+        };
+    };
+    listUsAssets: {
+        parameters: {
+            query?: {
+                cursor?: string;
+                limit?: number;
+                search?: string;
+                type?: "stock" | "etf";
+                bdr?: string;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Página de ativos */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        data: components["schemas"]["UsAsset"][];
+                        meta: {
+                            next_cursor: string | null;
+                            /** @description Itens nesta página */
+                            count: number;
+                        };
+                    };
+                };
+            };
+            /** @description Erro (RFC 9457 application/problem+json) */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["Problem"];
+                };
+            };
+        };
+    };
+    getUsAsset: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                ticker: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Ativo */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["UsAssetDetail"];
+                };
+            };
+            /** @description Erro (RFC 9457 application/problem+json) */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["Problem"];
+                };
+            };
+        };
+    };
+    listUsAssetQuotes: {
+        parameters: {
+            query?: {
+                cursor?: string;
+                limit?: number;
+                from?: string;
+                to?: string;
+            };
+            header?: never;
+            path: {
+                ticker: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Página de cotações */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        data: components["schemas"]["UsQuote"][];
+                        meta: {
+                            next_cursor: string | null;
+                            /** @description Itens nesta página */
+                            count: number;
+                        };
+                    };
+                };
+            };
+            /** @description Erro (RFC 9457 application/problem+json) */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["Problem"];
+                };
+            };
+        };
+    };
+    listUsFilings: {
+        parameters: {
+            query?: {
+                cursor?: string;
+                limit?: number;
+                form?: string;
+            };
+            header?: never;
+            path: {
+                ticker: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Página de filings */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        data: components["schemas"]["UsFiling"][];
+                        meta: {
+                            next_cursor: string | null;
+                            /** @description Itens nesta página */
+                            count: number;
+                        };
+                    };
+                };
+            };
+            /** @description Erro (RFC 9457 application/problem+json) */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["Problem"];
+                };
+            };
+        };
+    };
+    search: {
+        parameters: {
+            query: {
+                q: string;
+                limit?: number;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Resultados ranqueados */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["SearchResult"][];
+                };
+            };
+            /** @description Erro (RFC 9457 application/problem+json) */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["Problem"];
+                };
+            };
+        };
+    };
+    getIngestHealth: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Saúde da ingestão */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        latest: ({
+                            errors: string[];
+                        } & components["schemas"]["IngestRunSummary"]) | null;
+                        sources: components["schemas"]["IngestSourceHealth"][];
+                        recent_runs: components["schemas"]["IngestRunSummary"][];
+                    };
+                };
+            };
+            /** @description Erro (RFC 9457 application/problem+json) */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["Problem"];
+                };
+            };
+        };
+    };
+    getNewsEdition: {
+        parameters: {
+            query?: {
+                /** @description Data da edição (AAAA-MM-DD). Omita p/ a mais recente. */
+                date?: string;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Edição publicada + itens. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["NewsEditionEnvelope"];
+                };
+            };
+            /** @description Erro (RFC 9457 application/problem+json) */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": Record<string, never>;
+                };
+            };
+        };
+    };
+    listNewsDates: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Datas + slots. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["NewsDatesResponse"];
+                };
+            };
+            /** @description Erro (RFC 9457 application/problem+json) */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": Record<string, never>;
+                };
+            };
+        };
+    };
+    listNewsFeed: {
+        parameters: {
+            query?: {
+                /** @description Itens por página (1–50, default 20). */
+                limit?: number;
+                /** @description Offset de paginação (do `nextCursor` anterior). */
+                cursor?: string;
+                /** @description Filtra por categoria/linha editorial. */
+                category?: string;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Página de itens + `nextCursor`. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["NewsFeedResponse"];
+                };
+            };
+            /** @description Erro (RFC 9457 application/problem+json) */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": Record<string, never>;
+                };
+            };
+        };
+    };
+    getNewsItem: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Slug do item (do campo `slug` do feed/edição). */
+                slug: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Item + relacionadas. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["NewsItemEnvelope"];
+                };
+            };
+            /** @description Erro (RFC 9457 application/problem+json) */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": Record<string, never>;
+                };
+            };
+        };
+    };
+    listNewsStories: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Stories do dia. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["NewsStoriesResponse"];
+                };
+            };
+            /** @description Erro (RFC 9457 application/problem+json) */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": Record<string, never>;
+                };
+            };
+        };
+    };
+    getNewsAgenda: {
+        parameters: {
+            query?: {
+                /** @description Janela em dias (1–90, default 30). */
+                days?: number;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Agenda consolidada. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["NewsAgendaResponse"];
+                };
+            };
+            /** @description Erro (RFC 9457 application/problem+json) */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": Record<string, never>;
+                };
+            };
+        };
+    };
+    getPortfolio: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Carteira consolidada do usuário. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["PortfolioContext"];
+                };
+            };
+            /** @description Erro (RFC 9457 application/problem+json) */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": Record<string, never>;
+                };
+            };
+        };
+    };
+    getPortfolioHistory: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Pontos mensais. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["PortfolioHistoryResponse"];
+                };
+            };
+            /** @description Erro (RFC 9457 application/problem+json) */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": Record<string, never>;
+                };
+            };
+        };
+    };
+    listPortfolios: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Carteiras da conta. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        portfolios?: components["schemas"]["PortfolioListItem"][];
+                    };
+                };
+            };
+            /** @description Erro (RFC 9457 application/problem+json) */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": Record<string, never>;
+                };
+            };
+        };
+    };
+    createPortfolio: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": {
+                    /** @description Nome da carteira (até 60 caracteres, único na conta). */
+                    name: string;
+                    /**
+                     * @description Visibilidade (default private).
+                     * @enum {string}
+                     */
+                    visibility?: "private" | "unlisted" | "public";
+                };
+            };
+        };
+        responses: {
+            /** @description Carteira criada. */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["PortfolioListItem"];
+                };
+            };
+            /** @description Erro (RFC 9457 application/problem+json) */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": Record<string, never>;
+                };
+            };
+        };
+    };
+    getPortfolioImportTemplate: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Arquivo CSV. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "text/csv": string;
+                };
+            };
+            /** @description Erro (RFC 9457 application/problem+json) */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": Record<string, never>;
+                };
+            };
+        };
+    };
+    getPortfolioDetail: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Id da carteira (de listPortfolios). */
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Carteira computada. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["PortfolioDetail"];
+                };
+            };
+            /** @description Erro (RFC 9457 application/problem+json) */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": Record<string, never>;
+                };
+            };
+        };
+    };
+    deletePortfolio: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Id da carteira. */
+                id: string;
+            };
             cookie?: never;
         };
         requestBody?: never;
         responses: {
-            /** @description Página de ofertas */
+            /** @description Carteira apagada. */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
                     "application/json": {
-                        data: components["schemas"]["PublicOffering"][];
-                        meta: {
-                            next_cursor: string | null;
-                            /** @description Itens nesta página */
-                            count: number;
-                        };
+                        deleted?: boolean;
+                        id?: string;
                     };
                 };
             };
@@ -3826,32 +5267,44 @@ export interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/problem+json": components["schemas"]["Problem"];
+                    "application/problem+json": Record<string, never>;
                 };
             };
         };
     };
-    getOptionsChain: {
+    updatePortfolio: {
         parameters: {
-            query?: {
-                expiry?: string;
-                type?: "call" | "put";
-            };
+            query?: never;
             header?: never;
             path: {
-                ticker: string;
+                /** @description Id da carteira. */
+                id: string;
             };
             cookie?: never;
         };
-        requestBody?: never;
+        requestBody: {
+            content: {
+                "application/json": {
+                    /** @description Novo nome (até 60 caracteres, único na conta). */
+                    name?: string;
+                    /**
+                     * @description Nova visibilidade.
+                     * @enum {string}
+                     */
+                    visibility?: "private" | "unlisted" | "public";
+                    /** @description true = carteira de simulação (fora do consolidado). */
+                    exclude_from_consolidated?: boolean;
+                };
+            };
+        };
         responses: {
-            /** @description Cadeia de opções */
+            /** @description Campos alterados. */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["OptionsChain"];
+                    "application/json": Record<string, never>;
                 };
             };
             /** @description Erro (RFC 9457 application/problem+json) */
@@ -3860,29 +5313,30 @@ export interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/problem+json": components["schemas"]["Problem"];
+                    "application/problem+json": Record<string, never>;
                 };
             };
         };
     };
-    listOptionExpiries: {
+    getPortfolioHistoryById: {
         parameters: {
             query?: never;
             header?: never;
             path: {
-                ticker: string;
+                /** @description Id da carteira. */
+                id: string;
             };
             cookie?: never;
         };
         requestBody?: never;
         responses: {
-            /** @description Vencimentos */
+            /** @description Pontos mensais. */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["OptionExpiries"];
+                    "application/json": components["schemas"]["PortfolioHistoryResponse"];
                 };
             };
             /** @description Erro (RFC 9457 application/problem+json) */
@@ -3891,41 +5345,42 @@ export interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/problem+json": components["schemas"]["Problem"];
+                    "application/problem+json": Record<string, never>;
                 };
             };
         };
     };
-    listOptionQuotes: {
+    addPortfolioAsset: {
         parameters: {
-            query?: {
-                cursor?: string;
-                limit?: number;
-                from?: string;
-                to?: string;
-            };
+            query?: never;
             header?: never;
             path: {
-                option: string;
+                /** @description Id da carteira. */
+                id: string;
             };
             cookie?: never;
         };
-        requestBody?: never;
+        requestBody: {
+            content: {
+                "application/json": {
+                    /**
+                     * @description Tipo do ativo.
+                     * @enum {string}
+                     */
+                    asset_type: "stock" | "fii" | "bdr" | "index" | "tesouro" | "crypto" | "option" | "renda_fixa";
+                    /** @description Ticker (ex.: PETR4) ou nome oficial do título do Tesouro. */
+                    symbol: string;
+                };
+            };
+        };
         responses: {
-            /** @description Página de cotações */
-            200: {
+            /** @description Ativo na carteira. */
+            201: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": {
-                        data: components["schemas"]["OptionQuote"][];
-                        meta: {
-                            next_cursor: string | null;
-                            /** @description Itens nesta página */
-                            count: number;
-                        };
-                    };
+                    "application/json": Record<string, never>;
                 };
             };
             /** @description Erro (RFC 9457 application/problem+json) */
@@ -3934,42 +5389,35 @@ export interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/problem+json": components["schemas"]["Problem"];
+                    "application/problem+json": Record<string, never>;
                 };
             };
         };
     };
-    listCryptoQuotes: {
+    removePortfolioAsset: {
         parameters: {
-            query?: {
-                cursor?: string;
-                limit?: number;
-                interval?: "1d" | "1h";
-                from?: string;
-                to?: string;
+            query: {
+                /** @description Tipo do ativo. */
+                asset_type: "stock" | "fii" | "bdr" | "index" | "tesouro" | "crypto" | "option" | "renda_fixa";
+                /** @description Ticker ou nome do título. */
+                symbol: string;
             };
             header?: never;
             path: {
-                symbol: string;
+                /** @description Id da carteira. */
+                id: string;
             };
             cookie?: never;
         };
         requestBody?: never;
         responses: {
-            /** @description Página de candles */
+            /** @description Ativo removido. */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": {
-                        data: components["schemas"]["CryptoCandle"][];
-                        meta: {
-                            next_cursor: string | null;
-                            /** @description Itens nesta página */
-                            count: number;
-                        };
-                    };
+                    "application/json": Record<string, never>;
                 };
             };
             /** @description Erro (RFC 9457 application/problem+json) */
@@ -3978,30 +5426,47 @@ export interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/problem+json": components["schemas"]["Problem"];
+                    "application/problem+json": Record<string, never>;
                 };
             };
         };
     };
-    search: {
+    updatePortfolioAsset: {
         parameters: {
             query: {
-                q: string;
-                limit?: number;
+                /** @description Tipo do ativo (renda_fixa/tesouro). */
+                asset_type: string;
+                /** @description Código do papel. */
+                symbol: string;
             };
             header?: never;
-            path?: never;
+            path: {
+                /** @description Id da carteira. */
+                id: string;
+            };
             cookie?: never;
         };
-        requestBody?: never;
+        requestBody: {
+            content: {
+                "application/json": {
+                    /**
+                     * @description Indexador (none limpa a taxa).
+                     * @enum {string}
+                     */
+                    rf_indexer: "cdi" | "prefixado" | "ipca" | "none";
+                    /** @description Taxa (ex.: 110 = 110% do CDI; 6.2 = IPCA+6,2%). */
+                    rf_rate?: number;
+                };
+            };
+        };
         responses: {
-            /** @description Resultados ranqueados */
+            /** @description Meta da posição. */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["SearchResult"][];
+                    "application/json": Record<string, never>;
                 };
             };
             /** @description Erro (RFC 9457 application/problem+json) */
@@ -4010,32 +5475,36 @@ export interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/problem+json": components["schemas"]["Problem"];
+                    "application/problem+json": Record<string, never>;
                 };
             };
         };
     };
-    getIngestHealth: {
+    listPortfolioTransactions: {
         parameters: {
-            query?: never;
+            query: {
+                /** @description Tipo do ativo. */
+                asset_type: string;
+                /** @description Ticker ou nome do título. */
+                symbol: string;
+            };
             header?: never;
-            path?: never;
+            path: {
+                /** @description Id da carteira. */
+                id: string;
+            };
             cookie?: never;
         };
         requestBody?: never;
         responses: {
-            /** @description Saúde da ingestão */
+            /** @description Transações do ativo. */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
                     "application/json": {
-                        latest: ({
-                            errors: string[];
-                        } & components["schemas"]["IngestRunSummary"]) | null;
-                        sources: components["schemas"]["IngestSourceHealth"][];
-                        recent_runs: components["schemas"]["IngestRunSummary"][];
+                        transactions?: components["schemas"]["PortfolioTransaction"][];
                     };
                 };
             };
@@ -4045,30 +5514,61 @@ export interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/problem+json": components["schemas"]["Problem"];
+                    "application/problem+json": Record<string, never>;
                 };
             };
         };
     };
-    getNewsEdition: {
+    addPortfolioTransaction: {
         parameters: {
-            query?: {
-                /** @description Data da edição (AAAA-MM-DD). Omita p/ a mais recente. */
-                date?: string;
-            };
+            query?: never;
             header?: never;
-            path?: never;
+            path: {
+                /** @description Id da carteira. */
+                id: string;
+            };
             cookie?: never;
         };
-        requestBody?: never;
+        requestBody: {
+            content: {
+                "application/json": {
+                    /**
+                     * @description Tipo do ativo.
+                     * @enum {string}
+                     */
+                    asset_type: "stock" | "fii" | "bdr" | "index" | "tesouro" | "crypto" | "option" | "renda_fixa";
+                    /** @description Ticker (ex.: PETR4) ou nome oficial do título do Tesouro. */
+                    symbol: string;
+                    /**
+                     * @description Tipo da transação.
+                     * @enum {string}
+                     */
+                    kind: "buy" | "sell" | "split";
+                    /** @description Data do negócio (AAAA-MM-DD). */
+                    trade_date: string;
+                    /** @description Quantidade (> 0; obrigatória em buy/sell). */
+                    quantity?: number;
+                    /** @description Preço unitário em BRL (omita se desconhecido). */
+                    price?: number;
+                    /** @description Custos/corretagem em BRL (default 0). */
+                    fees?: number;
+                    /** @description Fator do split (2 = 2:1; 0.5 = grupamento 1:2). */
+                    ratio?: number;
+                    /** @description Observação livre (até 280 caracteres). */
+                    note?: string;
+                };
+            };
+        };
         responses: {
-            /** @description Edição publicada + itens. */
-            200: {
+            /** @description Transação lançada. */
+            201: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["NewsEditionEnvelope"];
+                    "application/json": {
+                        transaction?: components["schemas"]["PortfolioTransaction"];
+                    };
                 };
             };
             /** @description Erro (RFC 9457 application/problem+json) */
@@ -4082,22 +5582,30 @@ export interface operations {
             };
         };
     };
-    listNewsDates: {
+    deletePortfolioTransaction: {
         parameters: {
             query?: never;
             header?: never;
-            path?: never;
+            path: {
+                /** @description Id da carteira. */
+                id: string;
+                /** @description Id da transação. */
+                txId: string;
+            };
             cookie?: never;
         };
         requestBody?: never;
         responses: {
-            /** @description Datas + slots. */
+            /** @description Transação removida. */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["NewsDatesResponse"];
+                    "application/json": {
+                        deleted?: boolean;
+                        id?: string;
+                    };
                 };
             };
             /** @description Erro (RFC 9457 application/problem+json) */
@@ -4111,29 +5619,49 @@ export interface operations {
             };
         };
     };
-    listNewsFeed: {
+    updatePortfolioTransaction: {
         parameters: {
-            query?: {
-                /** @description Itens por página (1–50, default 20). */
-                limit?: number;
-                /** @description Offset de paginação (do `nextCursor` anterior). */
-                cursor?: string;
-                /** @description Filtra por categoria/linha editorial. */
-                category?: string;
-            };
+            query?: never;
             header?: never;
-            path?: never;
+            path: {
+                /** @description Id da carteira. */
+                id: string;
+                /** @description Id da transação (de listPortfolioTransactions). */
+                txId: string;
+            };
             cookie?: never;
         };
-        requestBody?: never;
+        requestBody: {
+            content: {
+                "application/json": {
+                    /**
+                     * @description Tipo da transação.
+                     * @enum {string}
+                     */
+                    kind?: "buy" | "sell" | "split";
+                    /** @description Data do negócio (AAAA-MM-DD). */
+                    trade_date?: string;
+                    /** @description Quantidade. */
+                    quantity?: number;
+                    /** @description Preço unitário em BRL. */
+                    price?: number;
+                    /** @description Custos em BRL. */
+                    fees?: number;
+                    /** @description Fator do split. */
+                    ratio?: number;
+                    /** @description Observação. */
+                    note?: string;
+                };
+            };
+        };
         responses: {
-            /** @description Página de itens + `nextCursor`. */
+            /** @description Transação atualizada. */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["NewsFeedResponse"];
+                    "application/json": components["schemas"]["PortfolioTransaction"];
                 };
             };
             /** @description Erro (RFC 9457 application/problem+json) */
@@ -4147,25 +5675,27 @@ export interface operations {
             };
         };
     };
-    getNewsItem: {
+    listPortfolioImports: {
         parameters: {
             query?: never;
             header?: never;
             path: {
-                /** @description Slug do item (do campo `slug` do feed/edição). */
-                slug: string;
+                /** @description Id da carteira. */
+                id: string;
             };
             cookie?: never;
         };
         requestBody?: never;
         responses: {
-            /** @description Item + relacionadas. */
+            /** @description Imports da carteira. */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["NewsItemEnvelope"];
+                    "application/json": {
+                        imports?: components["schemas"]["PortfolioImportListItem"][];
+                    };
                 };
             };
             /** @description Erro (RFC 9457 application/problem+json) */
@@ -4179,22 +5709,34 @@ export interface operations {
             };
         };
     };
-    listNewsStories: {
+    importPortfolioFile: {
         parameters: {
             query?: never;
             header?: never;
-            path?: never;
+            path: {
+                /** @description Id da carteira. */
+                id: string;
+            };
             cookie?: never;
         };
-        requestBody?: never;
+        requestBody: {
+            content: {
+                "application/json": {
+                    /** @description Conteúdo do arquivo em base64. */
+                    content_base64: string;
+                    /** @description Nome do arquivo (ajuda a trilha de auditoria). */
+                    filename?: string;
+                };
+            };
+        };
         responses: {
-            /** @description Stories do dia. */
-            200: {
+            /** @description Resumo do import. */
+            201: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["NewsStoriesResponse"];
+                    "application/json": components["schemas"]["PortfolioImportSummary"];
                 };
             };
             /** @description Erro (RFC 9457 application/problem+json) */
@@ -4208,25 +5750,37 @@ export interface operations {
             };
         };
     };
-    getNewsAgenda: {
+    listPortfolioImportRows: {
         parameters: {
             query?: {
-                /** @description Janela em dias (1–90, default 30). */
-                days?: number;
+                /** @description Filtra por status. */
+                status?: "imported" | "ignored" | "duplicate" | "error";
+                /** @description Linhas por página (1–500, default 100). */
+                limit?: number;
+                /** @description Offset de paginação. */
+                offset?: number;
             };
             header?: never;
-            path?: never;
+            path: {
+                /** @description Id da carteira. */
+                id: string;
+                /** @description Id do import (de listPortfolioImports). */
+                importId: string;
+            };
             cookie?: never;
         };
         requestBody?: never;
         responses: {
-            /** @description Agenda consolidada. */
+            /** @description Linhas do import. */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["NewsAgendaResponse"];
+                    "application/json": {
+                        total?: number;
+                        rows?: components["schemas"]["PortfolioImportRow"][];
+                    };
                 };
             };
             /** @description Erro (RFC 9457 application/problem+json) */
@@ -4240,22 +5794,38 @@ export interface operations {
             };
         };
     };
-    getPortfolio: {
+    reconcilePortfolioAsset: {
         parameters: {
             query?: never;
             header?: never;
-            path?: never;
+            path: {
+                /** @description Id da carteira. */
+                id: string;
+            };
             cookie?: never;
         };
-        requestBody?: never;
+        requestBody: {
+            content: {
+                "application/json": {
+                    /** @description Tipo do ativo. */
+                    asset_type: string;
+                    /** @description Ticker. */
+                    symbol: string;
+                    /** @description Quantidade declarada pela B3 (>= 0). */
+                    target_qty: number;
+                    /** @description Data de referência (AAAA-MM-DD). */
+                    as_of: string;
+                };
+            };
+        };
         responses: {
-            /** @description Carteira consolidada do usuário. */
+            /** @description Resultado do ajuste (delta aplicado). */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["PortfolioContext"];
+                    "application/json": Record<string, never>;
                 };
             };
             /** @description Erro (RFC 9457 application/problem+json) */