Docker
1379 lines
41 KiB
JSON
1379 lines
41 KiB
JSON
{
|
||
"openapi": "3.0.3",
|
||
"info": {
|
||
"title": "QMT桥接服务接口",
|
||
"version": "2.0.0",
|
||
"description": "大 QMT 薄桥 HTTP 接口（主动维护版 OpenAPI 规范）。\n部署在 QMT 策略进程内，端口 8610。\n交易查询数据由策略线程（adjust）缓存刷新，HTTP 线程只读缓存；\n策略名过滤走 QMT 服务端（get_trade_detail_data 第 4 参数）。\n本文件为本地维护的接口规范，可推送至 Apifox 项目（见 tools/push_apifox.py）。\n"
|
||
},
|
||
"servers": [
|
||
{
|
||
"url": "http://127.0.0.1:8610",
|
||
"description": "QMT 桥接本地服务（远程访问请改为桥所在机器 IP）"
|
||
}
|
||
],
|
||
"paths": {
|
||
"/health": {
|
||
"get": {
|
||
"summary": "健康检查",
|
||
"description": "桥存活状态 + 账号信息 + 桥版本。",
|
||
"responses": {
|
||
"200": {
|
||
"description": "成功返回健康信息",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/HealthResponse"
|
||
},
|
||
"example": {
|
||
"status": "ok",
|
||
"connect_info": {
|
||
"mode": "big_qmt",
|
||
"http_port": 8610,
|
||
"ws_port": 8610,
|
||
"account": "8882874667"
|
||
},
|
||
"last_error": null,
|
||
"bridge_version": "2",
|
||
"hot_reload": true
|
||
}
|
||
}
|
||
}
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"/data/kline": {
|
||
"get": {
|
||
"summary": "K线查询",
|
||
"description": "查询历史/实时 K 线。查询前自动先下载基础周期（合成周期: 3m←1m,\n10m~4h←5m, 2d~1y←1d）。fields 不传返回完整 OHLCV。\n",
|
||
"parameters": [
|
||
{
|
||
"name": "code",
|
||
"in": "query",
|
||
"required": true,
|
||
"schema": {
|
||
"type": "string"
|
||
},
|
||
"description": "股票代码，600519.SH 或 600519"
|
||
},
|
||
{
|
||
"name": "period",
|
||
"in": "query",
|
||
"schema": {
|
||
"type": "string",
|
||
"default": "1d"
|
||
},
|
||
"description": "tick/1m/5m/15m/30m/60m/1h/1d/1w/1mon"
|
||
},
|
||
{
|
||
"name": "start",
|
||
"in": "query",
|
||
"schema": {
|
||
"type": "string"
|
||
},
|
||
"description": "起始 YYYYMMDD"
|
||
},
|
||
{
|
||
"name": "end",
|
||
"in": "query",
|
||
"schema": {
|
||
"type": "string"
|
||
},
|
||
"description": "结束 YYYYMMDD"
|
||
},
|
||
{
|
||
"name": "count",
|
||
"in": "query",
|
||
"schema": {
|
||
"type": "integer",
|
||
"default": -1
|
||
},
|
||
"description": "条数，-1=全部；与 start/end 互斥"
|
||
},
|
||
{
|
||
"name": "fields",
|
||
"in": "query",
|
||
"schema": {
|
||
"type": "string",
|
||
"default": "open,high,low,close,volume,amount"
|
||
},
|
||
"description": "逗号分隔字段。不传=完整 OHLCV。白名单:\nopen,high,low,close,volume,amount,settle,openInterest\n"
|
||
}
|
||
],
|
||
"responses": {
|
||
"200": {
|
||
"description": "K线记录",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/KlineResponse"
|
||
},
|
||
"example": {
|
||
"code": "600900.SH",
|
||
"period": "1d",
|
||
"count": 14,
|
||
"data": [
|
||
{
|
||
"time": "20260803",
|
||
"open": 28.99,
|
||
"high": 29.2,
|
||
"low": 28.75,
|
||
"close": 29.05,
|
||
"volume": 1018010.0,
|
||
"amount": 2949045835.0
|
||
}
|
||
]
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"400": {
|
||
"description": "缺少必填参数（code 未传）或 period 无效",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ErrorResponse"
|
||
},
|
||
"example": {
|
||
"detail": "code required"
|
||
}
|
||
}
|
||
}
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"/data/quote": {
|
||
"get": {
|
||
"summary": "实时行情快照",
|
||
"description": "完整快照：最新价、开高低收、昨收、量额、五档盘口。\n底层: ContextInfo.get_full_tick([code])，返回单只股票完整 tick 快照。\n",
|
||
"parameters": [
|
||
{
|
||
"name": "code",
|
||
"in": "query",
|
||
"required": true,
|
||
"schema": {
|
||
"type": "string"
|
||
},
|
||
"description": "股票代码，600519.SH 或 600519"
|
||
}
|
||
],
|
||
"responses": {
|
||
"200": {
|
||
"description": "完整行情快照（五档盘口）",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/QuoteResponse"
|
||
},
|
||
"example": {
|
||
"ok": true,
|
||
"code": "600519.SH",
|
||
"data": {
|
||
"time": 1787209204000,
|
||
"timetag": "20260820 15:00:04",
|
||
"lastPrice": 1291.5,
|
||
"open": 1299.8,
|
||
"high": 1306.88,
|
||
"low": 1291,
|
||
"lastClose": 1307.88,
|
||
"amount": 3280474200,
|
||
"volume": 25332,
|
||
"askPrice": [
|
||
1291.58,
|
||
1291.61
|
||
],
|
||
"bidPrice": [
|
||
1291.5,
|
||
1291.49
|
||
]
|
||
}
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"400": {
|
||
"description": "缺少必填参数（code 未传）",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ErrorResponse"
|
||
},
|
||
"example": {
|
||
"detail": "code required"
|
||
}
|
||
}
|
||
}
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"/data/instrument": {
|
||
"get": {
|
||
"summary": "合约详细信息（含涨跌停价）",
|
||
"description": "返回合约详情：UpStopPrice（涨停）/DownStopPrice（跌停）、\nInstrumentName（名称）、OpenDate（上市日期）等。\n底层: ContextInfo.get_instrument_detail。\n",
|
||
"parameters": [
|
||
{
|
||
"name": "code",
|
||
"in": "query",
|
||
"required": true,
|
||
"schema": {
|
||
"type": "string"
|
||
},
|
||
"description": "股票代码，600519.SH 或 600519"
|
||
}
|
||
],
|
||
"responses": {
|
||
"200": {
|
||
"description": "合约详情",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/InstrumentResponse"
|
||
},
|
||
"example": {
|
||
"ok": true,
|
||
"code": "600519.SH",
|
||
"data": {
|
||
"ExchangeID": "SH",
|
||
"InstrumentID": "600519",
|
||
"InstrumentName": "贵州茅台",
|
||
"OpenDate": 20010827,
|
||
"PreClose": 1307.88,
|
||
"UpStopPrice": 1438.67,
|
||
"DownStopPrice": 1177.09,
|
||
"PriceTick": 0.01
|
||
}
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"400": {
|
||
"description": "缺少必填参数（code 未传）",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ErrorResponse"
|
||
},
|
||
"example": {
|
||
"detail": "code required"
|
||
}
|
||
}
|
||
}
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"/data/calendar/trading_dates": {
|
||
"get": {
|
||
"summary": "交易日历",
|
||
"description": "返回 [start, end] 区间内的交易日列表（YYYYMMDD 字符串）。\n底层: ContextInfo.get_trading_dates。可用于市场活跃判断。\n",
|
||
"parameters": [
|
||
{
|
||
"name": "start",
|
||
"in": "query",
|
||
"schema": {
|
||
"type": "string"
|
||
},
|
||
"description": "起始 YYYYMMDD"
|
||
},
|
||
{
|
||
"name": "end",
|
||
"in": "query",
|
||
"schema": {
|
||
"type": "string"
|
||
},
|
||
"description": "结束 YYYYMMDD"
|
||
}
|
||
],
|
||
"responses": {
|
||
"200": {
|
||
"description": "交易日列表",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/TradingDatesResponse"
|
||
},
|
||
"example": {
|
||
"market": "SH",
|
||
"count": 3,
|
||
"dates": [
|
||
"20260818",
|
||
"20260819",
|
||
"20260820"
|
||
]
|
||
}
|
||
}
|
||
}
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"/data/subscribe": {
|
||
"post": {
|
||
"summary": "订阅数据（全量tick）",
|
||
"description": "订阅数据推送类型。当前支持 whole（全量tick增量推送）。\n订阅成功后返回 sub_id，WS 连接 ws://host:8610/ws 接收推送。\n",
|
||
"requestBody": {
|
||
"required": true,
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/SubscribeRequest"
|
||
},
|
||
"example": {
|
||
"type": "whole",
|
||
"codes": [
|
||
"SH",
|
||
"SZ"
|
||
]
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"responses": {
|
||
"200": {
|
||
"description": "订阅成功",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/SubscribeResponse"
|
||
},
|
||
"example": {
|
||
"ok": true,
|
||
"sub_id": 7322465032736768
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"400": {
|
||
"description": "参数错误（unsupported type / codes required / invalid json）",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ErrorResponse"
|
||
},
|
||
"example": {
|
||
"detail": "codes required"
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"503": {
|
||
"description": "订阅失败（QMT subscribe_whole_quote 失败）",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ErrorResponse"
|
||
},
|
||
"example": {
|
||
"detail": "subscribe_whole_quote failed for codes=['SH', 'SZ']"
|
||
}
|
||
}
|
||
}
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"/data/unsubscribe": {
|
||
"post": {
|
||
"summary": "退订数据",
|
||
"description": "按 sub_id 退订某类型的订阅。",
|
||
"requestBody": {
|
||
"required": true,
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/UnsubscribeRequest"
|
||
},
|
||
"example": {
|
||
"sub_id": 7322465032736768
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"responses": {
|
||
"200": {
|
||
"description": "退订成功",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/UnsubscribeResponse"
|
||
},
|
||
"example": {
|
||
"ok": true
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"404": {
|
||
"description": "订阅ID不存在",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ErrorResponse"
|
||
},
|
||
"example": {
|
||
"detail": "sub_id not found"
|
||
}
|
||
}
|
||
}
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"/data/tick": {
|
||
"get": {
|
||
"summary": "获取全推tick快照",
|
||
"description": "透传 ContextInfo.get_full_tick(codes)，返回指定代码的最新分笔快照。\n客户端需要当前快照时主动调用（WS 只推增量，不做 prime 推送）。\n",
|
||
"parameters": [
|
||
{
|
||
"name": "codes",
|
||
"in": "query",
|
||
"required": true,
|
||
"schema": {
|
||
"type": "string"
|
||
},
|
||
"description": "逗号分隔代码列表，如 600000.SH,000001.SZ"
|
||
}
|
||
],
|
||
"responses": {
|
||
"200": {
|
||
"description": "快照数据",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/TickBatchResponse"
|
||
},
|
||
"example": {
|
||
"ok": true,
|
||
"data": {
|
||
"600000.SH": {
|
||
"timetag": "20231106 15:00:04",
|
||
"lastPrice": 2.533,
|
||
"volume": 5701929
|
||
}
|
||
}
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"400": {
|
||
"description": "codes 缺失",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ErrorResponse"
|
||
},
|
||
"example": {
|
||
"detail": "codes required"
|
||
}
|
||
}
|
||
}
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"/trade/positions": {
|
||
"get": {
|
||
"summary": "持仓查询",
|
||
"description": "当前账号全部持仓（语义化字段 + 原始 m_* 字段超集 + 汇总 summary）。\n账号为桥绑定账号（单账号策略），无需传 account 参数。\n不做过滤筛选：返回全部持仓，客户端按需自取。\n数据由策略线程（adjust）每 300ms 缓存刷新，HTTP 线程只读缓存。\n",
|
||
"parameters": [],
|
||
"responses": {
|
||
"200": {
|
||
"description": "全部持仓 + 汇总",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/PositionsResponse"
|
||
},
|
||
"example": {
|
||
"ok": true,
|
||
"data": {
|
||
"positions": [
|
||
{
|
||
"stock_code": "600519.SH",
|
||
"stock_name": "贵州茅台",
|
||
"volume": 100,
|
||
"available": 100,
|
||
"frozen_volume": 0,
|
||
"on_road_volume": 0,
|
||
"yesterday_volume": 0,
|
||
"avg_price": 1500.0,
|
||
"price": 1510.0,
|
||
"market_value": 151000.0,
|
||
"open_price": 1500.0,
|
||
"profit": 1000.0,
|
||
"profit_pct": 0.67,
|
||
"direction": 48,
|
||
"m_strInstrumentID": "600519",
|
||
"m_strInstrumentName": "贵州茅台",
|
||
"m_nVolume": 100,
|
||
"m_nCanUseVolume": 100,
|
||
"m_dOpenPrice": 1500.0,
|
||
"m_dFloatProfit": 1000.0
|
||
}
|
||
],
|
||
"summary": {
|
||
"count": 1,
|
||
"total_market_value": 151000.0,
|
||
"total_profit": 1000.0
|
||
}
|
||
}
|
||
}
|
||
}
|
||
}
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"/trade/asset": {
|
||
"get": {
|
||
"summary": "资金资产查询",
|
||
"description": "资金账号资产信息（m_* 原始字段）。\n账号为桥绑定账号（单账号策略），无需传 account 参数。\n数据由策略线程（adjust）每 300ms 缓存刷新，HTTP 线程只读缓存。\n",
|
||
"parameters": [],
|
||
"responses": {
|
||
"200": {
|
||
"description": "资产信息",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/AssetResponse"
|
||
},
|
||
"example": {
|
||
"ok": true,
|
||
"data": [
|
||
{
|
||
"m_strAccountID": "8882874667",
|
||
"m_dBalance": 126244.05,
|
||
"m_dAvailable": 31669.54,
|
||
"m_dAssetBalance": 126244.05,
|
||
"m_dFrozenCash": 3400.714
|
||
}
|
||
]
|
||
}
|
||
}
|
||
}
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"/trade/orders": {
|
||
"get": {
|
||
"summary": "当日委托查询（支持过滤）",
|
||
"description": "当日委托列表（m_* 原始字段）。账号为桥绑定账号（单账号策略），\n无需传 account 参数。支持三类过滤：\n- code: 客户端按代码过滤（600519 或 600519.SH）\n- status: active（排除已撤54/废单57）或具体状态码\n- strategy_name: QMT 服务端按 passorder 策略名过滤\n（remark 过滤暂未实现）\n数据由策略线程（adjust）每 300ms 缓存刷新，HTTP 线程只读缓存。\n",
|
||
"parameters": [
|
||
{
|
||
"name": "code",
|
||
"in": "query",
|
||
"schema": {
|
||
"type": "string"
|
||
},
|
||
"description": "股票代码过滤（600519 或 600519.SH）"
|
||
},
|
||
{
|
||
"name": "status",
|
||
"in": "query",
|
||
"schema": {
|
||
"type": "string"
|
||
},
|
||
"description": "active=排除已撤(54)/废单(57)；或数字状态码如 50/48/56"
|
||
},
|
||
{
|
||
"name": "strategy_name",
|
||
"in": "query",
|
||
"schema": {
|
||
"type": "string"
|
||
},
|
||
"description": "QMT 服务端按策略名过滤（passorder 时传入的名字）"
|
||
}
|
||
],
|
||
"responses": {
|
||
"200": {
|
||
"description": "委托列表",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/OrdersResponse"
|
||
},
|
||
"example": {
|
||
"ok": true,
|
||
"data": [
|
||
{
|
||
"m_strOrderSysID": "645000387",
|
||
"m_strAccountID": "8882874667",
|
||
"m_strExchangeID": "SH",
|
||
"m_strInstrumentID": "601117",
|
||
"m_strInstrumentName": "中国化学",
|
||
"m_nDirection": 48,
|
||
"m_nOrderStatus": 50,
|
||
"m_nVolumeTotalOriginal": 200,
|
||
"m_nVolumeTraded": 0,
|
||
"m_nVolumeTotal": 200,
|
||
"m_dLimitPrice": 7.0,
|
||
"m_strInsertTime": "09:30:01",
|
||
"m_dTradedPrice": 0.0
|
||
}
|
||
]
|
||
}
|
||
}
|
||
}
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"/trade/trades": {
|
||
"get": {
|
||
"summary": "当日成交查询",
|
||
"description": "当日成交列表（m_* 原始字段）。\n账号为桥绑定账号（单账号策略），无需传 account 参数。\n数据由策略线程（adjust）每 300ms 缓存刷新，HTTP 线程只读缓存。\n",
|
||
"parameters": [],
|
||
"responses": {
|
||
"200": {
|
||
"description": "成交列表",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/TradesResponse"
|
||
},
|
||
"example": {
|
||
"ok": true,
|
||
"data": [
|
||
{
|
||
"m_strTradeID": "14212286",
|
||
"m_strOrderSysID": "645006675",
|
||
"m_strAccountID": "8882874667",
|
||
"m_strExchangeID": "SH",
|
||
"m_strInstrumentID": "600719",
|
||
"m_strInstrumentName": "大连热电",
|
||
"m_nDirection": 48,
|
||
"m_dPrice": 7.03,
|
||
"m_nVolume": 400,
|
||
"m_strTradeDate": "20260826",
|
||
"m_strTradeTime": "094648",
|
||
"m_dCommission": 2.0,
|
||
"m_dTradeAmount": 2812.0
|
||
}
|
||
]
|
||
}
|
||
}
|
||
}
|
||
}
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"components": {
|
||
"schemas": {
|
||
"ErrorResponse": {
|
||
"type": "object",
|
||
"properties": {
|
||
"detail": {
|
||
"type": "string",
|
||
"description": "错误信息"
|
||
}
|
||
},
|
||
"required": [
|
||
"detail"
|
||
]
|
||
},
|
||
"SubscribeRequest": {
|
||
"type": "object",
|
||
"properties": {
|
||
"type": {
|
||
"type": "string",
|
||
"description": "订阅类型，当前支持 whole"
|
||
},
|
||
"codes": {
|
||
"type": "array",
|
||
"items": {
|
||
"type": "string"
|
||
},
|
||
"description": "代码列表，如 ['SH','SZ']"
|
||
}
|
||
}
|
||
},
|
||
"UnsubscribeRequest": {
|
||
"type": "object",
|
||
"properties": {
|
||
"sub_id": {
|
||
"type": "integer",
|
||
"description": "订阅ID（订阅接口返回）"
|
||
}
|
||
}
|
||
},
|
||
"HealthResponse": {
|
||
"type": "object",
|
||
"properties": {
|
||
"status": {
|
||
"type": "string",
|
||
"description": "服务状态（ok=正常）"
|
||
},
|
||
"connect_info": {
|
||
"type": "object",
|
||
"description": "连接信息",
|
||
"properties": {
|
||
"mode": {
|
||
"type": "string",
|
||
"description": "运行模式（big_qmt=大 QMT）"
|
||
},
|
||
"http_port": {
|
||
"type": "integer",
|
||
"description": "HTTP 端口"
|
||
},
|
||
"ws_port": {
|
||
"type": "integer",
|
||
"description": "WebSocket 端口"
|
||
},
|
||
"account": {
|
||
"type": "string",
|
||
"description": "桥绑定资金账号"
|
||
}
|
||
}
|
||
},
|
||
"last_error": {
|
||
"type": "string",
|
||
"nullable": true,
|
||
"description": "最近一次错误（无则为 null）"
|
||
},
|
||
"bridge_version": {
|
||
"type": "string",
|
||
"description": "桥版本"
|
||
},
|
||
"hot_reload": {
|
||
"type": "boolean",
|
||
"description": "是否支持热重载"
|
||
}
|
||
}
|
||
},
|
||
"KlineResponse": {
|
||
"type": "object",
|
||
"properties": {
|
||
"code": {
|
||
"type": "string",
|
||
"description": "完整证券代码"
|
||
},
|
||
"period": {
|
||
"type": "string",
|
||
"description": "K线周期"
|
||
},
|
||
"count": {
|
||
"type": "integer",
|
||
"description": "返回条数"
|
||
},
|
||
"data": {
|
||
"type": "array",
|
||
"description": "K线记录列表",
|
||
"items": {
|
||
"$ref": "#/components/schemas/KlineBar"
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"QuoteResponse": {
|
||
"type": "object",
|
||
"properties": {
|
||
"ok": {
|
||
"type": "boolean",
|
||
"description": "是否成功"
|
||
},
|
||
"code": {
|
||
"type": "string",
|
||
"description": "完整证券代码"
|
||
},
|
||
"data": {
|
||
"$ref": "#/components/schemas/TickSnapshot"
|
||
}
|
||
}
|
||
},
|
||
"InstrumentResponse": {
|
||
"type": "object",
|
||
"properties": {
|
||
"ok": {
|
||
"type": "boolean",
|
||
"description": "是否成功"
|
||
},
|
||
"code": {
|
||
"type": "string",
|
||
"description": "完整证券代码"
|
||
},
|
||
"data": {
|
||
"$ref": "#/components/schemas/InstrumentDetail"
|
||
}
|
||
}
|
||
},
|
||
"TradingDatesResponse": {
|
||
"type": "object",
|
||
"properties": {
|
||
"market": {
|
||
"type": "string",
|
||
"description": "市场（SH）"
|
||
},
|
||
"count": {
|
||
"type": "integer",
|
||
"description": "交易日数量"
|
||
},
|
||
"dates": {
|
||
"type": "array",
|
||
"description": "交易日列表（YYYYMMDD 字符串）",
|
||
"items": {
|
||
"type": "string"
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"SubscribeResponse": {
|
||
"type": "object",
|
||
"properties": {
|
||
"ok": {
|
||
"type": "boolean",
|
||
"description": "是否成功"
|
||
},
|
||
"sub_id": {
|
||
"type": "integer",
|
||
"description": "订阅ID（退订时使用，snowflake 类唯一 ID）"
|
||
}
|
||
}
|
||
},
|
||
"UnsubscribeResponse": {
|
||
"type": "object",
|
||
"properties": {
|
||
"ok": {
|
||
"type": "boolean",
|
||
"description": "是否成功"
|
||
}
|
||
}
|
||
},
|
||
"TickBatchResponse": {
|
||
"type": "object",
|
||
"properties": {
|
||
"ok": {
|
||
"type": "boolean",
|
||
"description": "是否成功"
|
||
},
|
||
"data": {
|
||
"type": "object",
|
||
"description": "代码 → tick 快照字典",
|
||
"additionalProperties": {
|
||
"$ref": "#/components/schemas/TickSnapshot"
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"PositionsResponse": {
|
||
"type": "object",
|
||
"properties": {
|
||
"ok": {
|
||
"type": "boolean",
|
||
"description": "是否成功"
|
||
},
|
||
"data": {
|
||
"type": "object",
|
||
"description": "持仓数据",
|
||
"properties": {
|
||
"positions": {
|
||
"type": "array",
|
||
"description": "持仓列表（每行 = 语义化字段 + 原始 m_* 字段）",
|
||
"items": {
|
||
"$ref": "#/components/schemas/Position"
|
||
}
|
||
},
|
||
"summary": {
|
||
"$ref": "#/components/schemas/PositionSummary"
|
||
}
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"AssetResponse": {
|
||
"type": "object",
|
||
"properties": {
|
||
"ok": {
|
||
"type": "boolean",
|
||
"description": "是否成功"
|
||
},
|
||
"data": {
|
||
"type": "array",
|
||
"description": "资产行（通常 1 行）",
|
||
"items": {
|
||
"$ref": "#/components/schemas/Asset"
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"OrdersResponse": {
|
||
"type": "object",
|
||
"properties": {
|
||
"ok": {
|
||
"type": "boolean",
|
||
"description": "是否成功"
|
||
},
|
||
"data": {
|
||
"type": "array",
|
||
"description": "委托列表",
|
||
"items": {
|
||
"$ref": "#/components/schemas/Order"
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"TradesResponse": {
|
||
"type": "object",
|
||
"properties": {
|
||
"ok": {
|
||
"type": "boolean",
|
||
"description": "是否成功"
|
||
},
|
||
"data": {
|
||
"type": "array",
|
||
"description": "成交列表",
|
||
"items": {
|
||
"$ref": "#/components/schemas/Trade"
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"KlineBar": {
|
||
"type": "object",
|
||
"properties": {
|
||
"time": {
|
||
"type": "string",
|
||
"description": "时间（日线为 YYYYMMDD，分钟线为时间戳/时间串）"
|
||
},
|
||
"open": {
|
||
"type": "number",
|
||
"description": "开盘价"
|
||
},
|
||
"high": {
|
||
"type": "number",
|
||
"description": "最高价"
|
||
},
|
||
"low": {
|
||
"type": "number",
|
||
"description": "最低价"
|
||
},
|
||
"close": {
|
||
"type": "number",
|
||
"description": "收盘价"
|
||
},
|
||
"volume": {
|
||
"type": "number",
|
||
"description": "成交量"
|
||
},
|
||
"amount": {
|
||
"type": "number",
|
||
"description": "成交额"
|
||
},
|
||
"settle": {
|
||
"type": "number",
|
||
"description": "结算价（可选字段）"
|
||
},
|
||
"openInterest": {
|
||
"type": "number",
|
||
"description": "持仓量/未平仓合约（可选字段）"
|
||
}
|
||
}
|
||
},
|
||
"TickSnapshot": {
|
||
"type": "object",
|
||
"description": "tick 快照字段",
|
||
"properties": {
|
||
"time": {
|
||
"type": "integer",
|
||
"description": "行情时间戳（毫秒）"
|
||
},
|
||
"timetag": {
|
||
"type": "string",
|
||
"description": "行情时间（可读格式，如 20260820 15:00:04）"
|
||
},
|
||
"lastPrice": {
|
||
"type": "number",
|
||
"description": "最新价"
|
||
},
|
||
"open": {
|
||
"type": "number",
|
||
"description": "今开"
|
||
},
|
||
"high": {
|
||
"type": "number",
|
||
"description": "最高"
|
||
},
|
||
"low": {
|
||
"type": "number",
|
||
"description": "最低"
|
||
},
|
||
"lastClose": {
|
||
"type": "number",
|
||
"description": "昨收"
|
||
},
|
||
"amount": {
|
||
"type": "number",
|
||
"description": "成交额（元）"
|
||
},
|
||
"volume": {
|
||
"type": "integer",
|
||
"description": "成交量（股）"
|
||
},
|
||
"pvolume": {
|
||
"type": "integer",
|
||
"description": "成交笔数（或同 volume）"
|
||
},
|
||
"askPrice": {
|
||
"type": "array",
|
||
"description": "卖五档价格（askPrice[0]=卖一）",
|
||
"items": {
|
||
"type": "number"
|
||
}
|
||
},
|
||
"askVol": {
|
||
"type": "array",
|
||
"description": "卖五档量",
|
||
"items": {
|
||
"type": "integer"
|
||
}
|
||
},
|
||
"bidPrice": {
|
||
"type": "array",
|
||
"description": "买五档价格（bidPrice[0]=买一）",
|
||
"items": {
|
||
"type": "number"
|
||
}
|
||
},
|
||
"bidVol": {
|
||
"type": "array",
|
||
"description": "买五档量",
|
||
"items": {
|
||
"type": "integer"
|
||
}
|
||
},
|
||
"stockStatus": {
|
||
"type": "integer",
|
||
"description": "股票状态"
|
||
}
|
||
}
|
||
},
|
||
"InstrumentDetail": {
|
||
"type": "object",
|
||
"description": "合约详情字段",
|
||
"properties": {
|
||
"ExchangeID": {
|
||
"type": "string",
|
||
"description": "交易所（SH/SZ）"
|
||
},
|
||
"InstrumentID": {
|
||
"type": "string",
|
||
"description": "合约代码（不带后缀）"
|
||
},
|
||
"InstrumentName": {
|
||
"type": "string",
|
||
"description": "合约/证券名称"
|
||
},
|
||
"OpenDate": {
|
||
"type": "string",
|
||
"description": "上市日期（YYYYMMDD）"
|
||
},
|
||
"PreClose": {
|
||
"type": "number",
|
||
"description": "昨收盘价"
|
||
},
|
||
"UpStopPrice": {
|
||
"type": "number",
|
||
"description": "涨停价"
|
||
},
|
||
"DownStopPrice": {
|
||
"type": "number",
|
||
"description": "跌停价"
|
||
},
|
||
"PriceTick": {
|
||
"type": "number",
|
||
"description": "最小价格变动单位"
|
||
}
|
||
}
|
||
},
|
||
"Position": {
|
||
"type": "object",
|
||
"properties": {
|
||
"stock_code": {
|
||
"type": "string",
|
||
"description": "完整证券代码（带交易所后缀，如 600519.SH）"
|
||
},
|
||
"stock_name": {
|
||
"type": "string",
|
||
"description": "证券名称"
|
||
},
|
||
"volume": {
|
||
"type": "integer",
|
||
"description": "当前持仓量（股）"
|
||
},
|
||
"available": {
|
||
"type": "integer",
|
||
"description": "可用数量（可卖数量，股）"
|
||
},
|
||
"frozen_volume": {
|
||
"type": "integer",
|
||
"description": "冻结数量（股）"
|
||
},
|
||
"on_road_volume": {
|
||
"type": "integer",
|
||
"description": "在途股份（股）"
|
||
},
|
||
"yesterday_volume": {
|
||
"type": "integer",
|
||
"description": "昨仓数量（股）"
|
||
},
|
||
"avg_price": {
|
||
"type": "number",
|
||
"description": "持仓成本价 = (总买入金额-总卖出金额)/剩余数量"
|
||
},
|
||
"open_price": {
|
||
"type": "number",
|
||
"description": "开仓均价（与 avg_price 同源）"
|
||
},
|
||
"price": {
|
||
"type": "number",
|
||
"description": "最新价（缺失时兜底为成本价）"
|
||
},
|
||
"market_value": {
|
||
"type": "number",
|
||
"description": "持仓市值（元）；缺失时按 volume*price 计算"
|
||
},
|
||
"profit": {
|
||
"type": "number",
|
||
"description": "浮动盈亏（元）；缺失时按 (price-avg_price)*volume 计算"
|
||
},
|
||
"profit_pct": {
|
||
"type": "number",
|
||
"description": "浮动盈亏比例（%）"
|
||
},
|
||
"direction": {
|
||
"type": "integer",
|
||
"description": "买卖方向（股票恒为 48=买入/多）"
|
||
},
|
||
"m_strInstrumentID": {
|
||
"type": "string",
|
||
"description": "[原始字段] 证券代码（不带后缀，如 600519）"
|
||
},
|
||
"m_strInstrumentName": {
|
||
"type": "string",
|
||
"description": "[原始字段] 证券名称"
|
||
},
|
||
"m_nVolume": {
|
||
"type": "integer",
|
||
"description": "[原始字段] 当前拥股/持仓量"
|
||
},
|
||
"m_nCanUseVolume": {
|
||
"type": "integer",
|
||
"description": "[原始字段] 可用数量"
|
||
},
|
||
"m_dOpenPrice": {
|
||
"type": "number",
|
||
"description": "[原始字段] 持仓成本"
|
||
},
|
||
"m_dFloatProfit": {
|
||
"type": "number",
|
||
"description": "[原始字段] 浮动盈亏"
|
||
}
|
||
}
|
||
},
|
||
"PositionSummary": {
|
||
"type": "object",
|
||
"description": "汇总信息",
|
||
"properties": {
|
||
"count": {
|
||
"type": "integer",
|
||
"description": "持仓只数"
|
||
},
|
||
"total_market_value": {
|
||
"type": "number",
|
||
"description": "总市值（元）"
|
||
},
|
||
"total_profit": {
|
||
"type": "number",
|
||
"description": "总浮动盈亏（元）"
|
||
}
|
||
}
|
||
},
|
||
"Asset": {
|
||
"type": "object",
|
||
"properties": {
|
||
"m_strAccountID": {
|
||
"type": "string",
|
||
"description": "资金账号"
|
||
},
|
||
"m_dBalance": {
|
||
"type": "number",
|
||
"description": "总资产（账户总资金金额）"
|
||
},
|
||
"m_dAvailable": {
|
||
"type": "number",
|
||
"description": "可用金额（可交易和提取的资金）"
|
||
},
|
||
"m_dAssetBalance": {
|
||
"type": "number",
|
||
"description": "证券初始资金（股票账户初始资金）"
|
||
},
|
||
"m_dFrozenCash": {
|
||
"type": "number",
|
||
"description": "冻结金额（被冻结的资金）"
|
||
},
|
||
"m_dInstrumentValue": {
|
||
"type": "number",
|
||
"description": "总市值（持有证券的总市值）"
|
||
},
|
||
"m_dStockValue": {
|
||
"type": "number",
|
||
"description": "股票总市值"
|
||
},
|
||
"m_dPositionProfit": {
|
||
"type": "number",
|
||
"description": "持仓盈亏"
|
||
},
|
||
"m_dFetchBalance": {
|
||
"type": "number",
|
||
"description": "可取金额"
|
||
},
|
||
"m_dCashIn": {
|
||
"type": "number",
|
||
"description": "出入金净值"
|
||
},
|
||
"m_strTradingDate": {
|
||
"type": "string",
|
||
"description": "交易日"
|
||
}
|
||
}
|
||
},
|
||
"Order": {
|
||
"type": "object",
|
||
"properties": {
|
||
"m_strOrderSysID": {
|
||
"type": "string",
|
||
"description": "合同编号/委托号（撤单凭此号）"
|
||
},
|
||
"m_strAccountID": {
|
||
"type": "string",
|
||
"description": "资金账号"
|
||
},
|
||
"m_strExchangeID": {
|
||
"type": "string",
|
||
"description": "证券市场（SH/SZ）"
|
||
},
|
||
"m_strInstrumentID": {
|
||
"type": "string",
|
||
"description": "证券代码（不带后缀，如 601117）"
|
||
},
|
||
"m_strInstrumentName": {
|
||
"type": "string",
|
||
"description": "证券名称"
|
||
},
|
||
"m_nDirection": {
|
||
"type": "integer",
|
||
"description": "买卖方向（股票恒为 48）"
|
||
},
|
||
"m_nOrderStatus": {
|
||
"type": "integer",
|
||
"description": "委托状态码：48=未报, 49=待报, 50=已报(待成交), 51=已报待撤, 52=部成待撤, 53=部撤, 54=已撤, 55=部成, 56=已成, 57=废单"
|
||
},
|
||
"m_nVolumeTotalOriginal": {
|
||
"type": "integer",
|
||
"description": "委托数量（最初委托数量）"
|
||
},
|
||
"m_nVolumeTraded": {
|
||
"type": "integer",
|
||
"description": "成交数量（已成交量）"
|
||
},
|
||
"m_nVolumeTotal": {
|
||
"type": "integer",
|
||
"description": "委托剩余量（总委托量-成交量）"
|
||
},
|
||
"m_dLimitPrice": {
|
||
"type": "number",
|
||
"description": "委托价格（限价单的限价）"
|
||
},
|
||
"m_strInsertDate": {
|
||
"type": "string",
|
||
"description": "委托日期"
|
||
},
|
||
"m_strInsertTime": {
|
||
"type": "string",
|
||
"description": "委托时间"
|
||
},
|
||
"m_dTradedPrice": {
|
||
"type": "number",
|
||
"description": "成交均价（股票）"
|
||
},
|
||
"m_strErrorMsg": {
|
||
"type": "string",
|
||
"description": "状态信息/错误信息"
|
||
},
|
||
"m_strCancelInfo": {
|
||
"type": "string",
|
||
"description": "废单原因"
|
||
},
|
||
"m_strRemark": {
|
||
"type": "string",
|
||
"description": "投资备注（大 QMT 订单行通常无此字段，服务端过滤）"
|
||
}
|
||
}
|
||
},
|
||
"Trade": {
|
||
"type": "object",
|
||
"properties": {
|
||
"m_strTradeID": {
|
||
"type": "string",
|
||
"description": "成交编号"
|
||
},
|
||
"m_strOrderSysID": {
|
||
"type": "string",
|
||
"description": "合同编号/委托号（与委托表同号，用于关联）"
|
||
},
|
||
"m_strAccountID": {
|
||
"type": "string",
|
||
"description": "资金账号"
|
||
},
|
||
"m_strExchangeID": {
|
||
"type": "string",
|
||
"description": "证券市场（SH/SZ）"
|
||
},
|
||
"m_strInstrumentID": {
|
||
"type": "string",
|
||
"description": "证券代码（不带后缀，如 600719）"
|
||
},
|
||
"m_strInstrumentName": {
|
||
"type": "string",
|
||
"description": "证券名称"
|
||
},
|
||
"m_nDirection": {
|
||
"type": "integer",
|
||
"description": "买卖方向（股票恒为 48）"
|
||
},
|
||
"m_dPrice": {
|
||
"type": "number",
|
||
"description": "成交均价"
|
||
},
|
||
"m_nVolume": {
|
||
"type": "integer",
|
||
"description": "成交量（股）"
|
||
},
|
||
"m_strTradeDate": {
|
||
"type": "string",
|
||
"description": "成交日期"
|
||
},
|
||
"m_strTradeTime": {
|
||
"type": "string",
|
||
"description": "成交时间"
|
||
},
|
||
"m_dCommission": {
|
||
"type": "number",
|
||
"description": "手续费"
|
||
},
|
||
"m_dTradeAmount": {
|
||
"type": "number",
|
||
"description": "成交额"
|
||
},
|
||
"m_strRemark": {
|
||
"type": "string",
|
||
"description": "投资备注"
|
||
}
|
||
}
|
||
}
|
||
}
|
||
}
|
||
} |