Skip to content

Bureau — Red Team (offensive)

Market-Honest

Best-execution and disclosed-strategy claims in equity markets are typically enforced through self-reporting and periodic audit. Market-Honest signs every fill, evaluates each fill against the NBBO at execution time, and detects cross-exchange pump-and-dump patterns. When a dossier is decisive, Bounty auto-files with FINRA or the SEC.

Posture: 🔴 Red Team (offensive)   ·   Status: alpha

What it does

US securities markets run on three claims that today are mostly enforced by self-reporting plus periodic audit. Best execution means a broker has to fill your order at or better than the NBBO (National Best Bid and Offer – the best available bid and ask across all US exchanges at the time of execution). Disclosed strategy means a hedge fund or market-maker has to behave consistently with the trading approach they registered with regulators. Manipulation prohibitions (SEC Rule 10b-5 under the Securities Exchange Act of 1934) prohibit pump-and-dump schemes – coordinated buying that inflates a stock followed by coordinated selling at the top. all three are routinely violated and enforcement is slow because the observations are messy.

Market-Honest signs the relevant data per-fill and runs three detectors continuously. Model swap: the issuer registers a StrategyFingerprint – a centroid feature vector over order-flow stochastics. Every signed Fill carries its actual order-flow vector. Deviation more than 3 sigma fires a model-swap proof. Best-execution-fail: every fill carries the NBBO at execution. The arithmetic is purely mechanical – buy filled above NBBO ask plus tolerance (default 5 basis points = 0.05%) or sell below NBBO bid minus tolerance fires best-execution-fail. Pump-and-dump: synchronized buys across 3+ distinct venues within 60 seconds, followed by synchronized sells across the same venues within 5 minutes. Single-venue whales (legitimate large institutional fills) do not fire – only coordinated cross-exchange rings.

Who would use it

  • A retail broker (Robinhood, Schwab) that wants verifiable best-execution attestation as a competitive differentiator.
  • A regulator (SEC, FINRA) building an enforcement observation base independent of broker self-reporting.
  • A hedge fund's compliance officer continuously verifying their own deployed strategy matches disclosure.
  • An institutional investor measuring real best-execution quality across counterparty brokers.
  • A short-seller or activist investor building a pump-and-dump dossier for an SEC complaint.

What you'll need

  • The Pluck CLI (npm install -g @sizls/pluck-cli).
  • For per-fill signing: integration with your order management system to emit a signed Fill for every execution. Pluck ships reference adapters for FIX 4.4 and FIX 5.0.
  • An NBBO feed at execution time. The Pluck CLI accepts SIP feed (CTA, UTP) or proprietary consolidated feeds.
  • A registered StrategyFingerprint – the issuer's auditor signs this when the strategy is disclosed to FINRA or SEC.
  • For the regulator side: a verifier that re-derives centroid math and NBBO arithmetic from signed fills. Runs on a regulator laptop, no broker cooperation needed.

Step-by-step

The alpha runs the full constraint chain on synthetic fills, NBBO data, and strategy fingerprints – there is no live FIX integration yet. Production capture and verify ship in a follow-up. To exercise the system today:

Shell
pluck bureau market-honest demo

Expected output: the system ingests one disclosed strategy and eight signed fills (one baseline, one model-swap, one best-execution-fail, three pump, three dump), and emits three signed proofs (model-swap, best-execution-fail, pump-and-dump). Each proof carries the offending fills, the NBBO arithmetic when applicable, and the cross-venue ring membership when applicable.

What to do with the output: in production, brokers stream signed fills to their own Rekor namespace. Regulators run continuous verifiers that re-derive every claim. A pump-and-dump dossier auto-files via Bounty to FINRA or SEC; a best-execution-fail proof becomes the basis for a customer-facing PFOF rebate or a regulatory action.

Run it yourself

Drop this into a Node 18+ project (npm install @sizls/pluck-bureau-market-honest @sizls/pluck-bureau-core tsx):

TypeScript
// index.ts
import { createHash } from "node:crypto";
import {
  createMarketHonestSystem,
  fingerprintPrivateKey,
  signCanonicalBody,
} from "@sizls/pluck-bureau-market-honest";
import { generateOperatorKey } from "@sizls/pluck-bureau-core";

const sha256 = (s: string) => createHash("sha256").update(s).digest("hex");
const flush = (n = 60) => new Promise<void>((r) => { let i = 0; const tick = () => (++i >= n ? r() : setImmediate(tick)); setImmediate(tick); });

