Sequence/docs

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:

http
Authorization: Bearer seq_live_...

Pre-trade Forecast

GET/v1/execution/forecast

Decision 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

ParameterDescription
symbole.g., ETH-USD
sidebuy or sell
qtySize in human units (e.g., 10.0 for 10 ETH)

Example

bash
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

GET/v1/execution/simulate

Pre-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

ParameterDescription
symbolRequired. Trading pair
sideRequired. buy or sell
qtyRequired. Size in human units
urgencyOptional. low, medium, high
exclude_venuesOptional. Comma-separated venues to skip
passive_onlyOptional. true to restrict to passive strategies
max_cost_bpsOptional. 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

GET/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

ParameterDescription
node_order_idThe 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

GET/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

ParameterDescription
node_order_idParent node-order ID

Desk Summary

GET/v1/execution/summary

Aggregated 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

ParameterDefaultDescription
start_datetoday (UTC)YYYY-MM-DD
end_datetoday (UTC)YYYY-MM-DD
symbolallFilter to one symbol
venueallFilter to one venue

Routing Decisions

GET/v1/execution/decisions

The SOR decision log. Every time the router picks a venue / splits a parent, it writes a decision entry — this endpoint queries them.

Query Parameters

ParameterDescription
node_order_idOptional. Return decisions tied to a specific parent
last_nOptional. 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.