Smart Money API

Principes de conception

Quatre idées façonnent chaque point de terminaison et chaque score renvoyé par cette API. Ce sont aussi les limites honnêtes de ce qu'elle promet — et ne promet pas.

Stratégie d'abord, pas signal d'abord. Ce n'est pas un flux de signaux d'achat/vente. Vous apportez la stratégie et l'entrée ; l'API vous dit si la structure du marché environnante — positionnement dérivé, financement, intérêt ouvert, liquidations, flux on-chain et consensus des baleines — est en accord avec le trade que vous souhaitez déjà prendre.

Score de confiance, pas de prédiction binaire. Chaque réponse porte une note confidence (HAUT / MOYEN / BAS) et un composite de -1.0 à +1.0. Il n'y a aucune garantie et aucun appel d'oracle — vous obtenez une lecture calibrée de l'accord, avec les raisons qui le sous-tendent, afin que vous puissiez ajuster proportionnellement à la conviction.

Support de décision, pas de conseil d'exécution. L'API renvoie une recommandation CONFIRMER / RÉDUIRE / SAUTER et un multiplicateur de taille pour votre logique à appliquer. Elle ne passe jamais d'ordres, et rien ici n'est un conseil financier. Vous restez responsable du risque, de la taille et de l'exécution.

Métriques vivantes, pas de garanties fixes. Les taux de réussite, les statistiques de régime et les chiffres de précision sont calculés à partir d'un échantillon mobile et évoluent avec les marchés. Nous les publions honnêtement, y compris lorsqu'ils sont médiocres. Considérez chaque métrique comme une observation actuelle, pas une promesse sur l'avenir.

Pour qui cette API est-elle conçue ?

Cette API est conçue pour les développeurs de bots, algorithmes et agents IA en crypto qui ont déjà un signal long/court — provenant d'une stratégie TA, d'un modèle ML, d'un pipeline Freqtrade, d'une alerte TradingView ou d'un agent LLM — et qui souhaitent une décision rapide avant trade CONFIRMER / RÉDUIRE / SAUTER avant d'engager du capital.

Une boucle typique : votre stratégie déclenche "aller long sur BTC" → vous appelez GET /v1/confirm?symbol=BTC&direction=long → vous confirmez, réduisez ou sautez l'entrée et ajustez la taille par size_mult. Un appel, une seule réponse JSON à faible latence, aucune infrastructure supplémentaire.

Ce n'est pas un générateur de signaux autonome, un produit de charting ou un lieu d'exécution. Si vous n'avez pas de signal propre à filtrer, commencez par la page de performance pour voir comment le score s'est comporté avant de l'intégrer dans un bot en direct.

Obtenir l'accès

1 — Inscrivez-vous. Créez un compte gratuit sur inscription (email/mot de passe ou Google). Aucune carte de crédit n'est requise pour le niveau gratuit.

2 — Ouvrez votre tableau de bord. Votre tableau de bord affiche votre clé API, votre plan actuel et votre utilisation en direct par rapport à votre quota quotidien.

3 — Copiez votre clé API. Les clés sont préfixées sm_. Passez-la en tant que X-API-Key en-tête sur chaque requête (voir Authentification). Mettez à niveau à tout moment sur le page de tarification pour augmenter les limites et débloquer plus de symboles et de points de terminaison.

Spec, SDK & Guide

Tout ce dont vous avez besoin pour intégrer rapidement, que vous écriviez le code vous-même ou le confiiez à un agent de codage.

Démarrage rapide en 2 minutes

Étape 1 — URL de base. Chaque point de terminaison se trouve sous :

Étape 2 — Obtenez votre clé API. Inscrivez-vous gratuitement (aucune carte de crédit requise) et copiez votre clé depuis le tableau de bord. Passez-la dans l'en-tête X-API-Key pour chaque requête.

Étape 3 — Votre premier appel. Collez ceci dans votre terminal et remplacez sm_your_key par la clé de votre tableau de bord :

Réponse attendue :

