SDK TypeScript
@databolsa/sdk — cliente tipado da Serving API, com tipos gerados do contrato.
npm install @databolsa/sdkimport { DataBolsa } from "@databolsa/sdk";
const db = new DataBolsa("https://api.databolsa.com", {
apiKey: process.env.DATABOLSA_API_KEY,
});
const stock = await db.getStock("PETR4");
const quotes = await db.listQuotes({ tickers: "PETR4,VALE3" });
const fiis = await db.screenFiis({ segment: "Logística", dyMin: 8 });
// Gestão de carteira (escreve na SUA carteira real — guia em /agentes/carteira):
const { portfolios } = await db.listPortfolios();
await db.addPortfolioTransaction(portfolios[0].id, { assetType: "stock", symbol: "PETR4" }, {
kind: "buy",
tradeDate: "2026-07-10",
quantity: 100,
price: 38.1,
});- ESM-only, tipos gerados do contrato OpenAPI via
openapi-typescript— um método por operação, mesmos nomes da referência (getStock,screenFiis…). - Exporta os tipos de domínio (
Stock,Fii,QuotesResponse, …) e os tipos crus do contrato (paths,components,operations). - Erros da API viram exceções com o
detaildoproblem+json; endpoints fora do preview do seu deploy lançamNotInPreviewError.
Chave no servidor, nunca no browser
A chave identifica a SUA conta. Em apps web, chame a API do seu backend (ou de um
route handler) e mantenha DATABOLSA_API_KEY como secret do servidor.
Código aberto: packages/sdk.