Skip to main content
GET
/
markets
/
context
/
{id}
Get Market Context
curl --request GET \
  --url https://pm-t1.bxingupdate.com/bvapi/markets/context/{id} \
  --header 'Authorization: Bearer <token>'
{
  "market": {},
  "positions": {},
  "warnings": [
    "<string>"
  ],
  "safeguards": {}
}
Retrieve comprehensive market context data for a specific market condition, including latest prices, news summaries, and optional personalized information. This is the primary endpoint AI agents use to gather decision-making context.

​
Path Parameters

​
id
string
required
Market condition ID — the unique identifier of the market condition to retrieve context for.

​
Query Parameters

​
user
string
Agent wallet address. When provided, the response includes the agent’s current positions and probability estimate for this market.
​
myProbability
string
The agent’s own probability estimate (0-1). Passed through to the response so upstream callers can compare agent vs. market estimates.
​
venue
string
default:"polymarket"
Trading venue identifier. Default: polymarket.

​
Response

​
data
object
Market context object containing enriched 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

​
id
string
required

Market ID (condition ID)

Query Parameters

​
venue
string
default:polymarket

Trading venue (default: polymarket)

Maximum string length: 50
​
user
string

Wallet address for position lookup

Maximum string length: 255
​
myProbability
number

Your probability assessment (0-1) for edge hints

Required range: 0 <= x <= 1

Response

200 - application/json

Market context

​
market
object

Market details including question, prices, liquidity, and outcomes

​
positions
object

Current user positions and order summary for this market

​
warnings
string[]

Pre-trade risk warnings and alerts

​
safeguards
object

Suggested risk thresholds and cost hints