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/market_data.py
View on GitHubfrom __future__ import annotations
from datetime import date, datetime
from typing import Any, Protocol
from zoneinfo import ZoneInfo
# Required project import order: install the transport patch before importing AKShare.
import akshare_patch # noqa: F401
import akshare as ak
import requests
from .models import BookLevel, DataUnavailable, QuoteSnapshot, money_to_cents
from .rules import exchange_for_code, normalize_code
TZ = ZoneInfo("Asia/Shanghai")
class QuoteProvider(Protocol):
def get_quote(self, code: str) -> QuoteSnapshot: ...
def _number(value: Any) -> float | None:
if value in (None, "", "-"):
return None
try:
number = float(value)
except (TypeError, ValueError):
return None
return number if number > 0 else None
def _price_cents(value: Any) -> int | None:
number = _number(value)
return money_to_cents(number) if number is not None else None
def _listing_date(value: Any) -> date | None:
if value in (None, "", "-"):
return None
text = str(value).split(".")[0]
try:
return datetime.strptime(text, "%Y%m%d").date()
except ValueError:
return None
def _quote_time(value: Any) -> datetime | None:
try:
stamp = int(float(value))
except (TypeError, ValueError):
return None
if stamp <= 0:
return None
return datetime.fromtimestamp(stamp, TZ)
def _book(data: dict[str, Any], pairs: tuple[tuple[str, str], ...]) -> tuple[BookLevel, ...]:
levels: list[BookLevel] = []
for price_field, volume_field in pairs:
price = _price_cents(data.get(price_field))
volume_lots = _number(data.get(volume_field))
quantity = int(volume_lots * 100) if volume_lots is not None else 0
if price and quantity > 0:
levels.append(BookLevel(price, quantity))
return tuple(levels)
def _sina_quote(code: str, exchange: str) -> dict[str, Any]:
symbol = f"{exchange.lower()}{code}"
try:
response = requests.get(
f"http://hq.sinajs.cn/list={symbol}",
headers={"Referer": "http://finance.sina.com.cn"},
timeout=5,
)
response.encoding = "gbk"
text = response.text
except Exception as exc:
raise DataUnavailable(f"Failed to fetch Sina order book for {code}: {exc}") from exc
if not text.strip().startswith(f"var hq_str_{symbol}="):
raise DataUnavailable(f"Sina returned the wrong security for {code}")
start, end = text.find('"'), text.rfind('"')
if start < 0 or end <= start:
raise DataUnavailable(f"Invalid Sina order book response for {code}")
parts = text[start + 1:end].split(",")
if len(parts) < 32 or not parts[0].strip():
raise DataUnavailable(f"Incomplete Sina order book response for {code}")
try:
quote_at = datetime.strptime(f"{parts[30]} {parts[31]}", "%Y-%m-%d %H:%M:%S").replace(tzinfo=TZ)
except ValueError as exc:
raise DataUnavailable(f"Invalid Sina quote timestamp for {code}") from exc
def levels(pairs: tuple[tuple[int, int], ...]) -> tuple[BookLevel, ...]:
result: list[BookLevel] = []
for quantity_index, price_index in pairs:
price = _price_cents(parts[price_index])
quantity = int(_number(parts[quantity_index]) or 0)
if price and quantity > 0:
result.append(BookLevel(price, quantity))
return tuple(result)
return {
"name": parts[0].strip(),
"last_cents": _price_cents(parts[3]) or 0,
"pre_close_cents": _price_cents(parts[2]) or 0,
"quote_at": quote_at,
"bids": levels(((10, 11), (12, 13), (14, 15), (16, 17), (18, 19))),
"asks": levels(((20, 21), (22, 23), (24, 25), (26, 27), (28, 29))),
"raw": parts,
}
class EastMoneyQuoteProvider:
"""Strict single-security five-level quote adapter."""
URL = "https://push2.eastmoney.com/api/qt/stock/get"
FIELDS = ",".join(
[
"f11", "f12", "f13", "f14", "f15", "f16", "f17", "f18", "f19", "f20",
"f31", "f32", "f33", "f34", "f35", "f36", "f37", "f38", "f39", "f40",
"f43", "f51", "f52", "f57", "f58", "f60", "f86", "f107", "f189", "f292",
]
)
def get_quote(self, code: str) -> QuoteSnapshot:
clean = normalize_code(code)
exchange = exchange_for_code(clean)
market = "1" if exchange == "SH" else "0"
try:
response = requests.get(
self.URL,
params={"fltt": "2", "invt": "2", "fields": self.FIELDS, "secid": f"{market}.{clean}"},
timeout=15,
)
payload = response.json()
except Exception as exc:
raise DataUnavailable(f"获取 {clean} 五档行情失败:{exc}") from exc
data = payload.get("data") if isinstance(payload, dict) else None
if not isinstance(data, dict):
raise DataUnavailable(f"{clean} 行情响应缺少 data", details={"provider_response": payload})
response_code = str(data.get("f57") or "").zfill(6)
if response_code != clean:
raise DataUnavailable(
f"Quote provider returned the wrong security for {clean}",
details={"requested_code": clean, "provider_code": response_code},
)
fetched_at = datetime.now(TZ)
quote_at = _quote_time(data.get("f86"))
if quote_at is None:
quote_at = fetched_at.replace(year=1970, month=1, day=1)
bids = _book(data, (("f19", "f20"), ("f17", "f18"), ("f15", "f16"), ("f13", "f14"), ("f11", "f12")))
asks = _book(data, (("f39", "f40"), ("f37", "f38"), ("f35", "f36"), ("f33", "f34"), ("f31", "f32")))
last = _price_cents(data.get("f43")) or 0
pre_close = _price_cents(data.get("f60")) or 0
provider_status = int(data["f292"]) if str(data.get("f292", "")).isdigit() else None
source = "EastMoney.push2/AKShare-transport"
raw: dict[str, Any] = {"eastmoney": data}
if provider_status == 2 and not (bids or asks):
sina = _sina_quote(clean, exchange)
eastmoney_name = str(data.get("f58") or "").strip()
time_difference = abs((sina["quote_at"] - quote_at).total_seconds())
price_tolerance = max(5, round(pre_close * 0.005))
consistency_issues: list[str] = []
if sina["name"] != eastmoney_name:
consistency_issues.append("security name mismatch")
if sina["pre_close_cents"] != pre_close:
consistency_issues.append("previous close mismatch")
if time_difference > 30:
consistency_issues.append("quote timestamps differ by more than 30 seconds")
if last <= 0 or abs(sina["last_cents"] - last) > price_tolerance:
consistency_issues.append("last prices differ beyond tolerance")
if consistency_issues:
raise DataUnavailable(
f"Quote providers are inconsistent for {clean}",
details={
"issues": consistency_issues,
"eastmoney_name": eastmoney_name,
"sina_name": sina["name"],
"eastmoney_last_cents": last,
"sina_last_cents": sina["last_cents"],
"eastmoney_pre_close_cents": pre_close,
"sina_pre_close_cents": sina["pre_close_cents"],
"timestamp_difference_seconds": time_difference,
},
)
quote_at = sina["quote_at"]
bids = sina["bids"]
asks = sina["asks"]
last = sina["last_cents"]
pre_close = sina["pre_close_cents"]
source = "EastMoney metadata + Sina order book"
raw["sina"] = sina["raw"]
if provider_status == 6:
status = "SUSPENDED"
elif provider_status != 2:
status = "UNKNOWN"
elif bids or asks:
status = "TRADING"
else:
status = "NO_BOOK"
raw["provider_status_code"] = provider_status
return QuoteSnapshot(
code=response_code,
name=str(data.get("f58") or "").strip(),
exchange=exchange,
source=source,
quote_at=quote_at,
fetched_at=fetched_at,
last_cents=last,
pre_close_cents=pre_close,
upper_limit_cents=_price_cents(data.get("f51")),
lower_limit_cents=_price_cents(data.get("f52")),
listing_date=_listing_date(data.get("f189")),
status=status,
bids=bids,
asks=asks,
raw=raw,
)
def fetch_trade_dates() -> list[date]:
try:
frame = ak.tool_trade_date_hist_sina()
except Exception as exc:
raise DataUnavailable(f"AKShare 交易日历获取失败:{exc}") from exc
if frame is None or frame.empty or "trade_date" not in frame.columns:
raise DataUnavailable("AKShare 交易日历为空或缺少 trade_date")
days: list[date] = []
for value in frame["trade_date"].tolist():
if isinstance(value, datetime):
days.append(value.date())
elif isinstance(value, date):
days.append(value)
else:
try:
days.append(datetime.fromisoformat(str(value)).date())
except ValueError as exc:
raise DataUnavailable(f"交易日历包含无效日期:{value}") from exc
if not days:
raise DataUnavailable("AKShare 交易日历没有有效日期")
return sorted(set(days))
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 |