Fize/mmtickerlab / sim-trade
sim-trade
VerifiedA 股专用的确定性模拟交易系统。具备严格的数据真实性门禁、五档盘口真实撮合、T+1 规则、持仓盈亏计算及 SQLite 可审计流水账本。当用户需要进行模拟交易下单、模拟买入/卖出、查询模拟盘持仓、账户资产或重置模拟盘时触发(包含触发词:模拟买入, 模拟卖出, 模拟交易, 查持仓, 模拟盘, 交易账本, sim trade, paper trading)。
| File | Kind | Size |
|---|---|---|
| .clawhubignore | other | 63 B |
| SKILL.md | skill md | 2.5 KB |
| agents/openai.yaml | config | 258 B |
| references/command_reference.md | markdown | 1.4 KB |
| references/data_contract.md | markdown | 2.9 KB |
| references/trading_rules.md | markdown | 2.3 KB |
| requirements.txt | manifest | 101 B |
| scripts/akshare_patch.py | script | 2.9 KB |
| scripts/simtrade.py | script | 10.0 KB |
| scripts/simtrade_core/__init__.py | script | 105 B |
| scripts/simtrade_core/database.py | script | 6.4 KB |
| scripts/simtrade_core/fees.py | script | 1.7 KB |
| scripts/simtrade_core/market_data.py | script | 9.5 KB |
| scripts/simtrade_core/models.py | script | 5.1 KB |
| scripts/simtrade_core/rules.py | script | 3.5 KB |
| scripts/simtrade_core/service.py | script | 39.4 KB |
| scripts/simtrade_core/trading_calendar.py | script | 4.1 KB |
| tests/test_live_data.py | script | 667 B |
| tests/test_simtrade.py | script | 10.4 KB |
tests/test_simtrade.py
View on GitHubfrom __future__ import annotations
import sqlite3
import sys
import tempfile
import unittest
from concurrent.futures import ThreadPoolExecutor
from datetime import date, datetime
from pathlib import Path
from zoneinfo import ZoneInfo
SCRIPT_DIR = Path(__file__).resolve().parents[1] / "scripts"
sys.path.insert(0, str(SCRIPT_DIR))
from simtrade_core.database import Database
from simtrade_core.models import BookLevel, DataUnavailable, QuoteSnapshot, ValidationError
from simtrade_core.service import TradingService
from simtrade_core.trading_calendar import StaticCalendar
TZ = ZoneInfo("Asia/Shanghai")
FRIDAY = date(2026, 8, 14)
MONDAY = date(2026, 8, 17)
TUESDAY = date(2026, 8, 18)
MORNING = datetime(2026, 8, 14, 10, 0, 0, tzinfo=TZ)
def quote(
*,
at: datetime = MORNING,
bids: tuple[BookLevel, ...] = (BookLevel(999, 100),),
asks: tuple[BookLevel, ...] = (BookLevel(1000, 100),),
upper: int | None = 1100,
lower: int | None = 900,
) -> QuoteSnapshot:
return QuoteSnapshot(
code="600000",
name="浦发银行",
exchange="SH",
source="fixture",
quote_at=at,
fetched_at=at,
last_cents=1000,
pre_close_cents=1000,
upper_limit_cents=upper,
lower_limit_cents=lower,
listing_date=date(1999, 11, 10),
status="TRADING",
bids=bids,
asks=asks,
raw={"fixture": True},
)
class FakeQuotes:
def __init__(self, snapshots: list[QuoteSnapshot] | None = None):
self.snapshots = snapshots or [quote()]
self.index = 0
def get_quote(self, code: str) -> QuoteSnapshot:
item = self.snapshots[min(self.index, len(self.snapshots) - 1)]
self.index += 1
return item
class FailingQuotes:
def get_quote(self, code: str) -> QuoteSnapshot:
raise DataUnavailable("fixture provider unavailable")
class SimTradeTest(unittest.TestCase):
def setUp(self) -> None:
self.temp = tempfile.TemporaryDirectory()
self.db = Database(Path(self.temp.name) / "simulation.db")
self.calendar = StaticCalendar([FRIDAY, MONDAY, TUESDAY])
self.quotes = FakeQuotes()
self.service = TradingService(self.db, self.quotes, self.calendar)
self.account = self.service.create_account("测试账户", "100000", now=MORNING)
def tearDown(self) -> None:
self.temp.cleanup()
def test_account_ledger_starts_reconciled(self) -> None:
audit = self.service.audit(account_id=self.account["id"])
self.assertTrue(audit["passed"], audit)
self.assertEqual("100000.00", self.account["total_cash"])
def test_buy_partial_fill_freezes_remainder_and_sets_next_trade_day(self) -> None:
self.quotes.snapshots = [quote(asks=(BookLevel(1000, 100),))]
order = self.service.place_order("BUY", "600000", 200, "10.00", account_id=self.account["id"], now=MORNING)
self.assertEqual("PARTIALLY_FILLED", order["status"])
self.assertEqual(100, order["filled_quantity"])
self.assertEqual("1000.01", order["frozen_cash"])
portfolio = self.service.portfolio(account_id=self.account["id"], now=MORNING)
self.assertEqual(100, portfolio["positions"][0]["shares"])
self.assertEqual(0, portfolio["positions"][0]["available_shares"])
with self.db.connect() as connection:
lot = connection.execute("SELECT * FROM position_lots").fetchone()
self.assertEqual(MONDAY.isoformat(), lot["available_on"])
self.assertTrue(self.service.audit(account_id=self.account["id"])["passed"])
def test_non_marketable_order_stays_open_and_cancel_releases_cash(self) -> None:
self.quotes.snapshots = [quote(asks=(BookLevel(1050, 100),))]
before = self.service.get_account(self.account["id"])
order = self.service.place_order("BUY", "600000", 100, "10.00", account_id=self.account["id"], now=MORNING)
self.assertEqual("OPEN", order["status"])
frozen = self.service.get_account(self.account["id"])
self.assertNotEqual("0.00", frozen["frozen_cash"])
cancelled = self.service.cancel_order(order["id"], now=MORNING)
self.assertEqual("CANCELLED", cancelled["status"])
after = self.service.get_account(self.account["id"])
self.assertEqual(before["total_cash"], after["total_cash"])
self.assertEqual(before["available_cash"], after["available_cash"])
def test_stale_or_incomplete_quote_causes_no_order_or_cash_change(self) -> None:
stale = quote(at=datetime(2026, 8, 14, 9, 58, tzinfo=TZ))
self.quotes.snapshots = [stale]
with self.assertRaises(DataUnavailable):
self.service.place_order("BUY", "600000", 100, "10.00", account_id=self.account["id"], now=MORNING)
self.assertEqual([], self.service.list_orders(account_id=self.account["id"]))
self.quotes.snapshots = [quote(upper=None)]
self.quotes.index = 0
with self.assertRaises(DataUnavailable):
self.service.place_order("BUY", "600000", 100, "10.00", account_id=self.account["id"], now=MORNING)
self.assertEqual([], self.service.list_orders(account_id=self.account["id"]))
def test_quote_without_book_is_valid_for_schema_but_not_matching(self) -> None:
no_book = quote(bids=(), asks=())
self.assertEqual([], no_book.schema_issues())
self.quotes.snapshots = [no_book]
with self.assertRaises(DataUnavailable):
self.service.place_order("BUY", "600000", 100, "10.00", account_id=self.account["id"], now=MORNING)
self.assertEqual([], self.service.list_orders(account_id=self.account["id"]))
def test_price_tick_and_buy_lot_are_rejected_without_state_change(self) -> None:
with self.assertRaises(ValidationError):
self.service.place_order("BUY", "600000", 100, "10.005", account_id=self.account["id"], now=MORNING)
rejected = self.service.place_order("BUY", "600000", 101, "10.00", account_id=self.account["id"], now=MORNING)
self.assertEqual("REJECTED", rejected["status"])
self.assertEqual("100000.00", self.service.get_account(self.account["id"])["total_cash"])
def test_t_plus_one_and_sell_fees_realized_pnl(self) -> None:
self.quotes.snapshots = [quote(asks=(BookLevel(1000, 100),))]
buy = self.service.place_order("BUY", "600000", 100, "10.00", account_id=self.account["id"], now=MORNING)
self.assertEqual("FILLED", buy["status"])
same_day = self.service.place_order("SELL", "600000", 100, "10.00", account_id=self.account["id"], now=MORNING)
self.assertEqual("REJECTED", same_day["status"])
monday_time = datetime(2026, 8, 17, 10, 0, tzinfo=TZ)
self.quotes.snapshots = [quote(at=monday_time, bids=(BookLevel(1020, 100),), asks=())]
self.quotes.index = 0
sell = self.service.place_order("SELL", "600000", 100, "10.10", account_id=self.account["id"], now=monday_time)
self.assertEqual("FILLED", sell["status"])
fill = sell["fills"][0]
self.assertEqual("5.00", fill["commission"])
self.assertEqual("0.01", fill["transfer_fee"])
self.assertEqual("0.51", fill["stamp_tax"])
self.assertTrue(self.service.audit(account_id=self.account["id"])["passed"])
def test_partial_order_reprocesses_with_new_snapshot(self) -> None:
self.quotes.snapshots = [
quote(asks=(BookLevel(1000, 100),)),
quote(asks=(BookLevel(1000, 100),)),
]
order = self.service.place_order("BUY", "600000", 200, "10.00", account_id=self.account["id"], now=MORNING)
self.assertEqual("PARTIALLY_FILLED", order["status"])
processed = self.service.process_orders(order_id=order["id"], now=MORNING)
self.assertEqual("FILLED", processed[0]["status"])
self.assertEqual(2, len(processed[0]["fills"]))
from decimal import Decimal
self.assertEqual(Decimal("5.00"), sum((Decimal(fill["commission"]) for fill in processed[0]["fills"]), Decimal("0")))
def test_transaction_rolls_back_when_next_trade_day_is_missing(self) -> None:
broken = TradingService(self.db, FakeQuotes([quote()]), StaticCalendar([FRIDAY]))
with self.assertRaises(DataUnavailable):
broken.place_order("BUY", "600000", 100, "10.00", account_id=self.account["id"], now=MORNING)
self.assertEqual([], self.service.list_orders(account_id=self.account["id"]))
self.assertEqual("100000.00", self.service.get_account(self.account["id"])["total_cash"])
def test_expiration_releases_frozen_cash(self) -> None:
self.quotes.snapshots = [quote(asks=(BookLevel(1050, 100),))]
order = self.service.place_order("BUY", "600000", 100, "10.00", account_id=self.account["id"], now=MORNING)
self.assertEqual("OPEN", order["status"])
after_close = datetime(2026, 8, 14, 15, 1, tzinfo=TZ)
result = self.service.process_orders(order_id=order["id"], now=after_close)
self.assertEqual("EXPIRED", result[0]["status"])
account = self.service.get_account(self.account["id"])
self.assertEqual("0.00", account["frozen_cash"])
self.assertEqual("100000.00", account["available_cash"])
def test_failed_valuation_never_falls_back_to_cost(self) -> None:
self.service.place_order("BUY", "600000", 100, "10.00", account_id=self.account["id"], now=MORNING)
failing = TradingService(self.db, FailingQuotes(), self.calendar)
portfolio = failing.portfolio(account_id=self.account["id"], now=MORNING)
self.assertEqual("INCOMPLETE", portfolio["valuation_status"])
self.assertIsNone(portfolio["market_value"])
self.assertIsNone(portfolio["total_assets"])
self.assertIsNone(portfolio["positions"][0]["market_value"])
def test_concurrent_orders_cannot_overspend(self) -> None:
service = TradingService(self.db, FakeQuotes([quote(asks=(BookLevel(1100, 100),))]), self.calendar)
def submit() -> str:
return service.place_order("BUY", "600000", 5000, "10.00", account_id=self.account["id"], now=MORNING)["status"]
with ThreadPoolExecutor(max_workers=2) as pool:
statuses = list(pool.map(lambda _: submit(), range(2)))
self.assertEqual(1, statuses.count("OPEN"))
self.assertEqual(1, statuses.count("REJECTED"))
account = self.service.get_account(self.account["id"])
self.assertGreaterEqual(float(account["available_cash"]), 0)
self.assertTrue(self.service.audit(account_id=self.account["id"])["passed"])
if __name__ == "__main__":
unittest.main()
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| deprecation-and-migrationaddyosmani/agent-skillsManages deprecation and migration. Use when removing old systems, APIs, or features. Use when migrating users from one implementation to another. Use when migrating a database schema in production, such as renaming or dropping a column without downtime (expand/contract). Use when deciding whether to maintain or sunset existing code. | Stars: 119k | Updated | Claude CodeCodex | Verified | Install |
| performance-optimizationaddyosmani/agent-skillsOptimizes application performance across frontend, backend, queries, and databases. Use when performance requirements exist, when you suspect performance regressions, when Core Web Vitals or load times need improvement, when N+1 query patterns need fixing, or when profiling reveals bottlenecks. | Stars: 119k | Updated | Claude CodeCodex | Verified | Install |
| agent-cost-reportthedotmack/claude-memBelievable agent cost report for any period, default the last 7 full days PT, not counting today. Measured tokens from Claude Code transcripts priced at OpenRouter list prices (ESTIMATED), measured provider spend when a sanctioned source exists, note-taker cost separate, Timing-style HTML/PDF plus report.json, line-items.csv, evidence.json. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |
| agent-cost-reportthedotmack/claude-memBelievable agent cost report for any period, default the last 7 full days PT, not counting today. Measured tokens from Claude Code transcripts priced at OpenRouter list prices (ESTIMATED), measured provider spend when a sanctioned source exists, note-taker cost separate, Timing-style HTML/PDF plus report.json, line-items.csv, evidence.json. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |