tikr

⚠️ READ THIS FIRST — FINANCIAL RISK WARNING ⚠️

This is experimental software for educational and personal research use only. It is NOT financial advice and NOT a production trading system.

• You can lose ALL of your money. Market making, perpetual futures, and any leveraged trading carries unlimited downside risk including liquidation and negative balance.
• Bugs in this code WILL lose you money if you run it with real funds. This is pre-alpha, unaudited, written by hobbyists with no fiduciary relationship to you.
• You are 100% responsible for any losses, regulatory consequences, tax obligations, exchange TOS violations, and account actions resulting from running this bot. The authors accept ZERO liability.
• Test on testnet only until you fully understand the code. Even then, start with the smallest possible position sizes if you ever go live.
• Manipulation, wash trading, and other prohibited strategies are NOT legal on DEXs either — see the Mango Markets case. Don't use this for anything that would violate your jurisdiction's market-abuse laws or your exchange's terms of service.
• Run only on accounts you can afford to zero out. Never trade with money you need for rent, debt, dependents, or anything else.

By cloning, building, or running this software you acknowledge that you have read this warning and that any financial loss is entirely your own responsibility. See LICENSE (MIT — "AS IS, WITHOUT WARRANTY OF ANY KIND").

Modular, venue-agnostic market-making engine in Rust. Pre-alpha — parquet backtest engine, a multi-strategy library, a live Binance USD-M / Spot adapter, and a config-driven multi-bot orchestrator (tikr). Unaudited; see the risk warning above before running it with real funds.

Pre-alpha, under active development. Live trading paths exist and are unaudited — treat every release as experimental. Watch Roadmap & exit criteria for progress.

Why?

Most open-source MM bots (including mxaddict/mmaker, 2017) fail on the same things: inventory-blind quoting, broken post-only handling, no kill switches, no backtest-first discipline. tikr is the do-over — built backtest-first, venue-agnostic, with risk limits before live capital.

Crates

Crate	Role
tikr-core	Vocabulary types: Price, Size, Symbol, Position, Snapshot, MarketEvent, Fill
tikr-venue	Venue trait — abstracts over CEX orderbooks, DEX orderbooks, AMMs via quote-intent model
tikr-strategy	Strategy trait + impls (Wave, Tide, SpreadScalp, AvellanedaStoikov, GLFT, TopOfBook, …)
tikr-hyperliquid	Hyperliquid perp adapter
tikr-binance	Binance Spot + USD-M Futures adapter (HMAC + Ed25519 auth, WS-API session.logon)
tikr-backtest	Parquet replay engine + FillSim (queue-priority + cancel modeling) — library only
tikr-record	Market-data recorder: Binance WS depth + trades → parquet (record_binance bin)
tikr-paper	Paper-trading runner (live feed + simulated fills) + compare strategy sweep
tikr-risk	Risk engine — pre-trade limits, drawdown gates, alerting

Crates land as phases ship. See roadmap.

Status

Pre-alpha and unaudited. Live adapters and the multi-bot orchestrator work, but the engine is still being tuned. Run only with capital you can afford to lose.

Install

# build from source
git clone https://github.com/kryptic-sh/tikr.git
cd tikr
cargo build --release --workspace

Binaries land in ./target/release/. Key entry points:

Bin	Crate	Purpose
tikr	apps/tikr	Multi-bot live/paper orchestrator + TUI (main entry point)
record_binance	tikr-record	Record Binance market data (depth + aggTrade) to parquet
compare	tikr-paper	Backtest a preset sweep on parquet; table + optional JSON
run_spot (example)	tikr-binance	Live Binance Spot runner (testnet/mainnet)

Development

git clone git@github.com:kryptic-sh/tikr.git
cd tikr
rustup toolchain install stable
cargo test --workspace

Usage

Record market data to parquet

# Binance Futures USD-M, 1 hour, ./data
cargo run --release --bin record_binance -- \
  --env futures-mainnet --symbols BTCUSDT --hours 1 --out ./data

Recorder writes book_<BASE>_<DATE>_<NNNNNN>.parquet + trades_<BASE>_<DATE>_<NNNNNN>.parquet per flush (1000 rows or 60 s).

Backtest strategies against recorded data

compare is the single backtest entry point: it sweeps a set of strategy presets over the same recorded events (apples-to-apples) and prints a fills, fills/min, realized, fees, NET, $/fill table. Pass single-element sweep lists to backtest one configuration, and --report-json <path> to dump the per-preset PaperReport for downstream tooling.

# Full preset sweep
cargo run --release --bin compare -- \
  --data-dir ./data --symbol BTCUSDC \
  --maker-bps 2 --taker-bps 5

# Single Wave config → machine-readable report
cargo run --release --bin compare -- \
  --data-dir ./data --symbol BTCUSDC \
  --wave-step-bps-list 5 --wave-inner-bps-list 5 --wave-grid-levels-list 4 \
  --report-json ./wave.json

Venue filters (price tick, lot step, min_notional) auto-detect from Binance exchangeInfo by default (--no-autodetect-filters + --tick-size/--step-size for offline runs; --venue-env picks the env). Account sizing mirrors the live bot: --sim-initial-balance × --sim-order-balance-pct per order, a --sim-max-position-pct wallet cap, and --leverage for the exchange margin backstop. Latency is probed from the live API by default (10 pings → mean latency + stddev jitter; --no-measure-latency falls back to --sim-submit-latency-ms / --sim-cancel-latency-ms / --sim-latency-jitter-ms).

Sample config — config.toml

The repo's config.toml runs the Wave strategy (frozen fixed-step lattice + round-trip refill) on Binance USD-M perp futures, USDC-margined (0 bps maker promo). It currently holds a handful of USDC bots (NEAR / ZEC / WLD), each sized at order_balance_pct of the wallet per order with a max_position_pct cap and 5× leverage. Re-read the warning above before pointing it at real funds.

Run live (testnet first!)

# Multi-bot orchestrator (config-driven; testnet env in config.toml first!)
cargo run --release --bin tikr -- --config config.toml

# Single-symbol Binance Spot smoke test (example)
cargo run --release --example run_spot -- \
  --env spot-testnet --symbol BTCUSDT --minutes 5

Auth lives in .env (gitignored). Use Ed25519 PEM for spot (mandatory) or HMAC for futures — see .env.example.

Contributing

See the org-wide CONTRIBUTING guide. Phase 0 is design-heavy — comment on open design issues before opening PRs.

For security issues, see the org-wide SECURITY policy.

License

MIT. See LICENSE.