Smart Money API

Princípios de design

Quatro ideias moldam cada endpoint e cada pontuação que esta API retorna. Elas também são os limites honestos do que ela promete — e do que não promete.

Estratégia primeiro, não sinal primeiro. Este não é um feed de sinais de compra/venda. Você traz a estratégia e a entrada; a API diz se a estrutura de mercado ao redor — posicionamento de derivativos, funding, open interest, liquidações, fluxo on-chain e consenso das baleias — concorda com a trade que você já quer fazer.

Pontuação de confiança, não previsão binária. Cada resposta carrega uma classificação confidence (ALTO / MÉDIO / BAIXO) e uma composite de -1.0 a +1.0. Não há garantias nem chamadas de oráculo — você obtém uma leitura calibrada de concordância, com as razões por trás, para poder dimensionar proporcionalmente à convicção.

Suporte à decisão, não conselho de execução. A API retorna uma recomendação CONFIRMAR / REDUZIR / IGNORAR e um multiplicador de tamanho para sua lógica agir. Ela nunca coloca ordens, e nada aqui é aconselhamento financeiro. Você permanece responsável pelo risco, dimensionamento e execução.

Métricas vivas, não garantias fixas. Taxas de acerto, estatísticas de regime e números de precisão são calculados a partir de uma amostra móvel e mudam conforme os mercados. Nós os publicamos honestamente, inclusive quando são medíocres. Trate cada métrica como uma observação atual, não como uma promessa sobre o futuro.

Para quem esta API é

Esta API é construída para desenvolvedores de bots, algoritmos e agentes de IA em cripto que já têm um sinal de compra/venda — de uma estratégia de TA, um modelo de ML, um pipeline do Freqtrade, um alerta do TradingView ou um agente LLM — e querem uma decisão rápida CONFIRMAR / REDUZIR / IGNORAR antes de alocar capital.

Um loop típico: sua estratégia dispara "comprar BTC" → você chama GET /v1/confirm?symbol=BTC&direction=long → você confirma, reduz ou ignora a entrada e escala o tamanho por size_mult. Uma chamada, resposta JSON única de baixa latência, sem infraestrutura extra.

Ela não é um gerador de sinais independente, um produto de charting ou uma plataforma de execução. Se você não tem um sinal próprio para filtrar, comece com a página de performance para ver como a pontuação se comportou antes de integrá-la a um bot ativo.

Obter acesso

1 — Cadastre-se. Crie uma conta gratuita em signup (e-mail/senha ou Google). Nenhum cartão de crédito é necessário para o plano gratuito.

2 — Acesse seu painel. Seu painel mostra sua chave de API, plano atual e uso em tempo real contra sua cota diária.

3 — Copie sua chave de API. As chaves são prefixadas sm_. Passe-a no X-API-Key cabeçalho em cada requisição (veja Autenticação). Atualize a qualquer momento no página de preços para aumentar limites e desbloquear mais símbolos e endpoints.

Especificação, SDK e Livro de Receitas

Tudo o que você precisa para integrar rapidamente, seja escrevendo o código você mesmo ou delegando a um agente de codificação.

Início rápido em 2 minutos

Passo 1 — URL base. Cada endpoint está disponível em:

Passo 2 — Obtenha sua chave de API. Cadastre-se gratuitamente (sem necessidade de cartão de crédito) e copie sua chave do painel. Passe-a como o X-API-Key cabeçalho em cada requisição.

Passo 3 — Sua primeira chamada. Cole isto no seu terminal e substitua sm_your_key pela chave do seu painel:

Resposta esperada:

Quando confidence é HIGH ou MEDIUM e action é CONFIRM, dimensione o tamanho da sua posição por size_mult. Esse é todo o ciclo de integração. Veja Campos de Resposta para a referência completa de campos.

Autenticação

Todas as requisições exigem uma chave de API passada como o X-API-Key cabeçalho HTTP.

Sua chave de API está disponível no painel após o cadastro. Mantenha sua chave secreta — não a exponha em código do lado do cliente ou repositórios públicos.

Login com Google (Firebase Auth)

Os usuários podem autenticar usando sua conta do Google via Firebase Authentication. Após um login bem-sucedido com Google no cliente, troque o token de ID do Firebase por uma sessão de API vinculada. O sistema sincroniza automaticamente sua identidade do Google com o sistema de chave de API.

Corpo da Requisição

Exemplo de Resposta

Limites de Taxa

