Skip to main content
GET
/
markets
/
{market_id}
Get Market
curl --request GET \
  --url https://pm-t1.bxingupdate.com/bvapi/markets/{market_id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "<string>",
  "question": "<string>",
  "conditionId": "<string>",
  "slug": "<string>",
  "description": "<string>",
  "outcomes": "<string>",
  "outcomePrices": "<string>",
  "volume": "<string>",
  "liquidity": "<string>",
  "active": true,
  "closed": true,
  "category": "<string>",
  "endDate": "2023-11-07T05:31:56Z",
  "startDate": "2023-11-07T05:31:56Z",
  "image": "<string>",
  "clobTokenIds": "<string>",
  "volumeNum": 123,
  "liquidityNum": 123,
  "bestBid": 123,
  "bestAsk": 123,
  "lastTradePrice": 123,
  "spread": 123,
  "oneDayPriceChange": 123,
  "oneWeekPriceChange": 123,
  "enableOrderBook": true,
  "acceptingOrders": true,
  "events": [
    {}
  ],
  "tags": [
    {}
  ]
}
Get a single market by ID with full details from Polymarket.

​
Overview

Retrieve the complete market object for a given Polymarket market ID. The response includes pricing, volume, outcomes, event metadata, and order book configuration. Use this before placing trades or building market detail views.

​
Example

curl -X GET "https://pm-t1.bxingupdate.com/bvapi/markets/512357" \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Response

{
  "id": "512357",
  "question": "Will BTC exceed $100k by end of June?",
  "conditionId": "0xabc123...",
  "slug": "will-btc-exceed-100k-by-end-of-june",
  "description": "This market resolves to Yes if...",
  "outcomes": "[\"Yes\",\"No\"]",
  "outcomePrices": "[\"0.65\",\"0.35\"]",
  "volume": "125000.50",
  "liquidity": "45000.00",
  "active": true,
  "closed": false,
  "category": "Crypto",
  "endDate": "2026-06-30T23:59:59Z",
  "startDate": "2026-01-01T00:00:00Z",
  "image": "https://polymarket-upload.s3.us-east-2.amazonaws.com/...",
  "clobTokenIds": "[\"12345\",\"67890\"]",
  "volumeNum": 125000.50,
  "liquidityNum": 45000.00,
  "bestBid": 0.64,
  "bestAsk": 0.66,
  "lastTradePrice": 0.65,
  "spread": 0.02,
  "oneDayPriceChange": -0.03,
  "oneWeekPriceChange": 0.05,
  "enableOrderBook": true,
  "acceptingOrders": true,
  "events": [],
  "tags": []
}

​
Response Fields

FieldTypeDescription
idstringPolymarket market ID
questionstring | nullMarket question
conditionIdstringCondition token ID
slugstring | nullURL slug
descriptionstring | nullMarket description
outcomesstringJSON-encoded array of outcome labels
outcomePricesstringJSON-encoded array of outcome prices
volumestring | nullTotal volume traded
liquiditystring | nullCurrent liquidity
activebooleanWhether the market is active
closedbooleanWhether the market is closed
categorystring | nullMarket category
endDatestring | nullMarket end date
startDatestring | nullMarket start date
imagestring | nullMarket image URL
clobTokenIdsstringJSON-encoded array of CLOB token IDs
volumeNumnumberTotal volume (numeric)
liquidityNumnumberCurrent liquidity (numeric)
bestBidnumber | nullBest bid price
bestAsknumber | nullBest ask price
lastTradePricenumber | nullLast trade price
spreadnumber | nullCurrent spread
oneDayPriceChangenumber | null24-hour price change
enableOrderBookbooleanWhether order book is enabled
acceptingOrdersbooleanWhether the market accepts orders
eventsarrayAssociated events
tagsarrayMarket tags

​
Common Errors

CodeMeaning
401Missing or invalid API key
404Market not found on Polymarket
500Server-side error

​
Use Cases

  • Display market detail pages with pricing data.
  • Pre-trade validation to confirm market status before execution.
  • Build dashboards showing real-time market information.

Authorizations

​
Authorization
string
header
default:YOUR_API_KEY
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
market_id
string
required

Polymarket market ID

Query Parameters

​
venue
string
default:polymarket

Trading venue (default: polymarket)

Maximum string length: 50
​
includeTag
boolean

Include market tag data

Response

Market details

​
id
string

Polymarket market ID

​
question
string | null

Market question

​
conditionId
string

Condition token ID

​
slug
string | null
​
description
string | null
​
outcomes
string

JSON-encoded array of outcome labels

​
outcomePrices
string

JSON-encoded array of outcome prices

​
volume
string | null
​
liquidity
string | null
​
active
boolean
​
closed
boolean
​
category
string | null
​
endDate
string<date-time> | null
​
startDate
string<date-time> | null
​
image
string | null
​
clobTokenIds
string

JSON-encoded array of CLOB token IDs

​
volumeNum
number
​
liquidityNum
number
​
bestBid
number | null
​
bestAsk
number | null
​
lastTradePrice
number | null
​
spread
number | null
​
oneDayPriceChange
number | null
​
oneWeekPriceChange
number | null
​
enableOrderBook
boolean
​
acceptingOrders
boolean
​
events
object[]
​
tags
object[]