O que DWLF — Plataforma de Análise de Mercado faz?
Base da API: https://api.dwlf.co.uk/v2
Autenticação
Use autenticação via chave de API. Verifique TOOLS.md para a chave. Cabeçalho:
Authorization: ApiKey dwlf_sk_...
Script auxiliar: scripts/dwlf-api.sh
Início Rápido
# Requisição GET genérica
./scripts/dwlf-api.sh GET /market-data/BTC-USD
# Com parâmetros de consulta
./scripts/dwlf-api.sh GET "/events?symbol=BTC-USD&limit=10"
# Requisição POST
./scripts/dwlf-api.sh POST /visual-backtests '{"strategyId":"...","symbol":"BTC-USD"}'
Formato de Símbolo
- Criptomoedas:
BTC-USD,ETH-USD,SOL-USD(sempre com sufixo-USD) - Ações/ETFs:
TSLA,NVDA,META,MARA,RIOT - Forex:
GBP-USD,EUR-USD
Se o usuário disser "BTC" → use BTC-USD. Se "TSLA" → use TSLA.
Endpoints Principais
Dados de Mercado
| Método | Caminho | Descrição |
|---|---|---|
| GET | /market-data/{symbol}?interval=1d&limit=50 | Velas OHLCV |
| GET | /market-data/symbols | Listar todos os símbolos monitorados |
| GET | /support-resistance/{symbol} | Níveis S/R com pontuações |
| GET | /chart-indicators/{symbol}?interval=1d | Todos os indicadores (RSI, EMA, MACD, etc.) |
| GET | /trendlines/{symbol} | Linhas de tendência detectadas automaticamente |
| GET | /events?symbol={symbol}&limit=20 | Eventos do sistema (rompimentos) |
| GET | /events?type=custom_event&scope=user&symbol={symbol}&days=30 | Eventos personalizados do usuário (wcl, dss, reversões, etc.) |
Estratégias e Sinais
| Método | Caminho | Descrição |
|---|---|---|
| GET | /visual-strategies | Listar estratégias do usuário |
| GET | /visual-strategies/{id} | Detalhes da estratégia |
| POST | /visual-strategies | Criar estratégia |
| PUT | /visual-strategies/{id} | Atualizar estratégia |
| GET | /user/trade-signals/active | Sinais de negociação ativos |
| GET | /user/trade-signals/recent?limit=20 | Sinais recentes |
| GET | /user/trade-signals/stats | Estatísticas de desempenho dos sinais |
| GET | /user/trade-signals/symbol/{symbol} | Sinais para um símbolo |
Backtesting
| Método | Caminho | Descrição |
|---|---|---|
| POST | /visual-backtests | Disparar backtest (assíncrono) |
| GET | /visual-backtests/{id} | Obter resultados do backtest |
Backtests são assíncronos — faça POST para disparar, depois consulte GET até que esteja completo.
Portfólio e Trades
| Método | Caminho | Descrição |
|---|---|---|
| GET | /portfolios | Listar portfólios |
| GET | /portfolios/{id} | Detalhes do portfólio + ativos |
| GET | /trades?status=open | Listar trades |
| POST | /trades | Registrar um novo trade |
| PUT | /trades/{id} | Atualizar trade |
| GET | /trade-plans | Listar planos de trade |
Watchlist
| Método | Caminho | Descrição |
|---|---|---|
| GET | /watchlist | Obter watchlist |
| POST | /watchlist | Adicionar símbolo ({"symbol":"BTC-USD"}) |
| DELETE | /watchlist/{symbol} | Remover símbolo |
Eventos Personalizados
| Método | Caminho | Descrição |
|---|---|---|
| GET | /custom-events | Listar eventos personalizados |
| POST | /custom-events | Criar evento personalizado |
| GET | /custom-events/{id} | Detalhes do evento |
Ativação de Símbolos em Eventos Personalizados
| Método | Caminho | Descrição |
|---|---|---|
| POST | /custom-event-symbols/:eventId/enable-all | Ativar símbolos em massa para um evento |
| POST | /custom-event-symbols/:eventId/disable-all | Desativar símbolos em massa para um evento |
| GET | /custom-event-symbols/event/:eventId | Obter símbolos ativos para um evento |
| GET | /custom-event-symbols | Listar todas as associações evento-símbolo |
Ativação de Símbolos em Estratégias
| Método | Caminho | Descrição |
|---|---|---|
| POST | /strategy-symbols/:strategyId/enable-all | Ativar símbolos em massa para uma estratégia |
| POST | /strategy-symbols/:strategyId/disable-all | Desativar símbolos em massa para uma estratégia |
| GET | /strategy-symbols/strategy/:strategyId | Obter símbolos ativos para uma estratégia |
| GET | /strategy-symbols | Listar todas as associações estratégia-símbolo |
Avaliações
| Método | Caminho | Descrição |
|---|---|---|
| POST | /evaluations | Disparar execução de avaliação |
| GET | /evaluations/{id} | Obter resultados da avaliação |
Ativação de Símbolos (Obrigatória Após Criação)
⚠️ IMPORTANTE: Criar um evento personalizado ou estratégia NÃO a ativa automaticamente para nenhum símbolo. Após a criação, você DEVE perguntar ao usuário para quais símbolos ativar e, em seguida, chamar o endpoint de ativação. Sem esta etapa, o evento/estratégia não disparará nem gerará sinais.
Fluxo: Eventos Personalizados
- Criar o evento →
POST /custom-events - Compilar o evento →
POST /custom-events/{id}/compile - Perguntar ao usuário quais símbolos ativar
- Ativar símbolos →
POST /custom-event-symbols/{eventId}/enable-allcom{ "symbols": ["BTC-USD", "ETH-USD"] }
Fluxo: Estratégias
- Criar a estratégia →
POST /visual-strategies - Compilar a estratégia →
POST /visual-strategies/{id}/compile - Perguntar ao usuário quais símbolos ativar
- Ativar símbolos →
POST /strategy-symbols/{strategyId}/enable-allcom{ "symbols": ["BTC-USD", "ETH-USD"] }
Verificando Símbolos Ativos
- Símbolos de eventos:
GET /custom-event-symbols/event/{eventId} - Símbolos de estratégias:
GET /strategy-symbols/strategy/{strategyId} - Todas as ativações:
GET /custom-event-symbolseGET /strategy-symbols(consulta:?activeOnly=true)
Desativando Símbolos
- Evento:
POST /custom-event-symbols/{eventId}/disable-allcom{ "symbols": [...] } - Estratégia:
POST /strategy-symbols/{strategyId}/disable-allcom{ "symbols": [...] }
Formatação de Respostas
Ao apresentar dados aos usuários:
Visão geral do mercado: Mostrar preço, variação percentual, principais níveis S/R e quaisquer eventos recentes.
Sinais: Mostrar símbolo, direção, entrada, stop loss, pontuação de confiança, nome da estratégia.
Níveis S/R: Ordenar por pontuação (mais forte primeiro), mostrar nível e número de toques.
Backtests: Mostrar número de trades, taxa de acerto, retorno total, índice de Sharpe, melhores/piores trades.
Indicadores Disponíveis
EMA (múltiplos períodos), SMA, RSI, MACD, Bandas de Bollinger, DSS (Double Smoothed Stochastic), Stochastic RSI, ATR, ADX, OBV, Perfil de Volume, Nuvem Ichimoku, Retração de Fibonacci, Suporte/Resistência, Linhas de Tendência, Padrões de Candlestick, SMC (Order Blocks, FVGs, BOS/ChoCH).
Academia
A DWLF Academy é uma coleção de conteúdo educacional hospedada em CDN (15 trilhas, mais de 60 aulas) cobrindo indicadores, eventos, estratégias, gráficos e muito mais. Sem autenticação necessária.
Use as ferramentas da academia para ler o conteúdo das aulas e entender os conceitos do DWLF:
dwlf_list_academy_tracks— navegar por todas as trilhas e aulasdwlf_search_academy— pesquisar por palavra-chavedwlf_get_academy_lesson— ler uma aula específica (markdown)
Quando um usuário perguntar "como funciona X no DWLF?" ou "o que é DSS?", verifique primeiro na academia — provavelmente há uma aula explicando.
Referência Detalhada
- Endpoints da API (parâmetros, formatos de resposta): leia
references/api-endpoints.md - Construtor de estratégias (tipos de nós, conexões de arestas, exemplos): leia
references/strategy-builder.md