MarketDeck docs

executions

Canonical execution ledger across real perp, paper spot, and paper perp activity.

marketdeck executions gives plugins and scripts one read-only ledger surface instead of stitching together real trade logs, paper spot fills, and paper perp closed positions themselves.

Usage#

marketdeck executions <list|sync|export|stats|reconcile> [flags]

Subcommand	What it does
`list [--wallet W] [--source S] [--from D] [--to D] [--limit N]`	Newest-first ledger rows.
`sync [--days-back N]`	Build the canonical ledger view and return source counts.
`export [--csv] [filters...]`	Export matching ledger rows as JSON or CSV.
`stats [--from D] [--to D]`	Count and realised-PnL summary by source.
`reconcile [filters...]`	Check duplicate ids and missing ledger fields across sources.

Sources are all, real-perp, paper-spot, and paper-perp.

Examples#

marketdeck executions list --limit 20 --format json
marketdeck executions list --wallet paper-demo --source paper-spot
marketdeck executions stats --from 2026-04-01 --format text
marketdeck executions reconcile --format json
marketdeck executions export --csv --source real-perp > executions.csv

This command is read-only. It does not mutate exchange state or paper-wallet state; sync only materialises the current ledger view for the caller.