API Transactions

Les transactions sont créées automatiquement lorsque le moteur de correspondance associe un ordre d'achat à un ordre de vente. Chaque transaction représente une opération exécutée entre deux parties.

Authentification : En-tête X-Api-Key requis.

Lister les transactions

Récupère les transactions de votre compte opérateur.

GET /api/v1/trades

Paramètres de requête :

Paramètre	Type	Description
marketId	string	Filtrer par marché
outcomeId	string	Filtrer par résultat
cursor	string	Curseur de pagination
limit	number	Taille de page

Exemple :

curl "https://polymarket.sandbox.playbatman.com/api/v1/trades?marketId=market-uuid&limit=20" \
  -H "X-Api-Key: your-api-key"

Réponse :

{
  "success": true,
  "data": {
    "trades": [
      {
        "id": "trade-uuid",
        "marketId": "market-uuid",
        "outcomeId": "outcome-uuid",
        "buyOrderId": "buy-order-uuid",
        "sellOrderId": "sell-order-uuid",
        "buyerOperatorId": "operator-uuid-1",
        "sellerOperatorId": "operator-uuid-2",
        "price": "0.65",
        "shares": "30",
        "buyerFee": "0.39",
        "sellerFee": "0.39",
        "createdAt": "2026-02-18T22:00:00.000Z"
      }
    ],
    "total": 128,
    "hasMore": true,
    "nextCursor": "cursor-value"
  }
}

Champs d'une transaction

Champ	Type	Description
id	string	UUID de la transaction
marketId	string	Marché où la transaction a eu lieu
outcomeId	string	Résultat qui a été échangé
buyOrderId	string	UUID de l'ordre d'achat
sellOrderId	string	UUID de l'ordre de vente
buyerOperatorId	string	Opérateur ayant passé l'ordre d'achat
sellerOperatorId	string	Opérateur ayant passé l'ordre de vente
price	string (decimal)	Prix d'exécution par part
shares	string (decimal)	Nombre de parts échangées
buyerFee	string (decimal)	Frais facturés à l'acheteur
sellerFee	string (decimal)	Frais facturés au vendeur
createdAt	string (ISO 8601)	Date d'exécution de la transaction

Calcul des frais

Les frais sont calculés en pourcentage de la valeur de la transaction :

fee = shares * price * feePercent / 100

Les frais de trading par défaut sont de 2,0 %, appliqués à l'acheteur et au vendeur. Ce taux est configurable via la variable d'environnement DEFAULT_TRADING_FEE_PERCENT.

Exemple : Une transaction de 100 parts à 0,65 $ avec des frais de 2 % :

• Valeur de la transaction : 100 * 0.65 = 65,00 $
• Frais acheteur : 65.00 * 0.02 = 1,30 $
• Frais vendeur : 65.00 * 0.02 = 1,30 $

Comprendre les données de transaction

• Les transactions référencent à la fois les identifiants d'ordre d'achat et de vente, ce qui permet de retracer quels ordres ont été appariés
• Votre opérateur apparaîtra soit en tant que buyerOperatorId, soit en tant que sellerOperatorId selon le sens de l'ordre
• Le price est toujours le prix d'exécution (qui peut différer du prix limite de l'ordre)
• Les transactions sont immuables — une fois créées, elles ne peuvent être ni modifiées ni supprimées