Workflow: Market Analysis

​

Goal

• current market state
• liquidity and spread context
• execution impact estimate
• explicit go/no-go and constraints

​

Inputs

• condition_id (required)
• optional thesis horizon (intraday, 1d, 1w, event_horizon)
• planned side (BUY or SELL)
• intended size in USDC

​

Recommended tool sequence

​

1) Pull market and event context

• get_market with condition_id
• get_event from the related event id when available

​

2) Pull batched market data

• get_order_books
• get_prices
• get_midpoints
• get_spreads
• get_last_trade_prices

{
  "tool": "get_prices",
  "input": {
    "items": [{ "token_id": "<target_token_id>", "side": "BUY" }]
  }
}

• spread regime (tight/normal/wide)
• visible depth near midpoint
• last trade versus current best price

​

3) Estimate execution impact

{
  "tool": "calculate_market_price",
  "input": {
    "token_id": "<target_token_id>",
    "side": "BUY",
    "amount": "250"
  }
}

​

4) Gather execution metadata

• get_fee_rate_bps
• get_tick_size
• get_neg_risk

​

5) If execution is approved, hand off to trading wrappers

• prepare_order to locally prepare/sign a draft without posting
• place_order with confirm: true only at the final execution step
• cancel_orders if you need an explicit unwind/cancel path

​

Suggested output contract

{
  "thesis": "short rationale",
  "confidence": 0.0,
  "market_state": {
    "status": "active|closed|...",
    "best_price": 0.0,
    "midpoint": 0.0,
    "spread": 0.0,
    "last_trade": 0.0
  },
  "execution": {
    "side": "BUY",
    "amount_usdc": "250",
    "estimated_price": 0.0,
    "max_slippage_bps": 0,
    "suggested_limit_price": 0.0
  },
  "risks": ["liquidity", "event timing"],
  "go_no_go": "GO|NO_GO",
  "fallback_plan": "what to do if liquidity degrades"
}

​

Optional: use the built-in prompt

• condition_id
• horizon
• include_orderbook_depth
• include_recent_trades