Authentification

Toutes les requêtes API sont authentifiées à l'aide d'une clé API fournie dans l'en-tête HTTP X-Api-Key.

Authentification par clé API

Incluez votre clé API dans chaque requête :

curl -H "X-Api-Key: your-api-key" https://polymarket.sandbox.playbatman.com/api/v1/markets

La clé API est liée à votre compte opérateur. Toutes les ressources créées avec cette clé sont limitées à votre opérateur.

Routes authentifiées

Préfixe	Opérations
/api/v1/markets	Créer, mettre à jour, ouvrir, fermer, résoudre, régler les marchés
/api/v1/categories	Créer et lister les catégories
/api/v1/orders	Passer, annuler, lister les ordres
/api/v1/positions	Consulter les positions
/api/v1/trades	Consulter les transactions
/api/v1/settlements	Consulter les règlements
/api/v1/stats	Statistiques de l'opérateur
/ws	Connexion WebSocket (via en-tête ou paramètre de requête ?apiKey=)

attention

Gardez votre clé API sécurisée. En cas de compromission, contactez un administrateur de la plateforme pour la régénérer. La régénération invalide immédiatement la clé précédente.

Routes publiques

Ces routes ne nécessitent aucune authentification :

Méthode	Chemin	Description
GET	/health	Vérification de l'état de santé
GET	/ready	Vérification de la disponibilité
GET	/api/v1/categories/{id}	Obtenir une catégorie par identifiant
GET	/api/v1/markets/{id}/orderbook/{outcomeId}	Carnet d'ordres
GET	/api/v1/markets/{id}/prices	Prix du marché
GET	/api/v1/markets/{id}/prices/{outcomeId}	Prix d'un résultat

Réponses d'erreur

Si la clé API est manquante ou invalide, vous recevez une réponse 401 Unauthorized :

{
  "success": false,
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Missing or invalid API key"
  }
}

Si le compte opérateur a été désactivé, les requêtes sont également rejetées avec 401.