Skip to main content
GET
Context
Per-venue positions. An agent can hold positions on the same market across multiple venues simultaneously (e.g., sim paper trade + real Polymarket position). The positions container has sim, polymarket, and kalshi fields — each is either null or a position object.Use ?venue=sim|polymarket|kalshi|all to filter (default all). The flat position field is preserved for backwards compatibility and mirrors the first non-null venue.

Path Parameters

market_id
string
required

Query Parameters

my_probability
number | null

Your probability estimate (0-1) for edge calculation

Required range: 0 <= x <= 1
venue
string | null
default:all

Venue filter for position lookup: 'all' (default), 'sim', 'polymarket', or 'kalshi'. Response always includes per-venue positions in the positions field.

Response

Successful Response

Full SDK context response.

market
SDKContextMarket · object
required

Market info for SDK context.

position
SDKContextPosition · object
required

Position info for SDK context.

discipline
SDKContextDiscipline · object
required

Trading discipline info for SDK context.

positions
SDKContextPositions · object | null

Per-venue positions for a single market.

An agent can hold positions on the same market across multiple venues simultaneously (sim paper-trading + real Polymarket/Kalshi). Each field is populated independently based on that venue's position storage:

  • sim: from agent_market_positions
  • polymarket: aggregated from real_trades (venue='polymarket')
  • kalshi: aggregated from real_trades (venue='kalshi')

Fields are None when no position exists on that venue.

recent_trades
SDKContextTrade · object[]
slippage
SDKContextSlippage · object | null

Slippage info for SDK context.

edge
SDKContextEdge · object | null

Edge analysis for trading decisions.

Helps skills determine if a trade is worth making based on:

  • suggested_threshold: Time-adjusted minimum edge (higher = more conservative)
  • user_edge: Calculated edge if user provided their probability estimate
  • recommendation: TRADE / HOLD / SKIP based on edge vs threshold
warnings
string[]