Os cabeçalhos de limite de taxa estão incluídos em cada resposta: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset.

URL base

Todos os endpoints abaixo são relativos a esta URL base. Todas as respostas são JSON com Content-Type: application/json.

Erros

Os erros usam códigos de status HTTP padrão e um corpo JSON consistente. Sempre ramifique no código de status, não no texto da resposta. Os três que você encontrará com mais frequência:

Cada erro retorna o mesmo formato:

Para a lista completa de códigos de status (400 / 403 / 500 / 503 e mais), consulte Códigos de Erro. Uma integração robusta trata 5xx e 429 como transitórios (tente novamente com recuo) e 401/402/403 como terminais (corrija a chave ou o plano).

Melhores práticas de segurança

Envie a chave no cabeçalho, nunca na URL. Sempre passe X-API-Key como um cabeçalho HTTP. Chaves em strings de consulta (?key=) são registradas por proxies, balanceadores de carga e histórico do navegador — a autenticação ?key= legada não é mais aceita em endpoints WebSocket por exatamente esse motivo.

Mantenha as chaves no lado do servidor. Nunca incorpore uma chave de API em JavaScript do lado do cliente, um pacote de aplicativo móvel ou um repositório público. Carregue-a de uma variável de ambiente ou gerenciador de segredos. Se uma chave vazar, substitua-a.

Gire as chaves periodicamente. Regenere sua chave do painel em um cronograma e imediatamente se suspeitar de exposição. A chave antiga para de funcionar no momento em que uma nova é emitida.

Use tickets para sockets do navegador. Para transmissões em tempo real do navegador, troque sua chave por um ticket de uso único em vez de conectar com a chave bruta — veja Autenticação WebSocket (tickets).

Usando com agentes de codificação / LLMs

Construindo com Claude Code, Codex, Cursor ou qualquer agente de codificação LLM? Você pode fornecer ao agente tudo o que ele precisa para configurar esta API corretamente de uma só vez. Duas referências legíveis por máquina são publicadas:

Aponte seu agente para o /llms.txt arquivo (a convenção llms.txt) para uma visão geral concisa, depois para a especificação OpenAPI para formas exatas de solicitação/resposta. Um prompt de uma linha que funciona bem:

Veja o Livro de Receitas para uma receita trabalhada de agente de codificação.

Endpoints

GET  /confirm

O endpoint principal. Retorna uma pontuação de confiança composta e uma recomendação de ação para uma determinada direção de negociação. Chame isso antes de entrar em qualquer posição.

Cobertura, em termos simples. /confirm atualmente pontua BTC, ETH e SOL — os símbolos com histórico resolvido suficiente para confirmar honestamente. O screener de derivativos separadamente monitora ~519 mercados de derivativos para dados de financiamento, OI e liquidação, e o rastreamento de baleias cobre mais de 600 carteiras. Pro desbloqueia o screener completo, exportações e cobertura de mercado mais ampla; /confirm o suporte a símbolos é expandido à medida que cada mercado acumula um histórico confiável.

Parâmetros

Exemplo de Solicitação

Exemplo de Resposta

Transparente por design. Cada resposta contém um factors objeto mostrando cada perna do pontuação × peso = ponderada contribuição, um adjustments objeto para ajustes pós-filtro, o weights usado, e um coverage mapa. A perna on-chain usa dados reais e gratuitos da Coin Metrics (MVRV / fluxo de exchange / endereços ativos) quando nenhuma chave Glassnode está definida. Este é um confluência pontuação — suporte à decisão, não uma taxa de vitória garantida.

Símbolos não rastreados são honestos. Um símbolo fora do universo de derivativos/baleias rastreados retorna um "confidence":"NO_DATA" / "action":"NO_DATA_SKIP" com "unsupported":true — nunca um LOW.

Campos de Resposta

GET  /snapshot

Retorna um snapshot completo do mercado, incluindo todas as sub-pontuações, métricas brutas e valores de indicadores para um determinado símbolo. Útil para painéis e registros.

GET  /onchain

Retorna métricas brutas on-chain: MVRV, SOPR, fluxo líquido de exchanges, razão de capitalização realizada e classificação de posição no ciclo.