Quand confidence est HIGH ou MEDIUM et action est CONFIRM, ajustez la taille de votre position par size_mult. C'est toute la boucle d'intégration. Voir Champs de Réponse pour la référence complète des champs.

Authentification

Toutes les requêtes nécessitent une clé API passée dans l'en-tête X-API-Key HTTP.

Votre clé API est disponible sur le tableau de bord après inscription. Gardez votre clé secrète — ne l'exposez pas dans du code côté client ou des dépôts publics.

Connexion Google (Firebase Auth)

Les utilisateurs peuvent s'authentifier avec leur compte Google via Firebase Authentication. Après une connexion Google réussie côté client, échangez le jeton d'ID Firebase contre une session API liée. Le système synchronise automatiquement votre identité Google avec le système de clé API.

Corps de la Requête

Exemple de Réponse

Limites de Taux

Les en-têtes de limite de taux sont inclus dans chaque réponse : X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset.

URL de base

Tous les points de terminaison ci-dessous sont relatifs à cette URL de base. Toutes les réponses sont au format JSON avec Content-Type: application/json.

Erreurs

Les erreurs utilisent des codes de statut HTTP standard et un corps JSON cohérent. Toujours baser la décision sur le code de statut, et non sur le texte de la réponse. Les trois que vous rencontrerez le plus souvent :

Chaque erreur renvoie la même forme :

Pour la liste complète des codes de statut (400 / 403 / 500 / 503 et plus), consultez Codes d'erreur. Une intégration robuste traite les 5xx et 429 comme transitoires (réessayer avec recul) et 401/402/403 comme terminaux (corriger la clé ou le plan).

Meilleures pratiques de sécurité

Envoyez la clé dans l'en-tête, jamais dans l'URL. Toujours passer X-API-Key comme en-tête HTTP. Les clés dans les chaînes de requête (?key=) sont enregistrées par les proxies, les répartiteurs de charge et l'historique du navigateur — l'ancien ?key= auth n'est plus accepté sur les points de terminaison WebSocket pour cette raison précise.

Gardez les clés côté serveur. Ne jamais intégrer une clé API dans du JavaScript côté client, un bundle d'application mobile ou un référentiel public. Chargez-la à partir d'une variable d'environnement ou d'un gestionnaire de secrets. Si une clé fuit, faites-la pivoter.

Faites pivoter les clés périodiquement. Regénérez votre clé depuis le tableau de bord selon un calendrier et immédiatement si vous soupçonnez une exposition. L'ancienne clé cesse de fonctionner au moment où une nouvelle est émise.

Utilisez des tickets pour les sockets navigateurs. Pour les flux en temps réel depuis le navigateur, échangez votre clé contre un ticket à usage unique plutôt que de vous connecter avec la clé brute — voir Authentification WebSocket (tickets).

Utilisation avec des agents de codage / LLMs

Vous construisez avec Claude Code, Codex, Cursor ou tout agent de codage LLM ? Vous pouvez donner à l'agent tout ce dont il a besoin pour connecter correctement cette API en une seule fois. Deux références lisibles par machine sont publiées :

Dirigez votre agent vers le /llms.txt fichier (la convention llms.txt) pour un aperçu concis, puis la spécification OpenAPI pour les formes exactes des requêtes/réponses. Une invite en une ligne qui fonctionne bien :

Voir le Livre de cuisine pour une recette détaillée d'agent de codage.

Points de terminaison

GET  /confirm

Le point de terminaison principal. Renvoie un score de confiance composite et une recommandation d'action pour une direction de trade donnée. Appelez ceci avant d'entrer dans toute position.

Couverture, en termes simples. /confirm actuellement évalue BTC, ETH et SOL — les symboles avec suffisamment d'historique résolu pour confirmer honnêtement. Le screener de dérivés surveille séparément ~519 marchés de dérivés pour les données de financement, d'OI et de liquidation, et le suivi des baleines couvre plus de 600 portefeuilles. Pro débloque le screener complet, les exports et une couverture de marché plus large ; /confirm le support des symboles est étendu à mesure que chaque marché accumule un historique fiable.

