mock-fintrade/terminal
v2 test-driver · gates · scenarios · docs

A test-driver that calls StarClear's v2 API like a real OMS would — single trades through ten pre-trade gates, synthetic intraday workloads from declarative templates, and built-in beginner-friendly docs that cover the securities concepts AND the technical surface.

Target environment
STARCLEAR_API_URL
https://starclear-staging.techspeedclearing.com
OAuth client
configured
01

Account status

Live AccountState snapshot — cash, margin BP, positions, open calls, day-trades — plus the 10 pre-trade gates evaluated against it.

/accounts/{id}
02

Compose a trade

One-off trade entry. Gates intercept BEFORE the v2 POST so over-cash buys / missing locates never reach staging.

/trade/new
03

Spec diagnostics

16-endpoint probe matrix vs the live v2 API. Surfaces which endpoints are implemented on staging vs documented-but-404.

/diagnostics/{id}
04

Docs

Securities primer + Scalar-rendered API reference + worked examples. Beginner-friendly on both the securities side and the tech side.

/docs
DoD probe

GET /api/v1/staging-probe → calls GET /v2/reference-data/trading via the OAuth2 client_credentials handshake + in-memory token cache. Used to confirm the deployment can actually reach staging.