Skip to content

Post-trade analysis recipes, HORIZON JOIN reference, and VPIN#369

Open
bluestreak01 wants to merge 4 commits intomainfrom
vi_markout
Open

Post-trade analysis recipes, HORIZON JOIN reference, and VPIN#369
bluestreak01 wants to merge 4 commits intomainfrom
vi_markout

Conversation

@bluestreak01
Copy link
Member

@bluestreak01 bluestreak01 commented Feb 17, 2026

Preview:
https://preview-369--questdb-documentation.netlify.app/docs/cookbook/sql/finance/slippage/ also check sidebar
https://preview-369--questdb-documentation.netlify.app/docs/query/sql/horizon-join/

Summary

  • 9 new pages covering post-trade / TCA workflows and the HORIZON JOIN SQL reference
  • Sidebar reorganization with sub-categories under Capital Markets and a top-level Post-Trade Analysis entry for discoverability
  • Cross-linking improvements between reference docs and cookbook recipes
  • Mixed-precision timestamp docs added to ASOF JOIN, WINDOW JOIN, and HORIZON JOIN reference pages
  • Plugin fix: remote-repo-example no longer crashes the dev server on GitHub 404s

New recipe pages (documentation/cookbook/sql/finance/)

Page Description
slippage.md Per-fill slippage against mid and top-of-book (ASOF JOIN)
slippage-aggregated.md Aggregated slippage by ECN, counterparty, passive/aggressive, size bucket, hourly heatmap, daily P&L (ASOF JOIN + HORIZON JOIN + PIVOT)
markout.md Post-trade markout curves with 7 variations: by side, single-side, counterparty toxicity, passive vs aggressive (HORIZON JOIN)
last-look.md Millisecond-granularity markout for FX last-look detection (HORIZON JOIN)
implementation-shortfall.md Perold IS decomposition into spread, permanent, and temporary impact (HORIZON JOIN + PIVOT)
implementation-shortfall-order.md Order-level IS, execution drift, spread cost, permanent vs temporary impact (ASOF JOIN + HORIZON JOIN + PIVOT)
ecn-scorecard.md Dashboard-style venue comparison: fill quality, markout curves, toxicity by hour/passive/composite, pivoted scorecard (ASOF JOIN + HORIZON JOIN + PIVOT)
vpin.md Volume-synchronized Probability of Informed Trading, including per-ECN variant (window functions)

New reference page

Page Description
horizon-join.md Full SQL reference for HORIZON JOIN: RANGE/LIST syntax, horizon pseudo-table, interval units, mixed-precision timestamps, examples, limitations

Modified files

File Change
sidebars.js Sub-categories under Capital Markets; top-level Post-Trade Analysis entry; HORIZON JOIN in SELECT section
cookbook/sql/finance/index.md New Post-Trade Analysis section with all new recipes; VPIN added to Volume & Order Flow
cookbook/index.md Added structure breakdown and post-trade callout for discoverability
query/sql/asof-join.md Mixed-precision timestamps section; cookbook recipe cross-links
query/sql/window-join.md Mixed-precision timestamps section
plugins/remote-repo-example/index.js Changed throw to console.warn + continue for 404 on individual remote code files

Test plan

  • Verify dev server starts without errors (yarn start)
  • Check sidebar renders correctly: sub-categories under Capital Markets, top-level Post-Trade Analysis, no duplicates
  • Spot-check new recipe pages render with correct SQL syntax highlighting
  • Verify HORIZON JOIN reference page renders (interval units table, pseudo-table table, code blocks)
  • Confirm internal links resolve (especially ASOF JOIN → recipe cross-links and recipe → reference back-links)
  • Check that demo-tagged queries only appear on ASOF-JOIN / window-function recipes (not HORIZON JOIN ones)

🤖 Generated with Claude Code

bluestreak01 and others added 2 commits February 17, 2026 17:17
Add 9 new documentation pages covering post-trade/TCA workflows:
- Slippage per fill and aggregated slippage (by venue, counterparty, size bucket, time of day, daily P&L)
- Post-trade markout analysis with HORIZON JOIN (curves, by side, counterparty toxicity, passive/aggressive)
- Last look detection (millisecond-granularity markout)
- Implementation shortfall decomposition (by symbol with PIVOT, per order)
- ECN scorecard (venue comparison, markout curves, toxicity by hour/passive/composite, pivoted)
- VPIN (volume-synchronized informed trading probability, per ECN)
- HORIZON JOIN SQL reference (RANGE/LIST syntax, pseudo-table, interval units, mixed-precision timestamps)

Reorganize sidebar with sub-categories under Capital Markets and top-level Post-Trade Analysis entry.
Add mixed-precision timestamp docs to ASOF JOIN, WINDOW JOIN, and HORIZON JOIN reference pages.
Add cookbook cross-links from ASOF JOIN reference and cookbook overview.
Fix remote-repo-example plugin crash on 404 (warn instead of throw).

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@github-actions
Copy link

github-actions bot commented Feb 17, 2026

🚀 Build success!

Latest successful preview: https://preview-369--questdb-documentation.netlify.app/docs/

Commit SHA: 88a0330

📦 Build generates a preview & updates link on each commit.

bluestreak01 and others added 2 commits February 18, 2026 09:29
- New landing page for Post-Trade Analysis sidebar section with audience
  context, key concepts glossary, recipe progression, and QuestDB value prop
- Add Overview as explicit sidebar item under Post-Trade Analysis
- Add VPIN to Post-Trade Analysis sidebar
- Remove "requires local instance" disclaimers for HORIZON JOIN recipes
  (shipping together with this documentation)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
- Replace bids[1][1]/asks[1][1] with best_bid/best_ask across all
  post-trade recipes and HORIZON JOIN reference
- Fix ECN toxicity by hour and composite toxicity score queries:
  add h.offset to SELECT to satisfy HORIZON JOIN GROUP BY requirement
- Fix hourly slippage query: remove invalid GROUP BY after SAMPLE BY
- Update post-trade overview to document best_bid/best_ask columns
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants

Comments