Premiers Pas

Ce guide vous accompagne à travers les étapes d'intégration avec l'API de Marché de Prédiction en tant qu'opérateur.

Prérequis

Avant de commencer, vous avez besoin de :

1. Compte Opérateur — Un compte opérateur enregistré avec des identifiants API
2. Clé API — Votre clé API unique pour authentifier les requêtes

Contactez un administrateur de la plateforme pour faire créer votre compte opérateur. Vous recevrez une Clé API pour authentifier toutes les requêtes API.

URL de Base

REST API:  http://{host}:8084
gRPC:      {host}:50055
WebSocket: ws://{host}:8084/ws

Authentification

Tous les appels API nécessitent l'en-tête X-Api-Key :

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

Consultez la page Authentication pour plus de détails.

Flux d'Intégration

Étape 1 : Créer une Catégorie (Optionnel)

Les catégories permettent d'organiser vos marchés.

curl -X POST https://polymarket.sandbox.playbatman.com/api/v1/categories \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Sports",
    "slug": "sports",
    "description": "Sports prediction markets"
  }'

Étape 2 : Créer un Marché

curl -X POST https://polymarket.sandbox.playbatman.com/api/v1/markets \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Champions League Final Winner",
    "description": "Which team will win the 2026 Champions League final?",
    "categoryId": "{categoryId}",
    "currency": "KES",
    "tradingStartsAt": "2026-03-01T00:00:00Z",
    "tradingEndsAt": "2026-06-01T00:00:00Z",
    "outcomes": [
      { "name": "Team A" },
      { "name": "Team B" }
    ]
  }'

Le marché est créé avec le statut DRAFT.

Étape 3 : Ouvrir le Marché

Lorsque vous êtes prêt, ouvrez le marché pour le trading :

curl -X POST https://polymarket.sandbox.playbatman.com/api/v1/markets/{marketId}/open \
  -H "X-Api-Key: your-api-key"

Étape 4 : Passer des Ordres

Soumettez des ordres au nom de vos joueurs. Vous devez valider de votre côté que le joueur dispose d'un solde suffisant avant de passer un ordre BUY.

curl -X POST https://polymarket.sandbox.playbatman.com/api/v1/orders \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "marketId": "{marketId}",
    "outcomeId": "{outcomeId}",
    "playerId": "player-456",
    "side": "BUY",
    "type": "LIMIT",
    "shares": 100,
    "price": 0.55,
    "transactionId": "txn-abc-123"
  }'

La réponse inclut les détails de l'ordre et les transactions immédiates si l'ordre a été mis en correspondance.

Étape 5 : Surveiller les Positions

Suivez les positions agrégées de votre opérateur :

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

Étape 6 : Résoudre et Régler

Une fois le résultat de l'événement connu :

# Resolve the market
curl -X POST https://polymarket.sandbox.playbatman.com/api/v1/markets/{marketId}/resolve \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "winningOutcomeId": "{outcomeId}",
    "resolutionSource": "Official match result",
    "resolutionNotes": "Team A won 3-1"
  }'

# Trigger settlement
curl -X POST https://polymarket.sandbox.playbatman.com/api/v1/markets/{marketId}/settle \
  -H "X-Api-Key: your-api-key"

# Query settlement payouts
curl https://polymarket.sandbox.playbatman.com/api/v1/settlements?marketId={marketId} \
  -H "X-Api-Key: your-api-key"

Les enregistrements de règlement vous indiquent le montant payé par chaque position. Utilisez ces données pour créditer les portefeuilles de vos joueurs.

Cycle de Vie du Marché

DRAFT → UPCOMING → OPEN → SUSPENDED → OPEN (resumed)
                     ↓                    ↓
                   CLOSED → RESOLVED → SETTLED
                     ↓
                 CANCELLED

Statut	Description
DRAFT	Marché créé, pas encore visible ni tradeable
UPCOMING	Marché visible, trading pas encore démarré
OPEN	Marché ouvert pour le trading
SUSPENDED	Trading temporairement suspendu
CLOSED	Trading terminé, en attente de résolution
RESOLVED	Résultat gagnant déclaré, en attente de règlement
SETTLED	Toutes les positions réglées, paiements enregistrés
CANCELLED	Marché annulé, tous les ordres annulés

Format de Réponse

Toutes les réponses de l'API REST suivent une enveloppe cohérente :

// Success
{
  "success": true,
  "data": { ... }
}

// Error
{
  "success": false,
  "error": {
    "code": "MARKET_NOT_FOUND",
    "message": "Market with id xyz not found"
  }
}

Prochaines Étapes

• Authentication — Guide d'authentification détaillé
• Markets API — Référence complète de la gestion des marchés
• Orders API — Placement et gestion des ordres
• WebSocket — Diffusion de données en temps réel
• Webhooks — Livraison d'événements backend à backend
• Event Replay — Récupération des événements manqués
• Glossary — Termes clés et concepts