Paramètres

Exemple de requête

Exemple de réponse

Transparent par conception. Chaque réponse inclut un factors objet montrant le score × poids = contribution pondérée de chaque composante, un objet pour ajustements post-filtre, les adjustments utilisés, et une weights carte. La composante on-chain utilise coverage les données gratuites de Coin Metrics (MVRV / flux d'échange / adresses actives) quand aucune clé Glassnode n'est définie. Il s'agit d'un score de confluence multifactorielle — aide à la décision, pas un taux de réussite garanti. Les symboles non suivis sont honnêtes..

Un symbole hors de l'univers suivi (dérivés/baleines) renvoie une réponse explicite avec "confidence":"NO_DATA" / "action":"NO_DATA_SKIP" — jamais une valeur "unsupported":true fabriquée. LOW.

Champs de réponse

GET  /snapshot

Retourne un instantané complet du marché incluant tous les sous-scores, métriques brutes et valeurs d'indicateurs pour un symbole donné. Utile pour les tableaux de bord et la journalisation.

GET  /onchain

Retourne des métriques brutes on-chain : MVRV, SOPR, flux net des exchanges, ratio de capitalisation réalisée et classification de position cyclique.

GET  /v1/derivatives/*

Screener de dérivés multi-exchange pour 500+ symboles : heatmap des taux de funding, classement de l'open interest et détection de signaux long/short ratio. Les 10 premières lignes sont publiques ; le screener complet nécessite Trader ou Pro. Endpoints : /v1/derivatives/screener, /v1/derivatives/funding, /v1/derivatives/oi, /v1/derivatives/signals.

GET  /v1/options/*

Analytiques d'options BTC & ETH sourcées par Deribit (public, sans auth) : ratio put/call, max pain et open interest par strike. Endpoints : /v1/options/summary, /v1/options/pcr, /v1/options/oi.

GET  /v1/etf/*

Flux nets quotidiens des ETF BTC & ETH spot et répartition par fonds (public). Endpoints : /v1/etf/flows, /v1/etf/funds.

GET  /v1/historical/*

Données historiques de funding, open interest, long/short ratio (Binance) et OHLCV (CoinGecko) pour backtesting. Endpoints : /v1/historical/funding, /v1/historical/oi, /v1/historical/lsr, /v1/historical/ohlcv.

GET  /v1/dex/*

Paires tendances via DexScreener, recherche de tokens et détails des paires (public, sans auth). Endpoints : /v1/dex/trending, /v1/dex/search, /v1/dex/token, /v1/dex/pair.

GET  /v1/news/*

Veille d'actualités : classement des news politiques/géopolitiques/crypto par impact, plus Fear & Greed (public, sans auth). Endpoints : /v1/news/trump, /v1/news/general, /v1/news/impact, /v1/news/fear-greed.

GET  /whales

Retourne les données de consensus des wallets whales : répartition long/short, exposition notionnelle totale, top 10 positions (Pro uniquement) et nombre de wallets.

GET  /signals

Retourne un flux des signaux récents HIGH/MEDIUM sur tous les assets surveillés. Utile pour la détection d'opportunités.

GET  /v1/strategies/*

Historique transparent en lecture seule des stratégies de trading automatisé exécutées sur la base des signaux Smart Money — incluant la deriv40 stratégie SmartMoney Copytrade (account=9). Tous les endpoints acceptent un ?account=<id> paramètre de requête et retournent du JSON. Aucune authentification requise (historique public).

Endpoints

• GET /v1/strategies/stats?account=9 — métriques principales : 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 — courbe d'équité pour graphique : { initial_equity, curve: [{ time, equity }] }.
• GET /v1/strategies/trades?account=9&limit=500 — registre des trades clôturés : tableau (ou {trades:[…]}) de symbol, direction, entry_price, exit_price, pnl_usdt, pnl_percent, pnl_percent_net.
• GET /v1/strategies/active?account=9 — positions actuellement ouvertes : tableau (ou {positions:[…]}) de symbol, side/direction, entry_price, unrealized_pnl.
• GET /v1/strategies/signals — répartition par type de signal alimentant les stratégies (nombre / gains / taux de réussite / pnl moyen par type).

Les performances passées ne préjugent pas des résultats futurs. Les chiffres sont backfillés sur un régime unique de ~3 mois plus des trades live et sont affichés pré-frais où indiqué.

GET  /export

Téléchargez les données historiques de signaux en CSV pour backtesting. Paramètres : symbol, from (unix ts), to (unix ts).

GET  /health

Vérification de l'état du système. Retourne la fraîcheur des données pour chaque source et le statut global de l'API. Aucune authentification requise.

GET  /usage

Retourne vos statistiques d'utilisation actuelles de l'API : appels aujourd'hui, totaux mensuels, limites de quota et heures de réinitialisation.

POST  /webhooks

Enregistrez une URL HTTPS pour recevoir des notifications d'événements signés en temps réel lorsqu'un signal est déclenché sur vos assets surveillés. Les livraisons incluent un X-SmartMoney-Event en-tête et une signature HMAC-SHA256 dans X-SmartMoney-Signature, avec jusqu'à 3 tentatives de réessai avec backoff.

Corps de la requête

Vérification de la signature

La clé HMAC est le digest hexadécimal SHA-256 de votre secret enregistré. Calculez le HMAC-SHA256 du corps brut de la requête avec cette clé et comparez (en temps constant) avec X-SmartMoney-SignatureVoir le Guide d'implémentation des webhooks.

Intelligence

GET  /analysis

Retourne une classification des régimes de marché alimentée par l'IA avec détection de conflits de signaux. Analyse l'accord entre les signaux croisés, identifie les divergences entre les dérivés, les données on-chain et les données des baleines, et produit un résumé en langage naturel avec des facteurs de risque prospectifs et une recommandation temporelle.

Paramètres

Exemple de réponse

GET  /liquidations

Retourne deux vues complémentaires: (1) projeté par levier levels — une estimation de où se trouvent les clusters de liquidation ; et (2) une realized_heatmap — l'intensité RÉELLE exécutée des liquidations forcées (prix × temps), agrégée en direct à partir des flux WebSocket des échanges publics : Binance, OKX, Bybit, Bitget, BitMEX. La heatmap est présente lorsque le flux contient des données pour le symbole (absente dans un marché très calme ou juste après le démarrage).

Paramètres

Exemple de réponse

GET  /liquidations/heatmap

Public heatmap de liquidation par niveau de prix. Retourne une matrice de prix × temps de style Coinglass des RÉELLES exécutées liquidations forcées, regroupées par le prix auquel chaque liquidation a été enregistrée — agrégée en direct à partir des flux WebSocket des échanges publics : Binance, OKX, Bybit, Bitget, BitMEX. Le clusters tableau est la sortie pratique : les compartiments de prix classés par notionnel liquidé, chacun étiqueté avec son côté dominant. Les données dépendent du flux en direct — un symbole très calme ou une passerelle juste redémarrée retourne la structure vide bien formée plus une note. Les niveaux affichés sont uniquement des liquidations réelles, jamais estimées.

Paramètres

Exemple de réponse

GET  /liquidations/onchain

Exécutées liquidations de prêts DeFi on-chain capturées directement depuis nos propres nœuds complets BSC + Avalanche — indépendant de tout bot de trading. Couvre Venus/Cream et Moolah sur BSC, et AAVE V3/V2, Benqi, BankerJoe, Granary et Vinium sur Avalanche. Le niveau Pro retourne en plus at_risk positions (dépendantes du bot, peuvent être absentes).

Paramètres

Exemple de réponse

GET  /smart-stop

Calcule des niveaux de stop-loss intelligents basés sur la carte de chaleur de liquidation actuelle, les bandes de volatilité et la structure du marché. Retourne des recommandations de stop échelonnées et des suggestions de prise de bénéfices calibrées selon votre prix d'entrée et votre tolérance au risque.

Paramètres

Exemple de réponse

GET  /funding-arb

Identifie en temps réel les opportunités d'arbitrage de taux de financement inter-exchange. Retourne des opportunités classées avec un rendement annualisé estimé, la paire d'exchanges optimale et l'action de couverture nécessaire pour capturer l'écart.

Paramètres

Exemple de réponse

Variante publique gratuite Pas d'authentification

Un point de terminaison public sans clé retourne les 10 meilleures opportunités avec un screener inter-exchange en direct, idéal pour l'intégration ou des vérifications rapides. Il supprime l'historique des écarts par symbole et les champs lourds et est servi depuis un cache de 120 secondes. Lorsqu'il n'y a pas d'écarts de financement inter-exchange dans la fenêtre de fraîcheur, il retourne un opportunities tableau vide avec un note — jamais de données fabriquées.

GET  /smart-money/flow

Un indice directionnel pondéré par la qualité indice directionnel des baleines par symbole, noté -100 (l'argent des baleines penche vers le court) à +100 (penche vers le long). Construit à partir de milliers de portefeuilles de baleines Hyperliquid suivis — chacun pondéré par son propre taux de réussite historique et PnL et décroissant avec le temps. Ceci est un indice de positionnement, pas un signal d'achat/vente ou de prévision de prix. Les symboles avec peu de portefeuilles contributeurs sont étiquetés thin et notés honnêtement. Page en direct : smart-money-flow.html.

Paramètres

Exemple de réponse

GET  /v1/whales/crowding

Contexte combiné positionnement des baleines & contexte de concentration par symbole, fusionné à travers Hyperliquid + GMX v2 + Jupiter Perps. Retourne le notionnel brut/net, l'inclinaison directionnelle, le nombre de portefeuilles et de places, la concentration des positions (part des top-3 + HHI), un effet de levier moyen pondéré, et seuils_de_proximité_de_liquidation (notionnel situé à 5% et 10% de son prix de liquidation estimé, divisé en long/court). Ceci est un contexte, pas un signal directionnel. Les champs qui ne sont pas dérivables sont null et apparaissent comme — — par ex. lev_wavg/crowding_index quand aucune position ne porte d'effet de levier. Les distances de liquidation sont une estimation de marge isolée (pct_to_liq ≈ 1/lev + upnl/notional − mmr, mmr = 0.01), pas les prix de liquidation rapportés par l'échange.

Paramètres

Exemple de requête

Exemple de réponse

GET  /v1/options/gex

Dealer exposition gamma (GEX) analytiques pour BTC & ETH, calculées en direct à partir de la chaîne d'options publique de Deribit (sans auth). Retourne le GEX net du dealer par strike (convention SpotGamma dealer-short), le niveau de flip gamma (strike où le GEX net cumulé traverse zéro), la structure de terme de l'IV (vol implicite ATM par jours jusqu'à l'expiration), et un skew d'IV front-expiry (proxy 25Δ de risk reversal). Le régime GEX est positive (dealers long gamma → suppression de la volatilité) ou negative (amplification de la volatilité). Totalement autonome — recalculé à chaque appel, aucune dépendance à une base de données stockée.

Paramètres

Exemple de requête

Exemple de réponse

GET  /v1/liquidations/simulate

Interactif test de résistance en cascade de liquidation. Étant donné un mouvement de prix hypothétique, retourne les positions à effet de levier estimées qui seraient liquidées, le volume forcé par niveau de prix / côté / échange, et une lecture de la profondeur de cascade. Un mouvement à la baisse liquide les longs dont le prix de liquidation se situe à/au-dessus de la cible ; un mouvement à la hausse liquide les shorts dont le prix de liquidation se situe à/en dessous. Deux méthodes indépendantes sont combinées : les prix de liquidation exacts des baleines suivies sur Hyperliquid réels levier/entrée, plus des clusters statistiques de bandes d'OI par échange (levier de la foule déduit du funding). Tout est clairement étiqueté estimated: true — il ne peut pas connaître la marge par compte, cross vs isolée, marge ajoutée, ou ADL.

Paramètres

Exemple de requête

Exemple de réponse

GET  /v1/wallet/{addr}/profile

Un profil de portefeuille multi-plateformes construit entièrement à partir des instantanés de positions des baleines suivies en direct. Pour une baleine Hyperliquid suivie, retourne les positions ouvertes actuelles, une série temporelle de PnL non réalisé / exposition / nombre de positions série temporelle, une chronologie d'activité OPEN/CLOSE/FLIP (reconstruite en différenciant des instantanés consécutifs), le label décodé du classement HL, et un résumé du carnet d'ordres. Page live : wallet-profiler.html.

Paramètres

Exemple de requête

Exemple de réponse

GET  /flows

Renvoie des données de flux de capital inter-actifs montrant les modèles de rotation entre BTC, ETH et SOL sur plusieurs fenêtres temporelles. Utile pour identifier quel actif accumule du capital et lequel est distribué à un moment donné.

Exemple de réponse

GET  /whale-events

Renvoie les changements significatifs de positions des baleines — ouvertures, fermetures et inversions de direction — détectés sur les portefeuilles suivis et les adresses on-chain dans la fenêtre de recherche spécifiée.

Paramètres

Exemple de réponse

GET  /regimes/history

Retourne les données historiques de classification des régimes pour un actif donné. Utilisez ceci pour backtester la performance historique des types de régimes spécifiques, la durée typique de chaque régime et la façon dont les transitions se déroulent dans le temps.

Paramètres

Exemple de réponse

GET  /exchange-health

Retourne l'état de santé en temps réel de tous les échanges surveillés, y compris la latence par échange, les taux d'erreur et les indicateurs d'obsolescence des données. Aucune authentification requise — endpoint accessible publiquement.

Exemple de réponse

GET  /sentiment

Retourne un indice Fear & Greed (0-100) en temps réel calculé à partir du sentiment des dérivés, de l'activité des baleines, de la volatilité et des signaux sociaux. Inclut une répartition des composants et un historique de 24 heures pour l'analyse des tendances.

Paramètres

Exemple de réponse

Intégrations

GET  /tradingview/setup

Retourne votre configuration d'intégration TradingView personnalisée : URL de webhook, secret pour validation, et indicateurs Pine Script prêts à l'emploi qui se connectent directement à l'API Smart Money. Copiez-collez le Pine Script dans TradingView pour superposer nos signaux sur n'importe quel graphique.

Exemple de réponse

POST  /tradingview/webhook

Reçoit une alerte TradingView, la traite via /confirm, et retourne la confirmation. TradingView ne peut pas envoyer d'en-têtes personnalisés, donc authentifiez-vous en incluant votre webhook secret dans le corps JSON (cet endpoint n'utilise pas X-API-Key). La réponse encapsule la confirmation et ajoute un niveau supérieur action de CONFIRMED (confiance du démon HIGH/MEDIUM) ou VETOED.

Corps de la requête

Requis : secret, symbol, direction (long|short). Optionnel : source, timeframe, strategy, price.

Personnalisation

GET  /preferences

Retourne vos paramètres de personnalisation actuels, incluant les paramètres de trade par défaut, le profil de risque, la watchlist et les préférences de notification.

Mettez à jour les préférences en envoyant un corps JSON avec n'importe quel sous-ensemble des champs ci-dessous. Les champs omis conservent leurs valeurs actuelles.

Champs de préférence

GET  /watchlist

Retourne un instantané de l'état de confirmation et des métriques de risque clés pour tous les symboles de votre watchlist configurée. Fournit une vue multi-actifs sans avoir à appeler /confirm séparément pour chaque symbole.

Exemple de réponse

Streaming en temps réel (échanges en direct)

Stream les échanges DEX ≥ $500 détectés en temps réel depuis nos propres nœuds BSC et Avalanche. Deux transports sont disponibles : un flux public Server-Sent Events (SSE) pour les clients gratuits/navigateurs, et un flux WebSocket à faible latence pour les abonnés payants. Les événements sont diffusés dans les secondes suivant leur inclusion dans un bloc.

Flux SSE Public (Gratuit)

Aucune authentification requise. Support natif EventSource dans tous les navigateurs modernes. Le serveur émet swap des événements et des battements de cœur périodiques pour maintenir la connexion active.

Flux WebSocket (Payant)

Authentification (recommandée) : ne mettez jamais votre clé de longue durée dans l'URL — elle est enregistrée par les proxies et sauvegardée dans l'historique du navigateur. Au lieu de cela, POSTez votre clé à /v1/ws/ticket en utilisant l'en-tête X-API-Key sécurisé, puis ouvrez le socket avec le ticket à usage unique retourné ticket (valable ~60s, utilisé une fois). Les clients côté serveur qui peuvent définir des en-têtes peuvent plutôt passer X-API-Key directement lors de la poignée de main. Les clés de niveau gratuit reçoivent une 402 payment_required réponse. Une hello trame est envoyée lors de la connexion avec votre niveau et le seuil de diffusion.

Authentification WebSocket (tickets)

Pourquoi : ne mettez jamais votre clé API dans une URL WebSocket — les chaînes de requêtes sont enregistrées par les proxies, les équilibreurs de charge, et sauvegardées dans l'historique du navigateur. Au lieu de cela, échangez votre clé contre un ticket à courte durée de vie et à usage unique ticket via une requête POST authentifiée normale, puis connectez-vous avec ce ticket.

Flux : POSTez à /v1/ws/ticket avec votre X-API-Key en-tête → recevez { "ticket": "…", "expires_in": 60 }. Puis ouvrez wss://api.smartmoneyapi.com/v1/ws/live-swaps?ticket=<ticket>Le ticket est à usage unique et expire dans ~60 secondesLes clients côté serveur qui peuvent définir des en-têtes de requête peuvent plutôt passer X-API-Key directement sur la poignée de main WebSocket — aucun ticket nécessaire.

Crée un ticket à usage unique pour une poignée de main WebSocket authentifiée. Authentifiez-vous avec l' X-API-Key en-tête (votre clé ne quitte jamais les en-têtes de la requête). Le ticket retourné peut être utilisé une fois sur /v1/ws/live-swaps avant son expiration.

Exemple de réponse

Champs de réponse

Remarque : l'authentification par ?key= paramètre de requête héritée est plus acceptée sur les points de terminaison WebSocket pour des raisons de sécurité. Utilisez un ticket (clients navigateur) ou l' X-API-Key en-tête de poignée de main (clients côté serveur).

Snapshot REST

Retourne les N derniers swaps diffusés depuis le tampon en roulement. Utile pour le premier rendu sur les tableaux de bord avant l'ouverture de la connexion de flux. Également disponible : /v1/live-swaps/status pour les statistiques du diffuseur.

Schéma d'événement

POST  /alerts/conditions

Créez des règles d'alerte personnalisées qui se déclenchent lorsqu'une métrique spécifiée dépasse un seuil. Les alertes sont livrées via webhook, e-mail ou le flux de notifications du tableau de bord selon vos préférences.

Retourne une liste de toutes vos conditions d'alerte configurées avec leurs ID, définitions et statut actuel.

Supprime définitivement une condition d'alerte par son ID.

Retourne les événements récents de déclenchement d'alerte avec des horodatages, les conditions correspondantes et la valeur de la métrique au moment du déclenchement.

Créer une alerte — Corps de la requête

La liste en direct des métriques et opérateurs valides est retournée par GET /v1/alerts/conditions as available_metrics and available_operators.

Métriques Disponibles

GET  /kelly

Retourne des recommandations de taille de position selon le critère de Kelly, calibrées sur la performance historique du signal pour le symbole, le niveau de confiance et la direction. Base la taille de la position sur les taux de réussite empiriques pour éviter le sur-effet de levier.

Paramètres

Exemple de Réponse

GET  /performance

Retourne des statistiques historiques de précision des signaux émis par l'API, ventilées par niveau de confiance. Utile pour évaluer la fiabilité des signaux avant d'engager du capital.

Paramètres

Exemple de réponse

Statistiques & Signaux

GET  /v1/stats

Statistiques de performance honnêtes à l'échelle du site, provenant de smart_money_confirm résultats d'appels distincts. Retourne les taux de réussite aux niveaux de confiance HIGH et MEDIUM, la précision globale, le facteur de profit et une ventilation par symbole. Tous les chiffres sont in-sample sur la fenêtre d'évaluation ; consultez calibration.html pour le contexte et la méthodologie forward-holdout.

Exemple de réponse

GET  /v1/signals/performance

Suivi des résultats des signaux sur plusieurs horizons de résolution (4h, 12h, 24h, 72h). Retourne les taux de réussite par horizon, le nombre total de signaux et une ventilation par type de signal.

Paramètres

Exemple de réponse

GET  /v1/signals/recent

Flux des signaux RÉCENTS publiés (niveau HIGH et MEDIUM) pour tous les symboles surveillés. Chaque entrée inclut le type de signal, le niveau de confiance, la direction et le statut de résolution si disponible.

Exemple de réponse

GET  /v1/signals/{id}/outcome

Résultat résolu pour un signal spécifique via son ID numérique. Retourne succès/échec à chaque horizon de résolution (4h, 12h, 24h, 72h) avec le prix au moment du signal et à la résolution.

Paramètres

Exemple de réponse

GET  /v1/confirm-winrate

Répartition du taux de réussite des signaux de confirmation pour la clé API de l'utilisateur authentifié. Retourne les taux de réussite par appel distinct à chaque niveau de confiance, le facteur de profit et les données par symbole. Nécessite un en-tête X-API-Key valide.

Exemple de requête

Exemple de réponse

Shadow Gate

Un registre de décisions personnel immuable et uniquement en ajout. Soumettez vos décisions de trading avant ou après leur exécution ; le système calcule un score de confirmation par rapport au moteur Smart Money et ajoute une ligne permanente. Utilisez-le pour constituer un historique horodaté honnête de la correspondance entre le signal de l'API et vos propres entrées — totalement indépendant du pool mondial de taux de réussite. Les réponses des niveaux Free et Trader ont des champs de preuve masqués ; Pro renvoie l'analyse complète. Un délai de niveau s'applique aux données du niveau Free.

Soumettre une décision. Idempotent sur le Idempotency-Key en-tête de requête — la soumission de la même clé renvoie la ligne existante sans créer de doublon. Le système appelle immédiatement le moteur de confirmation et ajoute le résultat sous forme de ligne de registre immuable.

Corps de la requête

Exemple de requête

Exemple de réponse

Listez vos propres décisions shadow-gate, les plus récentes en premier. Limité au propriétaire — seules les décisions soumises par votre clé API sont retournées.

Paramètres

Exemple de réponse

Décision unique par ID, incluant les preuves complètes de confirmation pour le niveau Pro. Les réponses des niveaux Free et Trader ont factors et adjustments supprimées. Renvoie 403 si la décision appartient à une autre clé API.

Exemple de réponse (Pro)

Résolution manuelle du résultat d'une décision. Appelez cette méthode après avoir clôturé le trade pour enregistrer le résultat final dans la ligne du registre. Une fois résolue, la ligne est immuable et ne peut plus être modifiée.

Corps de la requête

Exemple de réponse

Codes d'erreur

Exemples de code

Python

JavaScript / Node.js

cURL

Intégration Freqtrade

Ajoutez la confirmation Smart Money à n'importe quelle stratégie Freqtrade en surchargeant la confirm_trade_entry méthode.

CCXT + Smart Money