Execution Intelligence
Everything you need to decide, monitor, and review an order lives under /v1/execution/*. These endpoints share the CC's book model, observation store, and TCA data — the same numbers that drive SOR routing are what you see here.
All endpoints require:
Authorization: Bearer seq_live_...Pre-trade Forecast
/v1/execution/forecastDecision engine that answers before you submit:
- Expected cost (median outcome)
- Downside cost (P90 bad outcome)
- Fill confidence at each cost level
- Capacity curve — cost as a function of size
- Venue ranking with landed cost (book + fee + latency)
- Urgency tradeoff — how much you save by waiting
Query Parameters
| Parameter | Description |
|---|---|
symbol | e.g., ETH-USD |
side | buy or sell |
qty | Size in human units (e.g., 10.0 for 10 ETH) |
Example
curl -H "Authorization: Bearer $KEY" \
"https://api.sequencemkts.com/v1/execution/forecast?symbol=ETH-USD&side=buy&qty=10"Returns a JSON object with the mid price, expected/downside costs, venue landed-cost ranking, capacity curve, and urgency tradeoffs.
Cold-resilient. On a cold ticker (one not in the edge's sticky subscription set), the handler runs the same fallback chain /v1/quotes uses — dynamic-subscribe + brief WS poll → edge-routed REST snapshot → venue public-API. First call takes ~200-500ms and returns real numbers; subsequent calls within the warm window are sub-ms. No explicit /v1/quotes warm-up is required. The same cold-fallback wraps /v1/intelligence/depth, /v1/intelligence/slippage, /v1/intelligence/routing, and /v1/orders/preview.
Scenario Simulator
/v1/execution/simulatePre-trade comparison of multiple strategies for the same order — aggressive, passive, split — with estimated cost, fill rate, venue count, and time to completion for each.
Query Parameters
| Parameter | Description |
|---|---|
symbol | Required. Trading pair |
side | Required. buy or sell |
qty | Required. Size in human units |
urgency | Optional. low, medium, high |
exclude_venues | Optional. Comma-separated venues to skip |
passive_only | Optional. true to restrict to passive strategies |
max_cost_bps | Optional. Drop strategies exceeding this expected cost |
Uses the same book-walking engine as /forecast, applied under different strategy assumptions so you can compare side-by-side.
Live Monitor
/v1/execution/live/{node_order_id}The endpoint a trader keeps open during execution. Answers:
- Am I ahead or behind?
- Should I reroute?
- Should I get more aggressive?
- Which venue is deteriorating?
Path Parameters
| Parameter | Description |
|---|---|
node_order_id | The node-level order ID returned when the graph was submitted |
Returns total qty, filled qty, fill percentage, remaining qty, per-fill breakdown, in-flight TCA, and venue-health signals while the order is live.
Post-trade Review
/v1/execution/review/{node_order_id}Consolidated post-trade analysis: one endpoint that returns:
- Order state — symbol, side, status, filled vs intended size
- Child-order timeline — each slice with venue, price, fill status, reject reason
- Decision audit — why SOR picked the actual venue, counterfactual best, selection error, forecast error, policy regret, model version
- Benchmark stack — slippage vs arrival mid, VWAP, TWAP, markouts
- TCA breakdown — cost decomposition when a TCA report exists for the parent
Use this as the single source of truth when answering "what happened on order X?"
Path Parameters
| Parameter | Description |
|---|---|
node_order_id | Parent node-order ID |
Desk Summary
/v1/execution/summaryAggregated desk-level execution metrics over a time range, computed from the in-memory order store and TCA reports.
Returns: total orders, total fills, total notional, slippage percentiles, per-venue breakdown, per-symbol breakdown.
Query Parameters
| Parameter | Default | Description |
|---|---|---|
start_date | today (UTC) | YYYY-MM-DD |
end_date | today (UTC) | YYYY-MM-DD |
symbol | all | Filter to one symbol |
venue | all | Filter to one venue |
Routing Decisions
/v1/execution/decisionsThe SOR decision log. Every time the router picks a venue / splits a parent, it writes a decision entry — this endpoint queries them.
Query Parameters
| Parameter | Description |
|---|---|
node_order_id | Optional. Return decisions tied to a specific parent |
last_n | Optional. Default 20, max 1000. Most-recent decisions across the desk |
Useful for debugging "why did this order land on Binance instead of Kraken?" without opening the full review payload.
Related
- Analytics / TCA — aggregated venue-quality and cost-attribution reports
- Orders & Graphs — submit the orders that produce these observations
- Smart Order Routing — how the cost model feeds every
/v1/execution/*endpoint