Skip to main content
GET
Get trade execution guidance

Path Parameters

platform
string
required
Example:

"kalshi"

market_id
string
required
Example:

"KXAGICO-COMP-28Q1"

Response

Successful Response

Optimal trade execution analysis from tick data.

market_id
string
required

Market identifier

platform
string
required

kalshi, polymarket, robinhood, or coinbase

title
string
default:""

Market title

current_bid
number | null

Current best YES bid

Required range: 0 <= x <= 1
current_ask
number | null

Current best YES ask

Required range: 0 <= x <= 1
current_spread
number | null

Current bid-ask spread

Required range: x >= 0
avg_spread_48h
number | null

Average spread over last 48h

Required range: x >= 0
spread_percentile
number | null

Current spread percentile vs 48h history (lower = tighter than usual)

Required range: 0 <= x <= 100
spread_trend
string
default:stable

Spread direction: 'tightening', 'widening', or 'stable'

liquidity_score
integer
default:50

Liquidity quality 0-100 based on spread + volume

Required range: 0 <= x <= 100
estimated_slippage_pct
number
default:0

Estimated slippage as percentage of price

Required range: x >= 0
recommendation
string
default:MARKET_ORDER

LIMIT_ORDER, MARKET_ORDER, or WAIT

suggested_limit_price
number | null

Suggested limit price (midpoint adjusted for spread direction)

Required range: 0 <= x <= 1
rationale
string
default:""

Explanation of the recommendation

upcoming_event
string | null

Nearby event that may affect spreads

hours_to_event
number | null

Hours until the next relevant event

Required range: x >= 0
tick_count
integer
default:0

Number of ticks analyzed

Required range: x >= 0
generated_at
string<date-time>

When this guidance was generated