Skip to main content
GET
/
v1
/
markets
/
{platform}
/
{market_id}
/
execution
Get trade execution guidance
curl --request GET \
  --url https://api.example.com/v1/markets/{platform}/{market_id}/execution
{
  "avg_spread_48h": 0.03,
  "current_ask": 0.64,
  "current_bid": 0.6,
  "current_spread": 0.04,
  "estimated_slippage_pct": 0.8,
  "generated_at": "2026-03-21T14:30:00Z",
  "hours_to_event": 18.5,
  "liquidity_score": 68,
  "market_id": "KXFED-26MAR19",
  "platform": "kalshi",
  "rationale": "Spread is wider than usual (72nd percentile). Use a limit order at 0.61 to capture midpoint. Avoid market orders — slippage ~0.8% at current depth.",
  "recommendation": "LIMIT_ORDER",
  "spread_percentile": 72,
  "spread_trend": "widening",
  "suggested_limit_price": 0.61,
  "tick_count": 96,
  "title": "Will the Fed cut rates at the March 2026 meeting?",
  "upcoming_event": "FOMC Statement"
}

Path Parameters

​
platform
string
required
​
market_id
string
required

Response

Successful Response

Optimal trade execution analysis from tick data.

​
market_id
string
required

Market identifier

​
platform
string
required

kalshi, polymarket, or robinhood

​
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