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/models.py
View on GitHubfrom __future__ import annotations
from dataclasses import dataclass
from datetime import date, datetime
from decimal import Decimal, InvalidOperation, ROUND_HALF_UP
from typing import Any
SHANGHAI_TZ = "Asia/Shanghai"
CENT = Decimal("0.01")
class SimTradeError(Exception):
"""Base error with a stable machine-readable code."""
code = "SIM_TRADE_ERROR"
def __init__(self, message: str, *, details: dict[str, Any] | None = None):
super().__init__(message)
self.details = details or {}
class ValidationError(SimTradeError):
code = "VALIDATION_ERROR"
class DataUnavailable(SimTradeError):
code = "DATA_UNAVAILABLE"
class NotFoundError(SimTradeError):
code = "NOT_FOUND"
class ConflictError(SimTradeError):
code = "CONFLICT"
def decimal_value(value: Any, field: str) -> Decimal:
try:
result = Decimal(str(value))
except (InvalidOperation, ValueError, TypeError) as exc:
raise ValidationError(f"{field} 必须是有效数字") from exc
if not result.is_finite():
raise ValidationError(f"{field} 必须是有限数字")
return result
def money_to_cents(value: Any, field: str = "金额", *, positive: bool = False) -> int:
amount = decimal_value(value, field).quantize(CENT, rounding=ROUND_HALF_UP)
if positive and amount <= 0:
raise ValidationError(f"{field} 必须大于 0")
return int(amount * 100)
def price_to_cents(value: Any, field: str = "价格") -> int:
raw = decimal_value(value, field)
if raw <= 0:
raise ValidationError(f"{field} 必须大于 0")
rounded = raw.quantize(CENT, rounding=ROUND_HALF_UP)
if raw != rounded:
raise ValidationError(f"{field} 必须符合 ¥0.01 最小价格变动单位")
return int(rounded * 100)
def cents_to_yuan(cents: int) -> str:
return f"{(Decimal(cents) / 100).quantize(CENT):.2f}"
def rate_value(value: Any, field: str = "费率") -> Decimal:
rate = decimal_value(value, field)
if rate < 0 or rate >= 1:
raise ValidationError(f"{field} 必须在 0(含)到 1(不含)之间")
return rate
@dataclass(frozen=True)
class BookLevel:
price_cents: int
quantity: int
def as_dict(self) -> dict[str, Any]:
return {"price": cents_to_yuan(self.price_cents), "quantity": self.quantity}
@dataclass(frozen=True)
class QuoteSnapshot:
code: str
name: str
exchange: str
source: str
quote_at: datetime
fetched_at: datetime
last_cents: int
pre_close_cents: int
upper_limit_cents: int | None
lower_limit_cents: int | None
listing_date: date | None
status: str
bids: tuple[BookLevel, ...]
asks: tuple[BookLevel, ...]
raw: dict[str, Any]
def schema_issues(self) -> list[str]:
issues: list[str] = []
if not self.code or len(self.code) != 6 or not self.code.isdigit():
issues.append("证券代码无效")
if not self.name.strip():
issues.append("证券名称缺失")
if self.exchange not in {"SH", "SZ", "BJ"}:
issues.append("交易所无效")
if not self.source:
issues.append("行情来源缺失")
if self.quote_at.tzinfo is None:
issues.append("行情时间缺少时区")
if self.last_cents <= 0:
issues.append("最新价缺失或非正数")
if self.pre_close_cents <= 0:
issues.append("昨收缺失或非正数")
if not self.upper_limit_cents or not self.lower_limit_cents:
issues.append("提供方未给出明确涨跌停价")
elif self.lower_limit_cents >= self.upper_limit_cents:
issues.append("涨跌停价关系无效")
if self.listing_date is None:
issues.append("上市日期缺失")
for side, levels in (("买盘", self.bids), ("卖盘", self.asks)):
if len(levels) > 5:
issues.append(f"{side}超过五档")
if any(level.price_cents <= 0 or level.quantity <= 0 for level in levels):
issues.append(f"{side}包含无效价量")
return issues
def as_dict(self, *, include_raw: bool = False) -> dict[str, Any]:
result = {
"code": self.code,
"name": self.name,
"exchange": self.exchange,
"source": self.source,
"quote_at": self.quote_at.isoformat(),
"fetched_at": self.fetched_at.isoformat(),
"last": cents_to_yuan(self.last_cents),
"pre_close": cents_to_yuan(self.pre_close_cents),
"upper_limit": cents_to_yuan(self.upper_limit_cents) if self.upper_limit_cents else None,
"lower_limit": cents_to_yuan(self.lower_limit_cents) if self.lower_limit_cents else None,
"listing_date": self.listing_date.isoformat() if self.listing_date else None,
"status": self.status,
"bids": [level.as_dict() for level in self.bids],
"asks": [level.as_dict() for level in self.asks],
"schema_issues": self.schema_issues(),
}
if include_raw:
result["raw"] = self.raw
return result
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 |