Get Prediction Market Details

Get full details for a specific prediction market, including outcomes, stats, and metadata.

GET /2/pm/market/details

Get Prediction Market Details

cURL

curl --request GET \
  --url https://pm-api-prod-eu.mobula.io/api/2/pm/market/details

200

{
  "data": {}
}

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

Query Parameters

platform · string · required

The prediction market platform. Currently supported: polymarket.

marketId · string · required

The platform-specific market identifier.

Response

data · object

Full market details object.

Show Market Details

id · string

Internal market ID.

platform · string

Platform name (e.g., polymarket).

marketId · string

Platform-specific market ID.

slug · string

URL-friendly market slug.

chainId · string

Blockchain chain ID (e.g., "evm:137" for Polygon).

contractAddress · string | null

Market contract address.

negRisk · boolean

Whether this is a neg-risk market (multi-outcome).

question · string

The market question.

description · string

Detailed market description.

category · string

Market category (e.g., politics, sports).

tags · string[]

Array of tags associated with the market.

type · string

Market type (binary, categorical, scalar).

status · string

Market status: active, closed, or resolved. Markets with a past endDate are automatically marked closed even if the database hasn’t been updated yet.

eventId · string | null

Parent event identifier, if this market belongs to a grouped event. null for standalone markets. Use with /api/2/pm/event/details to fetch the full event.

eventSlug · string | null

Parent event URL-friendly slug. null for standalone markets.

eventTitle · string | null

Parent event title. null for standalone markets.

outcomes · array

Array of outcome objects.

Show Outcome Object

id · string

Internal outcome ID.

outcomeId · string

Outcome token ID (used for trading, balance queries, and price lookups).

label · string

Outcome label (e.g., “Yes”, “No”).

priceUSD · number

Current price (0 to 1).

priceChange24hPercentage · number

24-hour price change as a percentage (e.g., price went from 0.30 to 0.35 → priceChange24hPercentage: 16.67).

priceChange7dPercentage · number

7-day price change as a percentage (e.g., price went from 0.30 to 0.35 → priceChange7dPercentage: 16.67).

volume24hUSD · number

24-hour trading volume for this outcome in USD.

volume7dUSD · number

7-day trading volume for this outcome in USD.

totalVolumeUSD · number

All-time trading volume for this outcome in USD.

liquidityUSD · number | null

Outcome liquidity in USD (nullable).

openInterestUSD · number | null

Open interest in USD (nullable).

holdersCount · number | null

Number of holders (nullable).

stats · object

Market statistics. All monetary values are in USD.

Show Stats Object

totalVolumeUSD · number

All-time cumulative trading volume in USD across all outcomes.

volume24hUSD · number

Trading volume in the last 24 hours in USD.

volume7dUSD · number

Trading volume in the last 7 days in USD.

liquidityUSD · number

Current total liquidity available in the order book in USD.

openInterestUSD · number | null

Total open interest across all outcomes.

holdersCount · number | null

Total number of unique holders across all outcomes.

tradesCount · number

Total number of trades executed on this market.

trades24h · number

Number of trades in the last 24 hours.

metadata · object

Market metadata.

Show Metadata Object

createdAt · string

Market creation timestamp.

endDate · string | null

Expected resolution date (end date of the market).

resolvedAt · string | null

Actual resolution timestamp (if resolved).

resolved · boolean

Whether the market has been resolved.

resolvedOutcome · string | null

The winning outcome label (if resolved).

logo · string | null

Market logo URL.

url · string | null

Market URL on the platform.

creator · string | null

Market creator address.

resolver · string | null

Market resolver address.

rewardPool · string | null

Reward pool amount.

platformFee · string | null

Platform fee.

hostname · string

Server hostname that handled the request.

took · number

Time taken in milliseconds.

Usage Example

curl -X GET "https://api.mobula.io/api/2/pm/market/details?platform=polymarket&marketId=0x1234..."

Example Response

{
  "data": {
    "id": "polymarket:0x1234...",
    "platform": "polymarket",
    "marketId": "0x1234...",
    "slug": "will-eth-reach-10k-2026",
    "chainId": "evm:137",
    "contractAddress": null,
    "negRisk": false,
    "question": "Will ETH reach $10,000 by end of 2026?",
    "description": "This market resolves to Yes if the price of ETH reaches $10,000 on any major exchange before December 31, 2026.",
    "category": "crypto",
    "tags": ["ethereum", "price"],
    "type": "binary",
    "status": "active",
    "outcomes": [
      { "outcomeId": "71321...", "label": "Yes", "priceUSD": 0.35, "priceChange24hPercentage": 9.38, "priceChange7dPercentage": 16.67, "volume24hUSD": 22000, "volume7dUSD": 95000, "totalVolumeUSD": 620000, "liquidityUSD": 160000, "openInterestUSD": 290000, "holdersCount": 800 },
      { "outcomeId": "71322...", "label": "No", "priceUSD": 0.65, "priceChange24hPercentage": -4.41, "priceChange7dPercentage": -7.14, "volume24hUSD": 23000, "volume7dUSD": 115000, "totalVolumeUSD": 630000, "liquidityUSD": 160000, "openInterestUSD": 290000, "holdersCount": 700 }
    ],
    "stats": {
      "totalVolumeUSD": 1250000,
      "volume24hUSD": 45000,
      "volume7dUSD": 210000,
      "liquidityUSD": 320000,
      "openInterestUSD": 580000,
      "holdersCount": 1234,
      "tradesCount": 8500,
      "trades24h": 120
    },
    "metadata": {
      "createdAt": "2026-01-15T00:00:00.000Z",
      "endDate": "2026-12-31T23:59:59.000Z",
      "resolvedAt": null,
      "resolved": false,
      "resolvedOutcome": null,
      "creator": null,
      "resolver": null,
      "rewardPool": null,
      "platformFee": null,
      "logo": "https://polymarket.com/images/market.png",
      "url": "https://polymarket.com/event/will-eth-reach-10k-2026"
    }
  },
  "hostname": "pm-api-prod-eu-abc123",
  "took": 42
}

Query Parameters

platform · enum<string> · required

Prediction market platform. Today only polymarket is supported; any other value returns 400.

Available options: polymarket

Example:

"polymarket"

marketId · string · required

CTF conditionId — 0x-prefixed 32-byte hex string. NOT the URL slug.

Pattern: ^0x[0-9a-fA-F]{64}$

Example:

"0xd86a816093fcd0a0e1ca440bc5ce199bd3c5a8d6139e044b076958164f8c5423"

Response

200 - application/json

Market details

data · object