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 |
scripts/simtrade_core/rules.py
View on GitHubfrom __future__ import annotations
import re
from datetime import datetime, time
from .models import QuoteSnapshot, ValidationError
_CODE = re.compile(r"^\d{6}$")
_SH_PREFIXES = ("600", "601", "603", "605", "688", "689")
_SZ_PREFIXES = ("000", "001", "002", "003", "300", "301")
_BJ_PREFIXES = ("4", "8", "920")
def normalize_code(value: str) -> str:
clean = str(value).strip().upper()
for prefix in ("SH", "SZ", "BJ"):
if clean.startswith(prefix):
clean = clean[2:]
if clean.endswith(f".{prefix}"):
clean = clean[:-3]
if not _CODE.fullmatch(clean):
raise ValidationError(f"证券代码必须是受支持的六位 A 股代码:{value}")
exchange_for_code(clean)
return clean
def exchange_for_code(code: str) -> str:
if code.startswith(_SH_PREFIXES):
return "SH"
if code.startswith(_SZ_PREFIXES):
return "SZ"
if code.startswith(_BJ_PREFIXES):
return "BJ"
raise ValidationError(f"不支持的证券代码范围:{code}")
def in_continuous_session(now: datetime) -> bool:
current = now.timetz().replace(tzinfo=None)
return time(9, 30) <= current <= time(11, 30) or time(13, 0) <= current <= time(15, 0)
def after_close(now: datetime) -> bool:
return now.timetz().replace(tzinfo=None) > time(15, 0)
def validate_limit_price(price_cents: int, quote: QuoteSnapshot) -> None:
if price_cents <= 0:
raise ValidationError("限价必须大于 0")
if quote.lower_limit_cents is None or quote.upper_limit_cents is None:
raise ValidationError("缺少提供方明确涨跌停价,禁止委托")
if not quote.lower_limit_cents <= price_cents <= quote.upper_limit_cents:
raise ValidationError(
"限价超出当日涨跌停范围",
details={
"lower_limit_cents": quote.lower_limit_cents,
"upper_limit_cents": quote.upper_limit_cents,
"price_cents": price_cents,
},
)
def validate_quantity(side: str, quantity: int, *, free_sellable: int | None = None) -> None:
if not isinstance(quantity, int) or quantity <= 0:
raise ValidationError("委托数量必须是正整数")
if side == "BUY" and quantity % 100 != 0:
raise ValidationError("买入数量必须是 100 股的整数倍")
if side == "SELL" and quantity % 100 != 0 and quantity != free_sellable:
raise ValidationError("零股卖出必须一次卖出当前全部可用零股")
def validate_quote_for_matching(quote: QuoteSnapshot, code: str, now: datetime, max_age_seconds: int = 30) -> None:
issues = quote.schema_issues()
if quote.code != code:
issues.append(f"行情代码 {quote.code} 与委托代码 {code} 不一致")
if quote.exchange != exchange_for_code(code):
issues.append("行情交易所与代码不一致")
if quote.status != "TRADING":
issues.append(f"证券状态不是 TRADING:{quote.status}")
if not quote.bids and not quote.asks:
issues.append("五档盘口两侧均为空")
if quote.quote_at.date() != now.date():
issues.append("行情日期不是当前委托日期")
age = (now - quote.quote_at).total_seconds()
if age > max_age_seconds:
issues.append(f"行情已过期 {age:.1f} 秒")
if age < -5:
issues.append(f"行情时间超前 {-age:.1f} 秒")
if issues:
from .models import DataUnavailable
raise DataUnavailable("行情数据不足,禁止撮合", details={"issues": issues})
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 |