提交选股队列任务

来源同步：/Users/mac/Projects/chatgpt-codex/doc/api_Screener.md

所属接口集：股票筛选

请求 URL

POST /v1/api/screener/queue/submit

认证方式

Bearer Token（详见 认证与签名）

接口概述

将选股任务提交到异步队列。支持 tailpick、xuxiang 等算法。若参数命中缓存则直接返回结果，否则返回任务 ID 供后续查询。详见 异步任务队列。

请求参数

Body 参数（JSON）：

参数	类型	必填	默认值	说明
algo	string	是	-	选股算法名称，如 tailpick、xuxiang
params	object	否	-	算法参数对象。若不提供，则除 algo 外的顶层字段将作为参数使用

Query 参数（可补充 params 中缺失的常用字段）：

参数	类型	必填	默认值	说明
codes	string	否	-	股票代码，逗号分隔
code	string	否	-	同 codes
block_code	string	否	-	板块代码
end	string	否	-	目标日期
freq	string	否	D	K线频率
min_amount	float	否	1e8	最低成交额
turnover_min	float	否	2.0	最低换手率
turnover_max	float	否	20.0	最高换手率
price_min	float	否	3.0	最低价格
price_max	float	否	50.0	最高价格
vol_mult	float	否	1.5	量比倍数
near_high	float	否	0.005	接近新高阈值
topn	int	否	30	返回前 N 只
threads	int	否	8	并发线程数

接口说明

• 当 algo 为 tailpick 时，参数与同步接口 /screener/tailpick 一致，end 参数会自动解析为最近交易日。
• 若参数命中缓存，立即返回 HTTP 200 及 cached: true 与结果。
• 否则入队返回 HTTP 202，需通过 /queue/status 和 /queue/result 轮询获取结果。

响应格式示例

命中缓存（HTTP 200）：

{
  "code": 1,
  "message": "done",
  "data": {
    "job_id": "abc123",
    "status": "done",
    "cached": true,
    "result": { "code": 1, "message": "success", "data": [] }
  }
}

入队（HTTP 202）：

{
  "code": 1,
  "message": "queued",
  "data": {
    "job_id": "abc123",
    "status": "queued",
    "cached": false
  }
}

返回状态

状态码	说明
200	成功（命中缓存）
202	已入队，等待执行
400	参数错误（缺少 algo）
401	未认证
403	无权限

---