API des Données de Marché

Les endpoints de données de marché fournissent des informations de tarification et de carnet d'ordres en temps réel. Ces endpoints sont publics et ne nécessitent pas d'authentification.

Carnet d'Ordres

Récupérez le carnet d'ordres actuel pour une issue spécifique.

GET /api/v1/markets/{marketId}/orderbook/{outcomeId}

Paramètres de requête :

Paramètre	Type	Défaut	Description
depth	number	10	Nombre de niveaux de prix à retourner par côté

Exemple :

curl "https://polymarket.sandbox.playbatman.com/api/v1/markets/{marketId}/orderbook/{outcomeId}?depth=5"

Réponse :

{
  "success": true,
  "data": {
    "marketId": "market-uuid",
    "outcomeId": "outcome-uuid",
    "bids": [
      { "price": 0.65, "shares": 150, "orderCount": 3 },
      { "price": 0.63, "shares": 200, "orderCount": 5 },
      { "price": 0.60, "shares": 100, "orderCount": 2 }
    ],
    "asks": [
      { "price": 0.68, "shares": 75, "orderCount": 2 },
      { "price": 0.70, "shares": 300, "orderCount": 4 },
      { "price": 0.75, "shares": 50, "orderCount": 1 }
    ],
    "bestBid": 0.65,
    "bestAsk": 0.68,
    "spread": 0.03,
    "timestamp": 1708293600000
  }
}

Champs du Carnet d'Ordres

Champ	Type	Description
bids	array	Ordres d'achat triés par prix (le plus élevé en premier)
asks	array	Ordres de vente triés par prix (le plus bas en premier)
bestBid	number | null	Prix d'achat le plus élevé
bestAsk	number | null	Prix de vente le plus bas
spread	number | null	Différence entre le meilleur prix de vente et le meilleur prix d'achat
timestamp	number	Horodatage Unix en millisecondes

Champs du Niveau de Prix

Champ	Type	Description
price	number	Niveau de prix
shares	number	Total des parts à ce prix
orderCount	number	Nombre d'ordres à ce prix

Prix du Marché

Obtenez les données de tarification pour toutes les issues d'un marché.

GET /api/v1/markets/{marketId}/prices

Exemple :

curl "https://polymarket.sandbox.playbatman.com/api/v1/markets/{marketId}/prices"

Réponse :

{
  "success": true,
  "data": [
    {
      "marketId": "market-uuid",
      "outcomeId": "outcome-uuid-1",
      "outcomeName": "Yes",
      "bestBid": 0.65,
      "bestAsk": 0.68,
      "lastPrice": 0.66,
      "midPrice": 0.665,
      "spread": 0.03,
      "volume24h": 5000
    },
    {
      "marketId": "market-uuid",
      "outcomeId": "outcome-uuid-2",
      "outcomeName": "No",
      "bestBid": 0.32,
      "bestAsk": 0.35,
      "lastPrice": 0.34,
      "midPrice": 0.335,
      "spread": 0.03,
      "volume24h": 4800
    }
  ]
}

Prix d'une Issue Unique

Obtenez les données de tarification pour une issue spécifique.

GET /api/v1/markets/{marketId}/prices/{outcomeId}

Réponse :

{
  "success": true,
  "data": {
    "marketId": "market-uuid",
    "outcomeId": "outcome-uuid",
    "outcomeName": "Yes",
    "bestBid": 0.65,
    "bestAsk": 0.68,
    "lastPrice": 0.66,
    "midPrice": 0.665,
    "spread": 0.03,
    "volume24h": 5000
  }
}

Champs de Prix

Champ	Type	Description
bestBid	number	Prix d'achat le plus élevé dans le carnet d'ordres
bestAsk	number	Prix de vente le plus bas dans le carnet d'ordres
lastPrice	number	Prix de la transaction la plus récente
midPrice	number	Point médian entre le meilleur prix d'achat et le meilleur prix de vente
spread	number	Différence entre le meilleur prix de vente et le meilleur prix d'achat
volume24h	number	Total des parts échangées au cours des dernières 24 heures

Statistiques de l'Opérateur

Obtenez un aperçu général de vos marchés.

GET /api/v1/stats/overview

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

Réponse :

{
  "success": true,
  "data": {
    "openMarkets": 12,
    "pendingResolution": 3,
    "resolved": 45
  }
}