tradingSystem/app/core/etf_query_view.py

131 lines
6.8 KiB
Python
Raw Normal View History

"""宽基查询契约和展示投影。只接受整体15分钟事实,不生成交易信号。"""
from datetime import date, datetime, timedelta
import math
import re
from app.core.etf_intraday_view import SLOTS, TZ
CONTRACT = 'etf-intraday-query-1.0'
VIEW = 'latest_facts'
def timestamp(value):
at = datetime.fromisoformat(value)
if at.tzinfo is None:
raise ValueError('时间缺少时区')
return at.astimezone(TZ)
def number(value):
return type(value) in (int, float) and math.isfinite(value)
def latest_day(catalog, at):
if (catalog.get('contract_version') != CONTRACT
or 15 not in catalog.get('intervals_minutes', [])
or VIEW not in catalog.get('views', [])
or catalog.get('timezone') != 'Asia/Shanghai'):
raise ValueError('查询目录契约不匹配')
days = [date.fromisoformat(r['trade_date']) for r in catalog.get('dates', [])]
# 最新日标为不可用也请求该日,不能悄悄退回旧日并宣称更新正常。
days = [d for d in days if d <= at.astimezone(TZ).date()]
if not days:
raise ValueError('尚无可查询日期')
return max(days).isoformat()
def validate(document, day, at):
expected = {'contract_version': CONTRACT, 'trade_date': day, 'view': VIEW,
'interval_minutes': 15, 'timezone': 'Asia/Shanghai', 'amount_unit': 'CNY',
'purpose': 'MARKET_OBSERVATION',
'flow_basis': 'PRICE_VOLUME_PROXY_NOT_NET_SUBSCRIPTION',
'proxy_method': 'minute-price-change-signed-turnover-v1',
'intraday_net_subscription_status': 'UNAVAILABLE_DAILY_ONLY'}
if any(document.get(k) != v for k, v in expected.items()):
raise ValueError('查询口径不匹配')
if (document.get('trade_instruction') is not False
or document.get('live_signal_eligibility') is not False
or document.get('historical_use_allowed') is not True
or document.get('intraday_net_subscription_yuan') is not None):
raise ValueError('查询用途不匹配')
for k in ('data_version', 'cohort_sha256'):
if not re.fullmatch('[0-9a-f]{64}', str(document.get(k, ''))):
raise ValueError('查询版本缺失')
revision = document.get('projection_revision')
if type(revision) is not int or revision < 0 or timestamp(document['projected_at']) > at + timedelta(seconds=60):
raise ValueError('查询修订时间无效')
groups = document.get('groups', [])
if len(groups) != 1 or groups[0].get('subject_type') != 'MARKET' or groups[0].get('subject_id') != 'BROAD_ETF':
raise ValueError('查询必须为宽基整体')
members = groups[0].get('members', [])
if (not members or len(set(members)) != len(members)
or any(not re.fullmatch(r'\d{6}\.(SH|SZ)', str(code)) for code in members)):
raise ValueError('查询成分必须为沪深证券')
rows = document.get('rows')
if not isinstance(rows, list) or len(rows) > 16:
raise ValueError('查询窗口数量无效')
seen = set()
for row in rows:
end, start = timestamp(row['window_end']), timestamp(row['window_start'])
if (row.get('subject_type') != 'MARKET' or row.get('subject_id') != 'BROAD_ETF'
or row.get('interval_minutes') != 15 or end.date().isoformat() != day
or row.get('member_count') != len(members)
or end.strftime('%H:%M') not in SLOTS or end.second or end.microsecond
or end - start != timedelta(minutes=15) or end in seen):
raise ValueError('查询窗口不匹配')
seen.add(end)
for member in row.get('top_turnover_members', []):
if not re.fullmatch(r'\d{6}\.(SH|SZ)', str(member.get('ts_code', ''))):
raise ValueError('查询证券超出沪深范围')
if end > at and any(row.get(k) is not None for k in ('turnover_yuan', 'direction_balance', 'cumulative_turnover_yuan')):
raise ValueError('查询包含未来事实')
return document
def complete(row, kind):
count = row.get('member_count')
return (type(count) is int and count > 0
and row.get(kind + '_member_count') == count
and number(row.get(kind + '_coverage')) and row[kind + '_coverage'] == 1)
def presentation(document, at):
"""直接采用上游加权结果。缺失不补零,累计取末窗,不再相加。"""
day = document['trade_date']
base = datetime.combine(date.fromisoformat(day), datetime.min.time(), TZ)
lookup = {timestamp(r['window_end']).strftime('%H:%M'): r for r in document['rows']}
result, latest = [], None
for hm in SLOTS:
end = base.replace(hour=int(hm[:2]), minute=int(hm[3:]))
row = lookup.get(hm, {}) if end <= at else {}
amount = row.get('turnover_yuan')
amount_ok = (row.get('amount_status') == 'COMPLETE' and complete(row, 'amount')
and number(amount) and amount >= 0)
value = row.get('direction_balance')
direction_ok = (row.get('direction_status') == 'OK' and complete(row, 'direction')
and number(value) and -1 <= value <= 1
and row.get('direction') in ('BUY', 'SELL', 'MIXED'))
item = {'start': (end - timedelta(minutes=15)).strftime('%H:%M'), 'end': hm,
'value': value if direction_ok else None,
'direction': row.get('direction') if direction_ok else None,
'amount': amount if amount_ok else None,
'state': 'ok' if direction_ok else 'pending' if end > at else 'missing'}
result.append(item)
# 未来空窗、尚无事实的占位窗不夺走最后实际时间;部分到达的窗必须暴露缺失。
if row and (row.get('source_windows') and any(w.get('sources') for w in row['source_windows'])
or amount is not None or value is not None):
latest = (row, end, amount_ok)
summary = {'trade_date': day, 'window_end': None, 'cumulative_amount': None}
if latest:
row, end, amount_ok = latest
cumulative = row.get('cumulative_turnover_yuan')
# latest_facts 的累计值仅在所有前窗金额齐备时有效;方向缺失不掩盖金额。
prior = [i for i in result if i['end'] <= end.strftime('%H:%M')]
cumulative_ok = amount_ok and all(i['amount'] is not None for i in prior)
summary.update(window_end=end.isoformat(), session_closed=end.strftime('%H:%M') == '15:00',
cumulative_amount=cumulative if cumulative_ok and number(cumulative) and cumulative >= 0 else None)
return {'summary': summary, 'intraday_series': result,
'data_version': document['data_version'], 'projected_at': document['projected_at'],
'projection_revision': document['projection_revision'], 'view': VIEW,
'trade_instruction': False, 'live_signal_eligibility': False}