Get Prediction Market Price

Get current prices for all outcomes of a prediction market, including bid/ask spread.

GET /2/pm/market/price

Get Prediction Market Price

cURL

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

200

{
  "data": {}
}

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

At least one of marketId or outcomeId must be provided.

Query Parameters

platform · string · required

The prediction market platform (e.g., polymarket).

marketId · string

The platform-specific market identifier. For Polymarket this is the conditionId (hex hash, e.g. 0x1ddc0e7d...), not the numeric Gamma ID. Optional when outcomeId is provided.

outcomeId · string

Outcome token ID. When provided alone (without marketId), returns the price for this outcome directly. When provided with marketId, filters the market’s outcomes to this one.

Response

data · object

Price data for the market.

Show Price Data

marketId · string

Market identifier.

platform · string

Platform name.

timestamp · number

Timestamp of the price snapshot.

outcomes · array

Array of outcome price objects.

Show PriceData

outcomeId · string

Outcome token ID.

priceUSD · number

Mid price (0 to 1).

bestBidUSD · number

Best bid price.

bestAskUSD · number

Best ask price.

spreadUSD · number

Bid-ask spread.

timestamp · number

Price timestamp.

hostname · string

Server hostname that handled the request.

took · number

Request processing time in milliseconds.

Usage Example

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

Example Response

{
  "data": {
    "marketId": "0x1234...",
    "platform": "polymarket",
    "timestamp": 1709913600000,
    "outcomes": [
      { "outcomeId": "71321...", "priceUSD": 0.35, "bestBidUSD": 0.34, "bestAskUSD": 0.36, "spreadUSD": 0.02, "timestamp": 1709913600000 },
      { "outcomeId": "71322...", "priceUSD": 0.65, "bestBidUSD": 0.64, "bestAskUSD": 0.66, "spreadUSD": 0.02, "timestamp": 1709913600000 }
    ]
  },
  "hostname": "api-node-1",
  "took": 12
}

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

CTF conditionId (required if outcomeId is not provided).

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

Example:

"0xd86a816093fcd0a0e1ca440bc5ce199bd3c5a8d6139e044b076958164f8c5423"

outcomeId · string

Outcome token id (required if marketId is not provided).

Pattern: ^[0-9]+$

Response

200 - application/json

Outcome prices

data · object