Introduction
WinIA API expose deux endpoints REST. Tu envoies une requête HTTP POST depuis n'importe quel langage — Python, JavaScript, PHP, Go, Ruby, Dart, Swift, ou tout outil capable d'envoyer une requête HTTP — et tu reçois une réponse JSON structurée en quelques secondes.
Crée ton compte
Rends-toi sur dashboard et crée ton compte. Ton accès API est disponible immédiatement après inscription.
Récupère ta clé API
Dans le dashboard, génère ta clé API. Elle commence par wia_. Garde-la secrète — elle donne accès à tes crédits.
Recharge tes crédits
Dépose des crédits depuis la section Crédits du dashboard. Chaque requête déduit son coût automatiquement de ton solde.
Envoie ta première requête
Un simple HTTP POST avec ton header Authorization: Bearer wia_ta_cle et un body JSON. C'est tout.
Authentification
Toutes les requêtes doivent inclure ton header Authorization avec ta clé API au format Bearer. Sans ce header, la requête retourne une erreur 401.
| Header | Type | Description |
|---|---|---|
| Authorization | header | Format : Bearer wia_ta_cle_api — obligatoire sur chaque requête |
| Content-Type | header | Doit être application/json — le corps de la requête est toujours du JSON |
Bonne pratique : Ne hardcode jamais ta clé API dans le code source. Utilise une variable d'environnement (process.env.WIN_IA_KEY, os.environ["WIN_IA_KEY"], etc.) ou un fichier .env exclu du versioning.
Crédits & Facturation
WinIA API fonctionne en pay-as-you-go, facturé au token — pas de coût fixe par requête. Tu déposes des crédits en USD depuis le dashboard. Chaque requête réussie (HTTP 200) déduit de ton solde le coût réel des tokens consommés (entrée + sortie), selon le modèle utilisé. Aucune requête échouée ne te coûte quoi que ce soit.
| Modèle | Entrée (input) | Sortie (output) |
|---|---|---|
| win-nova-3-2 | $2.00 / M tokens | $10.00 / M tokens |
| win-vector-4-3 | $4.00 / M tokens | $20.00 / M tokens |
| win-quantum-5 | $10.00 / M tokens | $50.00 / M tokens |
Ces tarifs s'appliquent à /v2/analyse et /v2/advance. Utilise /v2/tokens pour estimer le coût d'une requête avant de l'envoyer, sans clé API.
Solde insuffisant : Avant chaque requête, WinIA API estime le coût au pire cas (tokens d'entrée exacts + max_tokens que tu as fourni). Si ton solde ne couvre pas ce pire cas, l'API retourne une erreur 402 Payment Required avant même d'appeler le modèle — la requête n'est jamais traitée et rien n'est débité. Recharge depuis le dashboard ou réduis max_tokens pour reprendre.
Chaque réponse 200 inclut les champs de facturation : input_tokens, output_tokens, cost_usd (le coût réel de cette requête) et balance (ton solde restant après déduction). Utilise ces champs pour surveiller ta consommation en temps réel depuis ton application.
Modèles WinIA
Le champ model est obligatoire sur chaque requête envoyée à /v2/analyse, /v2/advance et /v2/tokens. WinIA propose 3 modèles, à choisir selon ton besoin de vitesse ou de profondeur d'analyse.
| Modèle | Profil | Description |
|---|---|---|
| win-nova-3-2 | rapide | Rapide et efficace pour des lectures claires du marché — idéal pour du scalping, des vérifications à haute fréquence ou des intégrations sensibles à la latence. |
| win-vector-4-3 | équilibré | Équilibre entre rapidité et profondeur d'analyse — le choix par défaut pour un usage quotidien en production. |
| win-quantum-5 | puissant | Le plus puissant et le plus précis — réservé aux analyses les plus exigeantes, où la rigueur prime sur la vitesse. |
Obligatoire : une requête sans champ model, ou avec une valeur autre que win-nova-3-2, win-vector-4-3 ou win-quantum-5, retourne une erreur 400 Bad Request.
Environnements
Chaque requête doit préciser son environnement via le champ environment dans le body JSON. Cela permet de distinguer tes tests de tes requêtes en production.
| Valeur | Comportement | Facturation |
|---|---|---|
| live | Analyse réelle — résultats exploitables en production | Débitée |
| sandbox | Environnement de test — réponses simulées, idéal pour développer et tester ton intégration | Gratuite |
En mode sandbox, les réponses retournées sont des données simulées et ne doivent pas être utilisées pour des décisions de trading réelles. Ce mode est uniquement destiné à tester ton intégration.
Analyse un graphique de trading depuis une image. Retourne un signal structuré avec entrée, TP, SL, R/R et pattern détecté.
Corps de la requête (JSON)
| Champ | Localisation | Type | Description |
|---|---|---|---|
| Authorization | Header | header | Bearer wia_ta_cle_api — obligatoire sur chaque requête |
| environment | Body | requis | live ou sandbox — définit l'environnement d'exécution |
| secret | Body | requis | Ta clé secrète API — distincte de la clé Bearer, disponible dans le dashboard |
| image | Body | requis | Image du graphique encodée en base64 — formats acceptés : PNG, JPEG, WebP — taille max : 10 Mo |
| model | Body | requis | win-nova-3-2, win-vector-4-3 ou win-quantum-5 — voir la section Modèles WinIA |
| max_tokens | Body | requis | Entier ≥ 64 — nombre maximum de tokens de sortie généré par WinIA. Sert aussi à estimer le coût au pire cas avant l'appel (voir Crédits & Facturation) |
Réponse JSON (HTTP 200)
| Champ | Type | Description |
|---|---|---|
| signal | string | Signal de trading — Buy, Sell, Buy Limit, Sell Limit, Buy Stop, Sell Stop, Wait |
| entry_price | float | Prix d'entrée recommandé pour le trade |
| take_profit | float | Niveau de prise de profit recommandé |
| stop_loss | float | Niveau de stop loss recommandé |
| pips_tp | float | Distance en pips entre l'entrée et le take profit |
| pips_sl | float | Distance en pips entre l'entrée et le stop loss |
| risk_reward | string | Ratio risque/rendement du setup — ex : 1:2.44 |
| score_analyse | float | Score de confiance de l'analyse entre 0 et 1 — ex : 0.87 |
| actifs | string | Actif détecté sur le graphique — ex : BTC/USD, EUR/USD, AAPL |
| model | string | Modèle utilisé pour cette requête — reprend la valeur envoyée dans model |
| input_tokens | int | Nombre de tokens d'entrée réellement consommés |
| output_tokens | int | Nombre de tokens de sortie réellement générés |
| cost_usd | float | Coût réel de cette requête en USD — déduit de ton solde |
| balance | float | Solde restant sur ton compte en USD après déduction |
Compatibilité : Cet endpoint accepte les graphiques de crypto, forex, actions et indices. L'image peut contenir des indicateurs, des bougies, des barres ou n'importe quel style de chart standard.
Analyse conversationnelle en langage naturel. Tu poses une question sur un graphique, WinIA répond comme un analyste senior — avec raisonnement, niveaux et biais.
Corps de la requête (JSON)
| Champ | Localisation | Type | Description |
|---|---|---|---|
| Authorization | Header | header | Bearer wia_ta_cle_api — obligatoire sur chaque requête |
| environment | Body | requis | live ou sandbox — définit l'environnement d'exécution |
| secret | Body | requis | Ta clé secrète API — disponible dans ton dashboard |
| message | Body | requis | Ta question en texte libre — ex : "Y a-t-il une ETE sur ce graphique ?" ou "Quel est le biais directionnel ?" |
| image | Body | optionnel | Image du graphique en base64 — optionnelle, mais recommandée pour des analyses visuelles précises |
| model | Body | requis | win-nova-3-2, win-vector-4-3 ou win-quantum-5 — voir la section Modèles WinIA |
| max_tokens | Body | requis | Entier ≥ 64 — nombre maximum de tokens de sortie généré par WinIA. Sert aussi à estimer le coût au pire cas avant l'appel (voir Crédits & Facturation) |
Réponse JSON (HTTP 200)
| Champ | Type | Description |
|---|---|---|
| message | string | Réponse complète en langage naturel — analyse, raisonnement, niveaux clés expliqués |
| model | string | Modèle utilisé pour cette requête — reprend la valeur envoyée dans model |
| input_tokens | int | Nombre de tokens d'entrée réellement consommés |
| output_tokens | int | Nombre de tokens de sortie réellement générés |
| cost_usd | float | Coût réel de cette requête en USD — déduit de ton solde |
| balance | float | Solde restant sur ton compte en USD après déduction |
Idéal pour les chatbots & assistants IA : Le champ message contient une réponse narrative prête à afficher directement à l'utilisateur. WinIA Advance identifie les patterns complexes (ETE, Double Top, W, M, triangles…) et explique son raisonnement, uniquement sur des sujets de trading.
Estimation publique de tokens et de coût — aucune clé API requise. Envoie un texte libre, reçois le nombre exact de tokens d'entrée et le coût estimé au pire cas pour un modèle donné, avant de dépenser le moindre crédit.
Corps de la requête (JSON)
| Champ | Localisation | Type | Description |
|---|---|---|---|
| model | Body | requis | win-nova-3-2, win-vector-4-3 ou win-quantum-5 — le tarif appliqué dépend du modèle choisi |
| text | Body | requis | Texte libre à tokenizer — max 200 000 caractères |
| max_output_tokens | Body | requis | Entier positif — nombre maximum de tokens de sortie envisagé, utilisé pour le calcul du coût au pire cas |
Réponse JSON (HTTP 200)
| Champ | Type | Description |
|---|---|---|
| model | string | Modèle utilisé pour l'estimation |
| input_tokens | int | Nombre exact de tokens que contient le texte envoyé, pour ce modèle |
| max_output_tokens | int | Reprend la valeur envoyée dans la requête |
| estimated_cost_input | float | Coût estimé en USD pour les tokens d'entrée seuls |
| estimated_cost_output_max | float | Coût estimé en USD si max_output_tokens est entièrement consommé en sortie |
| estimated_cost_total_max | float | Coût total estimé au pire cas — c'est ce montant que /v2/analyse et /v2/advance vérifient contre ton solde avant de traiter une requête |
| pricing_per_million | object | Tarif WinIA appliqué pour ce modèle — {input, output} en $ par million de tokens |
Gratuit et public : Cet endpoint ne nécessite ni clé API ni secret, et ne débite jamais de crédit. Utilise-le librement pour prévisualiser le coût d'une requête avant de l'envoyer à /v2/analyse ou /v2/advance.
Signaux de trading
Le champ signal retourné par /v2/analyse peut prendre 7 valeurs selon le type d'ordre recommandé.
Codes d'erreur
L'API retourne des codes HTTP standard. Seul le code 200 indique une analyse réussie et facturée. Tous les autres codes ne débitent rien.
Retry-After inclus dans la réponseRestriction IP
Tu peux restreindre les appels à ton API key à une liste d'adresses IP autorisées depuis le dashboard. Toute requête provenant d'une IP non listée retourne une erreur 403 Forbidden.
| Cas | Code retourné | Facturation |
|---|---|---|
| Aucune restriction configurée (défaut) | Toutes les IPs acceptées | Normale |
| IP dans la whitelist | 200 — Requête traitée | Normale |
| IP hors whitelist | 403 Forbidden | Aucun débit |
Recommandé pour la production : Si ton application tourne sur un serveur avec une IP fixe, active le whitelisting depuis le dashboard. Cela empêche toute utilisation de ta clé API même si elle est compromise.
Rate Limiting
Le rate limiting protège l'infrastructure contre les abus. En cas de dépassement, l'API retourne un code 429 avec un header Retry-After indiquant le nombre de secondes à attendre avant de renvoyer la requête.
| Header | Type | Description |
|---|---|---|
| Retry-After | integer | Nombre de secondes à attendre avant de pouvoir renvoyer une requête |
| X-RateLimit-Limit | integer | Nombre maximum de requêtes autorisées sur la période |
| X-RateLimit-Remaining | integer | Requêtes restantes sur la période en cours |
Les requêtes bloquées par le rate limiter (429) ne sont pas facturées. Implémente une logique de retry avec backoff exponentiel dans ton application pour gérer ce cas proprement.
Avertissement développeur : L'API WinIA est un outil d'aide à l'analyse technique. Les résultats retournés sont indicatifs et ne constituent pas des conseils financiers. Chaque décision de trading reste sous l'entière responsabilité de ton application et de tes utilisateurs.