Get Prediction Markets Batch

Fetch details for multiple prediction markets in a single request (up to 50 markets).

POST /2/pm/markets/batch

Get Prediction Markets Batch

cURL

curl --request POST \
  --url https://pm-api-prod-eu.mobula.io/api/2/pm/markets/batch \
  --header 'Content-Type: application/json' \
  --data '
{
  "items": [
    {
      "platform": "polymarket",
      "marketId": "0xd86a816093fcd0a0e1ca440bc5ce199bd3c5a8d6139e044b076958164f8c5423"
    },
    {
      "platform": "polymarket",
      "marketId": "0x366f89649caea042c96ee741b185461ec7faa408a2664ec44469a0061924b537"
    }
  ]
}
'

200

{
  "payload": [
    {}
  ]
}

Alpha — This endpoint is part of the Prediction Markets API, currently in early access. May change without notice.

Request Body

items · array · required

Array of market identifiers to fetch (1 to 50 items). Requests with more than 50 items will return a 400 error.

Show Item Object

platform · string · required

Platform name (e.g., polymarket).

marketId · string · required

Platform-specific market ID.

Response

payload · array

Array of market detail objects (same shape as the single market details endpoint).

hostname · string

Server hostname that handled the request.

took · number

Time in milliseconds the server spent processing the request.

Usage Example

curl -X POST "https://api.mobula.io/api/2/pm/markets/batch" \
  -H "Content-Type: application/json" \
  -d '{
    "items": [
      { "platform": "polymarket", "marketId": "0xabc..." },
      { "platform": "polymarket", "marketId": "0xdef..." }
    ]
  }'

Example Response

{
  "payload": [
    {
      "id": "polymarket:0xabc...",
      "platform": "polymarket",
      "marketId": "0xabc...",
      "question": "Will ETH reach $10,000 by end of 2026?",
      "status": "active",
      "outcomes": [
        { "outcomeId": "71321...", "label": "Yes", "priceUSD": 0.35 }
      ],
      "stats": { "totalVolumeUSD": 1250000, "volume24hUSD": 45000 }
    }
  ],
  "hostname": "pm-api-prod-eu-abc123",
  "took": 42
}

Batch POST endpoints use payload (not data) as the response wrapper — this matches the spot API batch convention (e.g., POST /market/multi-data).

Body

application/json

items · object[] · required

1-50 (platform, marketId) pairs to fetch in one round-trip.

Required array length: 1 - 50 elements

Show child attributes

Response

200 - application/json

Batch market details (note response key is payload, not data).

payload · object[]