Skip to content

README.pt.md

Latest commit

 

History

History
58 lines (37 loc) · 3.93 KB

README.pt.md

File metadata and controls

58 lines (37 loc) · 3.93 KB
Raw

TradingView-API

Experimente com um agente hospedado: Crie um monitor de mercado no Molted Studio — sem instalação local.

Mathieu2301/TradingView-API | #1 Repo Of The Day on Trendshift

Idioma: English · Français · Español · Português

Dados de mercado e indicadores para construir suas ferramentas. Candles, cotações, indicadores e estratégias, em uma única requisição ou em tempo real. Projeto comunitário independente e não oficial.

Tem um problema, uma dúvida ou uma ideia? Abra uma issue. Não é preciso ter uma reprodução perfeita para perguntar.

A versão 4 é uma reescrita completa em TypeScript, com uma nova API e sem camada de compatibilidade. Vindo da v3? Leia o guia de migração (em inglês). Todos os recursos da v3 continuam disponíveis: veja a matriz de cobertura. As versões npm 3.x mantêm a API Client anterior.

Escolha como começar

  • Instalação da V4 beta: clone este repositório e execute npm ci && npm run build && node examples/candles.js (Node.js 20+ ou Bun). O npm ainda entrega a V3, não os imports V4 abaixo. Consulte os exemplos.
  • Com Claude Code, Codex, OpenClaw ou outro assistente: compartilhe este repositório e o guia da API de dados.
  • Sem instalação local: o Molted oferece um espaço de agente hospedado que pode trabalhar a partir deste repositório. É opcional.

API de dados

import { getCandles, watchCandles, getQuote } from '@mathieuc/tradingview/data';

const candles = await getCandles({ symbol: 'BINANCE:BTCUSDT', timeframe: 'D', count: 100 });
console.log(candles.at(-1)); // { time, open, high, low, close, volume }, do mais antigo ao mais recente

const quote = await getQuote('BINANCE:BTCUSDT');

const watcher = await watchCandles({ symbol: 'BINANCE:BTCUSDT', timeframe: '1' }, {
  onData: (snapshot) => console.log(snapshot.at(-1)?.close),
  onError: console.error,
});
await watcher.stop();

Cada função cuida da conexão, do tempo máximo (timeoutMs), do cancelamento (signal) e da limpeza. Outras funções: getQuotes, watchQuotes, getSymbolInfo, getIndicatorData, watchIndicator, searchMarkets, searchIndicators, getTechnicalAnalysis, getScreener, getHotlist, getWatchlists. Detalhes: guia da API de dados.

API de baixo nível

import { TradingViewClient } from '@mathieuc/tradingview';

const client = new TradingViewClient();
const chart = client.createChart();
chart.on('update', () => console.log(chart.lastCandle?.close));
chart.setMarket('BINANCE:BTCUSDT', { timeframe: 'D' });
// Ao terminar: await client.close();

Gráficos, modo replay, estudos Pine e integrados, cotações, contas, desenhos e permissões Pine: veja a referência de baixo nível e os exemplos.

Sem conta, o TradingView limita os dados (menos histórico intraday, sem indicadores Pine). Com seus cookies sessionid e sessionid_sign (credentials), você acessa o que sua conta permite. Guarde-os em variáveis de ambiente, nunca no código, em issues ou prompts.

Repositório GitHub · Pacote npm · Issues

TradingView é uma marca do seu proprietário. Este projeto não é afiliado nem endossado pelo TradingView. Verifique os termos e permissões de dados do seu provedor.