API publique
Clés d'API REST pour un accès programmatique (plan Bot)
L'API publique de Predite vous permet de lire vos propres données par programmation — votre portefeuille en direct et les derniers signaux Expected Value — depuis vos propres scripts, feuilles de calcul ou outils de trading. C'est une API REST en lecture seule, sécurisée par une clé d'API personnelle et disponible sur le plan Bot.
Vous créez et gérez vos clés depuis le tableau de bord, dans Settings, sur la page API.
Créer une clé d'API
Donnez un libellé à la clé (par exemple « sheet import » ou « backtest script ») puis créez-la. Quelques points à connaître :
- •La clé complète n'est affichée qu'une seule fois, à la création. Elle se présente sous la forme pdt_live_ suivi d'une chaîne aléatoire. Copiez-la immédiatement et conservez-la en lieu sûr — elle n'est plus jamais affichée, car seul son hash est conservé sur nos serveurs.
- •Après la création, le tableau de bord n'affiche que le préfixe court de la clé, afin que vous puissiez distinguer vos clés entre elles.
- •Chaque clé est en lecture seule et expire au bout d'un an après sa création. Vous êtes prévenu avant son échéance.
- •Vous pouvez révoquer une clé à tout moment. La révocation prend effet immédiatement — tout script qui l'utilise encore commence à recevoir 401 Unauthorized.
S'authentifier
Envoyez la clé sous forme de Bearer token dans le header Authorization de chaque requête :
Authorization: Bearer pdt_live_your_key_here
Une clé absente ou invalide renvoie HTTP 401. Les requêtes sont limitées en débit par client — si vous en envoyez trop d'un coup, vous recevez HTTP 429 avec un header Retry-After indiquant le nombre de secondes à attendre. Limitez le polling à quelques requêtes par minute et mettez en cache ce que vous récupérez ; aucune de ces données ne change d'une seconde à l'autre.
Endpoints
Deux endpoints GET sont disponibles aujourd'hui, tous deux renvoyant du JSON.
GET /api/v1/portfolio
Renvoie les positions ouvertes du portefeuille Polymarket connecté à votre compte, avec un résumé et un horodatage generated_at. Si vous n'avez pas encore connecté et vérifié un portefeuille, le tableau positions revient vide avec l'erreur no_wallet_connected — connectez-en un d'abord (voir Connecter un portefeuille).
GET /api/v1/signals
Renvoie les meilleurs signaux Expected Value du moment, triés par edge. Deux paramètres de requête optionnels :
- •limit — combien de signaux renvoyer, de 1 à 100 (20 par défaut)
- •min_edge — l'edge minimum en points de pourcentage (5 par défaut)
La réponse contient le tableau signals, un count, les filtres que vous avez utilisés et un horodatage generated_at.
Exemple
Une requête minimale avec curl, demandant les dix signaux les plus forts avec au moins six points d'edge :
curl -H "Authorization: Bearer pdt_live_..." "https://predite.io/api/v1/signals?limit=10&min_edge=6"
Bon à savoir
- •L'API est en lecture seule — il n'existe aucun endpoint de trading ni d'écriture. Les ordres sont toujours passés depuis l'application : une clé divulguée ne peut donc jamais déplacer votre argent.
- •Malgré tout, traitez la clé comme un mot de passe. En cas de fuite, révoquez-la et émettez-en une nouvelle.
- •Vous préférez recevoir les alertes plutôt que d'interroger l'API en boucle ? Reliez votre compte à Telegram et laissez les signaux venir à vous.