GET  /v1/derivatives/*

Screener de derivativos entre exchanges com mais de 500 símbolos: mapa de calor de funding rate, rankings de open interest e detecção de sinais de long/short ratio. As 10 primeiras linhas são públicas; o screener completo requer Trader ou Pro. Endpoints: /v1/derivatives/screener, /v1/derivatives/funding, /v1/derivatives/oi, /v1/derivatives/signals.

GET  /v1/options/*

Análises de opções de BTC & ETH da Deribit (público, sem autenticação): razão put/call, max pain e open interest por strike. Endpoints: /v1/options/summary, /v1/options/pcr, /v1/options/oi.

GET  /v1/etf/*

Fluxos líquidos diários de ETFs de BTC & ETH e detalhamento por fundo (público). Endpoints: /v1/etf/flows, /v1/etf/funds.

GET  /v1/historical/*

Dados históricos de funding, open interest, long/short ratio (Binance) e OHLCV (CoinGecko) para backtesting. Endpoints: /v1/historical/funding, /v1/historical/oi, /v1/historical/lsr, /v1/historical/ohlcv.

GET  /v1/dex/*

Pares em alta, busca de tokens e detalhes de pares via DexScreener (público, sem autenticação). Endpoints: /v1/dex/trending, /v1/dex/search, /v1/dex/token, /v1/dex/pair.

GET  /v1/news/*

Inteligência de notícias: políticas/geopolíticas/cripto classificadas por impacto, mais Fear & Greed (público, sem autenticação). Endpoints: /v1/news/trump, /v1/news/general, /v1/news/impact, /v1/news/fear-greed.

GET  /whales

Retorna dados de consenso de carteiras de baleias: divisão long/short, exposição notional total, top 10 posições (apenas Pro) e contagem de carteiras.

GET  /signals

Retorna um fluxo dos sinais HIGH/MEDIUM mais recentes em todos os ativos monitorados. Útil para busca de oportunidades.

GET  /v1/strategies/*

Registro transparente e somente leitura das estratégias de trading automatizadas que executam sobre os sinais Smart Money — incluindo a deriv40 Estratégia SmartMoney Copytrade (account=9). Todos os endpoints aceitam um ?account=<id> parâmetro de consulta e retornam JSON. Sem autenticação necessária (registro público).

Endpoints

• GET /v1/strategies/stats?account=9 — métricas principais: total_trades, win_rate, profit_factor, total_pnl_usdt, account_growth_percent, initial_equity, current_equity, max_drawdown_portfolio, max_drawdown_trade.
• GET /v1/strategies/equity?account=9 — curva de equity para gráficos: { initial_equity, curve: [{ time, equity }] }.
• GET /v1/strategies/trades?account=9&limit=500 — registro de trades fechados: array (ou {trades:[…]}) de symbol, direction, entry_price, exit_price, pnl_usdt, pnl_percent, pnl_percent_net.
• GET /v1/strategies/active?account=9 — posições abertas atualmente: array (ou {positions:[…]}) de symbol, side/direction, entry_price, unrealized_pnl.
• GET /v1/strategies/signals — detalhamento por tipo de sinal alimentando as estratégias (contagem / vitórias / taxa de acerto / pnl médio por tipo de sinal).

Performance passada não é indicativa de resultados futuros. Dados são backfillados em um único regime de ~3 meses mais trades ao vivo e são mostrados pré-taxa onde indicado.

GET  /export

Baixe dados históricos de sinais como CSV para backtesting. Parâmetros: symbol, from (unix ts), to (unix ts).

GET  /health

Verificação de saúde do sistema. Retorna atualização dos dados de cada fonte e status geral da API. Sem autenticação necessária.

GET  /usage

Retorna suas estatísticas de uso da API: chamadas hoje, totais mensais, limites de cota e horários de reset.

POST  /webhooks

Registre uma URL HTTPS para receber pushes de eventos assinados em tempo real quando um sinal for disparado em seus ativos monitorados. Entregas incluem um X-SmartMoney-Event cabeçalho e uma assinatura HMAC-SHA256 em X-SmartMoney-Signature, com até 3 tentativas de retry com backoff.

Corpo da Requisição

Verificando a assinatura

A chave HMAC é o digest SHA-256 em hex do seu segredo registrado. Calcule o HMAC-SHA256 do corpo da requisição bruta com essa chave e compare (tempo constante) contra X-SmartMoney-Signature. Veja o Guia de Implementação de Webhook.

Inteligência

GET  /analysis

Retorna a classificação do regime de mercado com detecção de conflito de sinais, alimentada por IA. Analisa a concordância entre sinais, identifica divergências entre derivativos, dados on-chain e de baleias, e produz um resumo em linguagem natural com fatores de risco prospectivos e uma recomendação com horizonte temporal.

Parâmetros

Exemplo de Resposta

GET  /liquidations

Retorna duas visões complementares: (1) projeção de alavancagem levels — uma estimativa de onde os clusters de liquidação estão; e (2) um realized_heatmap — a intensidade REAL executada de liquidação forçada (preço × tempo), agregada em tempo real a partir de feeds WebSocket de exchanges públicas: Binance, OKX, Bybit, Bitget, BitMEX. O heatmap está presente quando o stream tem dados para o símbolo (ausente em um mercado muito calmo ou logo após a inicialização).

Parâmetros

Exemplo de Resposta

GET  /liquidations/heatmap

Público mapa de calor de liquidação por nível de preço. Retorna uma matriz estilo Coinglass de preço × tempo de REAL executado liquidações forçadas, agrupadas pelo preço em que cada liquidação foi registrada — agregado ao vivo de feeds WebSocket públicos de exchanges: Binance, OKX, Bybit, Bitget, BitMEX. O clusters array é a saída prática: intervalos de preço classificados por valor nocional liquidado, cada um marcado com seu lado dominante. Os dados dependem do fluxo ao vivo — um símbolo muito tranquilo ou um gateway recém-reiniciado retorna a estrutura vazia bem formada mais um note. Os níveis mostrados são apenas liquidações reais, nunca estimadas.

Parâmetros

Exemplo de Resposta

GET  /liquidations/onchain

Executadas liquidações on-chain de empréstimos DeFi capturadas diretamente dos nossos próprios nós completos de BSC + Avalanche — independente de qualquer bot de trading. Cobre Venus/Cream e Moolah na BSC, e AAVE V3/V2, Benqi, BankerJoe, Granary e Vinium na Avalanche. O nível Pro adicionalmente retorna at_risk posições (dependente de bot, pode estar ausente).

Parâmetros

Exemplo de Resposta

GET  /smart-stop

Calcula níveis inteligentes de stop-loss com base no mapa de calor de liquidação atual, bandas de volatilidade e estrutura de mercado. Retorna recomendações de stop em camadas e sugestões de take-profit calibradas para o seu preço de entrada e tolerância ao risco.

Parâmetros

Exemplo de Resposta

GET  /funding-arb

Identifica oportunidades de arbitragem de taxas de funding entre exchanges em tempo real. Retorna oportunidades classificadas com rendimento anualizado estimado, par de exchanges ideal e ação de hedge necessária para capturar o spread.

Parâmetros

Exemplo de Resposta

Variante pública gratuita Sem autenticação

Um endpoint público sem chave retorna as 10 melhores oportunidades com um screener cross-exchange ao vivo, ideal para incorporação ou verificações rápidas. Remove histórico de spread por símbolo e campos pesados, sendo servido de um cache de 120 segundos. Quando não há spreads de funding cross-exchange na janela de atualização, retorna um opportunities array vazio com um note — nunca dados fabricados.

GET  /smart-money/flow

Um índice direcional ponderado por qualidade de baleias por símbolo, pontuado -100 (dinheiro de baleias inclinado para venda) até +100 (inclinado para compra). Construído a partir de milhares de carteiras de baleias rastreadas na Hyperliquid — cada uma ponderada por seu próprio histórico de taxa de acerto e PnL, e decaída pela recência. Este é um índice de posicionamento, não um sinal de compra/venda ou previsão de preço. Símbolos com poucas carteiras contribuintes são marcados thin e pontuados honestamente. Página ao vivo: smart-money-flow.html.

Parâmetros

Exemplo de Resposta

GET  /v1/whales/crowding

Contexto combinado de posicionamento de baleias e aglomeração por símbolo, mesclado entre Hyperliquid + GMX v2 + Jupiter Perps. Retorna notional bruto/líquido, viés direcional, contagem de carteiras e plataformas, concentração de posição (participação dos top-3 + HHI), uma alavancagem média ponderada e intervalos de proximidade de liquidação ($ notional dentro de 5% e 10% do preço de liquidação estimado, dividido em compra/venda). Isto é contexto, não um sinal direcional. Campos que não são deriváveis são null e renderizados como — — ex. lev_wavg/crowding_index quando nenhuma posição possui alavancagem. As distâncias de liquidação são uma estimativa de margem isolada (pct_to_liq ≈ 1/lev + upnl/notional − mmr, mmr = 0.01), não preços de liquidação reportados pela exchange.

Parâmetros

Exemplo de Requisição

Exemplo de Resposta

GET  /v1/options/gex

Dealer exposição gama (GEX) análises para BTC & ETH, calculadas ao vivo a partir da cadeia de opções públicas da Deribit (sem autenticação). Retorna o GEX líquido do dealer por strike (convenção SpotGamma dealer-short), o nível de flip gama (strike onde o GEX líquido acumulado cruza zero), a estrutura temporal da IV (volatilidade implícita ATM por dias até o vencimento), e uma inclinação da IV (reversão de risco proxy de 25Δ). O regime GEX é positive (dealers long gamma → supressão de volatilidade) ou negative (amplificação de volatilidade). Totalmente autossuficiente — recalculado a cada chamada, sem dependência de banco de dados armazenado.

Parâmetros

Exemplo de Solicitação

Exemplo de Resposta

GET  /v1/liquidations/simulate

Interativo teste de estresse de cascata de liquidação. Dada uma movimentação hipotética de preço, retorna as posições alavancadas estimadas que seriam liquidadas, volume forçado por nível de preço/lado/exchange e uma leitura de profundidade da cascata. Uma movimentação para baixo liquida longs cujo preço de liq. está no/acima do alvo; uma movimentação para cima liquida shorts cujo preço de liq. está no/abaixo dele. Dois métodos independentes são combinados: preços exatos de liquidação de baleias do Hyperliquid rastreadas com alavancagem/entrada real , mais clusters estatísticos de faixas de OI por exchange (alavancagem da multidão inferida do funding). Tudo é claramente rotulado estimated: true — não pode saber a margem por conta, cruzada vs isolada, margem adicional ou ADL.

Parâmetros

Exemplo de Requisição

Exemplo de Resposta

GET  /v1/wallet/{addr}/profile

Um perfil de carteira multi-plataforma construído inteiramente a partir dos snapshots de posição de baleias rastreadas ao vivo. Para uma baleia Hyperliquid rastreada, retorna as posições abertas atuais, uma série temporal de PnL não realizado/exposição/contagem de posições série temporal, uma linha do tempo de atividade OPEN/CLOSE/FLIP (reconstruída pela diferença entre snapshots consecutivos), o rótulo decodificado do leaderboard da HL e um resumo do livro de ofertas. Página ao vivo: wallet-profiler.html.

Parâmetros

Exemplo de Requisição

Exemplo de Resposta

GET  /flows

Retorna dados de fluxo de capital entre ativos, mostrando padrões de rotação entre BTC, ETH e SOL em múltiplas janelas de tempo. Útil para identificar qual ativo está acumulando capital e qual está sendo distribuído em um dado momento.

Exemplo de Resposta

GET  /whale-events

Retorna mudanças significativas em posições de baleias — aberturas, fechamentos e inversões de direção — detectadas em carteiras rastreadas e endereços on-chain na janela de retrospectiva especificada.

Parâmetros

Exemplo de Resposta

GET  /regimes/history

Retorna dados históricos de classificação de regime para um ativo específico. Use isso para backtestar o desempenho histórico de tipos de regime específicos, quanto tempo cada tipo de regime normalmente dura e como as transições de regime ocorrem ao longo do tempo.

Parâmetros

Exemplo de Resposta

GET  /exchange-health

Retorna o status de saúde em tempo real para todas as exchanges monitoradas, incluindo latência por exchange, taxas de erro e indicadores de dados desatualizados. Nenhuma autenticação necessária — endpoint publicamente acessível.

Exemplo de Resposta

GET  /sentiment

Retorna um índice de Medo & Ganância (0-100) em tempo real, calculado a partir do sentimento de derivativos, atividade de baleias, volatilidade e sinais sociais. Inclui detalhamento por componente e histórico de 24 horas para análise de tendência.

Parâmetros

Exemplo de Resposta

Integrações

GET  /tradingview/setup

Retorna sua configuração personalizada de integração com o TradingView: URL do webhook, segredo para validação e indicadores Pine Script prontos para uso que se conectam diretamente à Smart Money API. Copie e cole o Pine Script no TradingView para sobrepor nossos sinais em qualquer gráfico.

Exemplo de Resposta

POST  /tradingview/webhook

Recebe um alerta do TradingView, processa-o através /confirm, e retorna a confirmação. O TradingView não pode enviar cabeçalhos personalizados, então autentique incluindo seu webhook secret no corpo JSON (este endpoint não usa X-API-Key). A resposta encapsula a confirmação e adiciona um nível superior action de CONFIRMED (confiança do daemon HIGH/MEDIUM) ou VETOED.

Corpo da Requisição

Obrigatório: secret, symbol, direction (long|short). Opcional: source, timeframe, strategy, price.

Personalização

GET  /preferences

Retorna suas configurações de personalização atuais, incluindo parâmetros padrão de negociação, perfil de risco, lista de observação e preferências de notificação.

Atualize as preferências enviando um corpo JSON com qualquer subconjunto dos campos abaixo. Campos omitidos mantêm seus valores atuais.

Campos de Preferência

GET  /watchlist

Retorna um snapshot do status de confirmação e métricas de risco principais para todos os símbolos na sua watchlist configurada. Fornece uma visão geral de múltiplos ativos sem a necessidade de chamadas /confirm separadas para cada símbolo.

Exemplo de Resposta

Streaming em Tempo Real (Swaps ao Vivo)

Stream de swaps DEX ≥ $500 detectados em tempo real a partir dos nossos próprios nós BSC e Avalanche. Dois transportes estão disponíveis: um stream público de Server-Sent Events (SSE) para clientes gratuitos/navegadores, e um firehose WebSocket de baixa latência para planos pagos. Os eventos são transmitidos em segundos após a inclusão em um bloco.

Stream Público SSE (Gratuito)

Nenhuma autenticação necessária. Suporte nativo EventSource em todos os navegadores modernos. O servidor emite swap eventos e batimentos periódicos para manter a conexão ativa.

WebSocket Firehose (Pago)

Autenticação (recomendado): nunca coloque sua chave de longa duração na URL — ela é registrada por proxies e salva no histórico do navegador. Em vez disso, POST sua chave para /v1/ws/ticket usando o cabeçalho seguro X-API-Key , então abra o socket com o ticket de uso único retornado ticket (válido por ~60s, resgatado uma vez). Clientes do lado do servidor que podem definir cabeçalhos podem passar X-API-Key diretamente no handshake. Chaves de nível gratuito recebem uma 402 payment_required resposta. Um hello frame é enviado na conexão com seu nível e o limite de transmissão.

Autenticação WebSocket (tickets)

Por que: nunca coloque sua chave de API em uma URL WebSocket — strings de consulta são registradas por proxies, balanceadores de carga e salvas no histórico do navegador. Em vez disso, troque sua chave por um ticket de curta duração e uso único ticket por meio de um POST autenticado normal, então conecte-se com esse ticket.

Fluxo: POST para /v1/ws/ticket com seu X-API-Key cabeçalho → receba { "ticket": "…", "expires_in": 60 }. Então abra wss://api.smartmoneyapi.com/v1/ws/live-swaps?ticket=<ticket>O ticket é de uso único e expira em ~60 segundosClientes do lado do servidor que podem definir cabeçalhos de solicitação podem passar X-API-Key diretamente no handshake do WebSocket — nenhum ticket necessário.

Gera um ticket único para um handshake WebSocket autenticado. Autentique com o X-API-Key cabeçalho (sua chave nunca sai dos cabeçalhos da solicitação). O ticket retornado pode ser resgatado uma vez em /v1/ws/live-swaps antes de expirar.

Exemplo de Resposta

Campos de Resposta

Nota: a autenticação legada por ?key= parâmetro de consulta é não mais aceita nos endpoints WebSocket por razões de segurança. Use um ticket (clientes de navegador) ou o X-API-Key cabeçalho de handshake (clientes do lado do servidor).

Snapshot REST

Retorna os últimos N swaps transmitidos do buffer rolante. Útil para primeira renderização em painéis antes da abertura da conexão de stream. Também disponível: /v1/live-swaps/status para estatísticas de transmissão.

Esquema de Evento

POST  /alerts/conditions

Crie regras de alerta personalizadas que são acionadas quando uma métrica especificada ultrapassa um limite. Os alertas são entregues via webhook, e-mail ou feed de notificações do painel, dependendo de suas preferências.

Retorna uma lista de todas as suas condições de alerta configuradas com seus IDs, definições e status atual.

Remove permanentemente uma condição de alerta pelo seu ID.

Retorna eventos recentes de acionamento de alerta com carimbos de data/hora, condições correspondentes e o valor da métrica no momento do acionamento.

Criar Alerta — Corpo da Solicitação

A lista ao vivo de métricas e operadores válidos é retornada por GET /v1/alerts/conditions como available_metrics e available_operators.

Métricas Disponíveis

GET  /kelly

Retorna recomendações de dimensionamento de posição pelo Critério de Kelly calibradas para o desempenho histórico do sinal para o símbolo, nível de confiança e direção. Baseia o tamanho da posição em taxas de vitória empíricas para evitar alavancagem excessiva.

Parâmetros

Exemplo de Resposta

GET  /performance

Retorna estatísticas históricas de precisão para sinais emitidos pela API, divididas por nível de confiança. Útil para entender a confiabilidade dos sinais antes de alocar capital.

Parâmetros

Exemplo de Resposta

Estatísticas & Sinais

GET  /v1/stats

Estatísticas de desempenho honestas em todo o site, provenientes de smart_money_confirm resultados de chamadas distintas. Retorna taxas de acerto nos níveis de confiança HIGH e MEDIUM, precisão geral, fator de lucro e um detalhamento por símbolo. Todos os números são in-sample durante a janela de pontuação; consulte calibration.html para contexto e metodologia de forward-holdout.

Exemplo de Resposta

GET  /v1/signals/performance

Acompanhamento de resultados de sinais em múltiplos horizontes de resolução (4h, 12h, 24h, 72h). Retorna taxas de acerto por horizonte, contagem total de sinais e um detalhamento por tipo de sinal.

Parâmetros

Exemplo de Resposta

GET  /v1/signals/recent

Feed de sinais HIGH e MEDIUM recentemente publicados em todos os símbolos monitorados. Cada entrada inclui o tipo de sinal, nível de confiança, direção e status de resolução, quando disponível.

Exemplo de Resposta

GET  /v1/signals/{id}/outcome

Resultado resolvido para um único sinal pelo seu ID numérico. Retorna acerto/erro em cada horizonte de resolução (4h, 12h, 24h, 72h) junto com o preço no momento do sinal e na resolução.

Parâmetros

Exemplo de Resposta

GET  /v1/confirm-winrate

Detalhamento da taxa de vitória de sinais de confirmação para a chave de API autenticada do próprio usuário. Retorna taxas de vitória de chamadas distintas em cada nível de confiança, fator de lucro e números por símbolo. Requer um cabeçalho válido. X-API-Key cabeçalho.

Exemplo de Solicitação

Exemplo de Resposta

Shadow Gate

Um livro-razão pessoal imutável e somente de acréscimo. Envie suas decisões de negociação antes ou depois de executá-las; o sistema calcula uma pontuação de confirmação contra o mecanismo Smart Money e acrescenta uma linha permanente. Use-o para construir um registro honesto e carimbado no tempo de como o sinal da API se alinhou com suas próprias entradas — totalmente independente do pool global de taxa de acerto. As respostas das camadas Grátis e Trader têm os campos de evidência removidos; a camada Pro retorna a análise completa. Um atraso de camada se aplica aos dados da camada Grátis.

Envie uma decisão. Idempotente no Idempotency-Key cabeçalho da solicitação — reenviar a mesma chave retorna a linha existente sem criar uma duplicata. O sistema chama imediatamente o mecanismo de confirmação e acrescenta o resultado como uma linha imutável no livro-razão.

Corpo da Solicitação

Exemplo de Solicitação

Exemplo de Resposta

Liste suas próprias decisões do shadow-gate, as mais recentes primeiro. Escopo do proprietário — apenas as decisões enviadas pela sua chave de API são retornadas.

Parâmetros

Exemplo de Resposta

Decisão única por ID, incluindo todas as evidências de confirmação para o nível Pro. As respostas dos níveis Free e Trader têm factors e adjustments removidos. Retorna 403 se a decisão pertence a uma chave de API diferente.

Exemplo de Resposta (Pro)

Resolva manualmente o resultado de uma decisão. Chame isso após fechar a negociação para registrar o resultado final na linha do ledger. Uma vez resolvida, a linha é imutável e não pode ser alterada novamente.

Corpo da Requisição

Exemplo de Resposta

Códigos de Erro

Exemplos de Código

Python

JavaScript / Node.js

cURL

Integração Freqtrade

Adicione a confirmação do Smart Money a qualquer estratégia do Freqtrade substituindo o confirm_trade_entry método.

CCXT + Smart Money