Skip to content

Fize/mmtickerlab / sim-trade

sim-trade

Verified

A 股专用的确定性模拟交易系统。具备严格的数据真实性门禁、五档盘口真实撮合、T+1 规则、持仓盈亏计算及 SQLite 可审计流水账本。当用户需要进行模拟交易下单、模拟买入/卖出、查询模拟盘持仓、账户资产或重置模拟盘时触发(包含触发词:模拟买入, 模拟卖出, 模拟交易, 查持仓, 模拟盘, 交易账本, sim trade, paper trading)。

scripts/simtrade_core/market_data.py

View on GitHub
from __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))
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: 119kUpdated Claude CodeCodexVerifiedInstall
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: 119kUpdated Claude CodeCodexVerifiedInstall
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: 118kUpdated Claude CodeCodexVerifiedInstall
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: 118kUpdated Claude CodeCodexVerifiedInstall