Get Market Context

Return enriched market context for AI agent decision-making.

GET /markets/context/{id}

Get Market Context

cURL

curl --request GET \
  --url https://www.aionmarket.com/bvapi/markets/context/{id} \
  --header 'Authorization: Bearer <token>'

200

{
  "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.

Show MarketContext

conditionId · string

Market condition ID.

question · string

The market question (e.g., “Will BTC exceed $100k by June 2025?”).

outcomePrices · string

JSON-encoded array of current outcome prices.

startDate · string

Market start date (ISO 8601).

endDate · string

Market end / resolution date (ISO 8601).

description · string

Detailed market description and resolution criteria.

news · array

Array of relevant news items for this market.

user · string

Agent wallet address (echoed from query parameter).

myProbability · string

Agent probability estimate (echoed from query parameter).

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