async function main() {
  const op = generateOperatorKey();
  const venue = generateOperatorKey();
  const venueFp = fingerprintPrivateKey(venue.privateKeyPem);

  const system = createMarketHonestSystem({
    signingKey: op.privateKeyPem,
    disablePausePoll: true,
    disableLogging: true,
    tolerances: { deviationSigmaThreshold: 3, bestExecutionBps: 5, minPumpVenues: 3, pumpWindowMs: 60_000, dumpWindowMs: 300_000 },
  });

  // One best-execution fail: buy at 10.50 when NBBO ask is 10.00 (500 bps over a 5 bps tolerance).
  const skeleton = {
    schemaVersion: 1 as const, side: "buy" as const, qty: 50, price: 10.5,
    venue: "venue-b", symbol: "ACME", modelIdHash: sha256("model:salt"),
    nbboBid: 9.99, nbboAsk: 10.0, counterpartyIdHash: sha256("cp:1"),
    orderFlowVector: [10, 0.5, 0.2, 0.8, 0.4],
    observedAt: "2026-04-26T03:00:00.000Z", observerFingerprint: venueFp,
  };
  const fillId = sha256(JSON.stringify(skeleton));
  const { signature } = signCanonicalBody({ ...skeleton, fillId }, venue.privateKeyPem);

  try {
    system.observeFill({ ...skeleton, fillId, signature });
    await flush();
    for (const p of system.facts.proofs()) {
      console.log(`proof kind=${p.kind} id=${p.proofId.slice(0, 16)}`);
    }
  } finally {
    await system.shutdown();
  }
}

main().catch((err) => { console.error(err); process.exit(1); });

Run with tsx index.ts. Expected output:

proof kind=best-execution-fail id=…

▶ Open in StackBlitz – runs in your browser, no install required.

What you get

A signed MarketHonest.Proof with one of three kind values:

  • model-swap – deployed order-flow vector deviates more than 3 sigma from the disclosed strategy centroid.
  • best-execution-fail – buy fill above NBBO ask plus tolerance, or sell below NBBO bid minus tolerance.
  • pump-and-dump – synchronized buys across 3+ venues within 60 seconds followed by synchronized sells within 5 minutes.

The Bureau never carries raw client-account identifiers. Counterparty IDs and model IDs are hashed before signing. Notarized proofs cannot dox a brokerage's client list or enumerate vendor model catalogs.

What it can't do

  • Market-Honest cannot evaluate the quality of a disclosed strategy – only its consistency with deployment.
  • Single-venue manipulation (e.g., a fund running a wash-trade ring on one exchange) requires cross-tick analysis Market-Honest does not yet implement.
  • The NBBO feed is a trust anchor. If you trust an inaccurate consolidated feed, your best-execution arithmetic is wrong. Use a regulator-published reference SIP feed for litigation-grade attestation.
  • Coordinated-but-legal trading (e.g., index rebalance windows) can superficially resemble pump-and-dump. The 60s-then-5min pattern is tuned to minimize false positives but cannot be eliminated.

A real-world example

A retail trader observes a small-cap stock spiking 40% on no news, then collapsing within 4 minutes. The trader retrieves the public Market-Honest Rekor entries for that ticker on that day. The verifier re-derives the activity: synchronized buys at venues A, B, and C within a 38-second window, followed by synchronized sells at the same three venues within 4 minutes 12 seconds. A pump-and-dump proof has already been auto-filed with FINRA via Bounty. The trader files an SEC tip referencing the Rekor entry. The ring's operators are subsequently charged, and the trader is eligible for a whistleblower award under SEC Section 21F.


For developers

Predicate URIs

URIWhat it attests
https://pluck.run/MarketHonest.Fill/v1Per-fill signed trade observation plus NBBO plus order-flow vector.
https://pluck.run/MarketHonest.BotProbe/v1Dragnet-style external probe of a market-maker public API.
https://pluck.run/MarketHonest.Strategy/v1Disclosed strategy fingerprint (vendor / regulator commitment).
https://pluck.run/MarketHonest.Proof/v1Published proof with kind (model-swap, best-execution-fail, pump-and-dump).

Programs composed

  • Dragnet – probe-pack scraping of public market-maker and trading-bot APIs.
  • Fingerprint – order-flow centroid math for model-swap detection.
  • Custody – fill → reporting-leg → regulator submission chain.
  • Bounty – auto-file routing to FINRA and SEC.

Threat model + adversary

Adversaries: a broker who routes orders to internalized venues at worse than NBBO, a hedge fund that swaps strategies post-disclosure, a coordinated pump ring, a regulator who would prefer the observations didn't surface. Market-Honest closes the per-fill, per-strategy, and cross-venue holes. See Threat Model.

Verify a published cassette

Shell
pluck bureau verify <bundle-dir>
cosign verify-blob --key <pubkey.pem> --signature <sig> --type https://pluck.run/MarketHonest.Proof/v1 <body.json>

Every proof is a DSSE envelope notarized to Rekor. SEC and FINRA verifiers re-derive the centroid math from signed Fill bodies, recompute the NBBO arithmetic, verify Ed25519 signatures against each venue's published signing-key fingerprint, and confirm pump-and-dump ring membership. Verification requires only Rekor plus the published StrategyFingerprint – no broker cooperation.

See also

Edit this page on GitHub
Previous
Coordinated

Ready to build?

Install Pluck and follow the Quick Start guide to wire MCP-first data pipelines into your agents and fleets in minutes.

Get started →