SDKs Oficiais da BRAPI para TypeScript e Python

npm install brapi
# ou
pnpm add brapi
# ou
bun add brapi

pip install --upgrade brapi

import Brapi from 'brapi';

const client = new Brapi({
  apiKey: process.env.BRAPI_API_KEY,
});

const response = await client.v2.stocks.quote({ symbols: 'PETR4' });
const petr4 = response.results[0].data;

console.log(petr4.longName); // Petroleo Brasileiro SA Pfd
console.log(petr4.regularMarketPrice); // 48.72
console.log(petr4.regularMarketChangePercent); // 1.52

from brapi import Brapi

client = Brapi(api_key="seu_token")

response = client.v2.stocks.quote(symbols="PETR4")
petr4 = response.results[0].data

print(petr4.long_name)  # Petroleo Brasileiro SA Pfd
print(petr4.regular_market_price)  # 48.72

const history = await client.v2.stocks.historical({
  symbols: 'PETR4',
  range: '1mo',
  interval: '1d',
});

for (const day of history.results[0].data.historicalDataPrice) {
  console.log(new Date(day.date * 1000), day.close, day.volume);
}

history = client.v2.stocks.historical(symbols="PETR4", range="1mo", interval="1d")

for day in history.results[0].data.historical_data_price:
    print(day.date, day.close, day.volume)

const dividends = await client.v2.stocks.dividends({ symbols: 'ITUB4' });

for (const item of dividends.results[0].data.cashDividends) {
  console.log(item.label, item.rate, item.paymentDate);
}

dividends = client.v2.stocks.dividends(symbols="ITUB4")

for item in dividends.results[0].data.cash_dividends:
    print(item.label, item.rate, item.payment_date)

import asyncio
from brapi import AsyncBrapi

async def main():
    async with AsyncBrapi(api_key="seu_token") as client:
        petr4, vale3 = await asyncio.gather(
            client.v2.stocks.quote(symbols="PETR4"),
            client.v2.stocks.quote(symbols="VALE3"),
        )
        print(petr4.results[0].data.regular_market_price)
        print(vale3.results[0].data.regular_market_price)

asyncio.run(main())

// app/acao/[ticker]/page.tsx
import Brapi from 'brapi';

const client = new Brapi({
  apiKey: process.env.BRAPI_API_KEY,
});

export default async function StockPage({
  params,
}: {
  params: Promise<{ ticker: string }>;
}) {
  const { ticker } = await params;
  const response = await client.v2.stocks.quote({ symbols: ticker });
  const stock = response.results[0].data;

  return (
    <div>
      <h1>{stock.longName}</h1>
      <p>R$ {stock.regularMarketPrice.toFixed(2)}</p>
    </div>
  );
}

from fastapi import FastAPI
from brapi import AsyncBrapi

app = FastAPI()
client = AsyncBrapi()  # lê BRAPI_API_KEY

@app.get("/cotacao/{ticker}")
async def get_quote(ticker: str):
    response = await client.v2.stocks.quote(symbols=ticker)
    stock = response.results[0].data
    return {"symbol": ticker, "price": stock.regular_market_price}

const response = await fetch(
  'https://brapi.dev/api/v2/stocks/quote?symbols=PETR4',
  { headers: { Authorization: `Bearer ${token}` } },
);

if (!response.ok) {
  throw new Error(`HTTP ${response.status}`);
}

const json = await response.json();
const price = json.results[0].data.regularMarketPrice; // sem tipos

const response = await client.v2.stocks.quote({ symbols: 'PETR4' });
const price = response.results[0].data.regularMarketPrice; // number

try {
  await client.v2.stocks.quote({ symbols: 'PETR4' });
} catch (error) {
  if (error instanceof Brapi.AuthenticationError) {
    console.log('Token inválido ou ausente');
  } else if (error instanceof Brapi.RateLimitError) {
    console.log('Limite de requisições atingido');
  } else if (error instanceof Brapi.APIError) {
    console.log(error.status, error.message);
  } else {
    throw error;
  }
}

import brapi

try:
    client.v2.stocks.quote(symbols="PETR4")
except brapi.AuthenticationError:
    print("Token inválido ou ausente")
except brapi.RateLimitError:
    print("Limite de requisições atingido")
except brapi.APIStatusError as error:
    print(error.status_code, error.message)

const client = new Brapi({ maxRetries: 3 });

client = Brapi(max_retries=3)