huimv-baqing/doc/app/牦牛行情/牦牛行情接口说明.md

牦牛行情（移动端）

1. 概述

项	说明
Base Path	/app/yakMarket
数据表	biz_market_daily_quote、biz_trade_market
鉴权	需登录（不区分牧民/承销商/供应商角色；交易市场角色账号登录后可直接调用）
查询范围	del_flag=0；交易市场 market_name=巴青牦牛交易市场（不按生长阶段过滤）
承销商「行情」	复用本 Base Path；说明见 doc/app/交易市场平台（承销商）/行情接口说明.md
供应商「行情」	复用本 Base Path；说明见 doc/app/交易市场平台（供应商）/行情接口说明.md

后台登记时，交易市场名称须与主数据 巴青牦牛交易市场 一致；生长阶段按实际品类（犊牛/架子牛/屠宰牛等）登记即可。

2. 昨日主行情

GET /app/yakMarket/yesterday

查询 行情日期 = 服务器当前日期前一天 的单条记录。

响应 data

字段	说明
avgPrice	均价
priceUnit	单位枚举：1 元/头，2 元/斤
priceUnitName	单位中文
quoteDate	行情日期 yyyy-MM-dd

无数据时 data 为 null。

3. 近 7 日统计

GET /app/yakMarket/stats7

统计区间：昨日往前共 7 个自然日（含昨日），对上述范围内的日度记录按 avg_price 聚合。

响应 data

字段	说明
avgPrice7	7 日均价（算术平均）
minPrice7 / maxPrice7	7 日最低/最高均价
minQuoteDate / maxQuoteDate	对应行情日期
minQuoteDateLabel / maxQuoteDateLabel	展示用 MM-dd
priceUnit / priceUnitName	取区间内最新行情日的单位
createTime	区间内记录的最大 create_time

4. 价格走势

GET /app/yakMarket/trend

参数	必填	说明
days	否	7 或 30，默认 7

返回 截至昨日 的 days 个自然日内、按 quote_date 升序 的折线点。

响应 data 数组元素

字段	说明
quoteDate	行情日期
quoteDateLabel	图表横轴 MM-dd
avgPrice	均价

5. 价格预测

GET /app/yakMarket/forecast

取 昨日 记录的看涨/看平/看跌概率（百分比，饼图/环形图）。

响应 data

字段	说明
probRise	看涨 %
probFlat	看平 %
probFall	看跌 %

6. 每日行情列表

GET /app/yakMarket/daily/list

参数	说明
pageNum / pageSize	分页，默认 1 / 10

排序：quote_date 降序。

响应：标准 TableDataInfo，rows 元素字段：

字段	说明
id	主键
quoteDate	行情日期
tradeMarketName	交易市场名称
marketLocation	市场位置（省市区 + 市场详细地址）
priceMin / priceMax	最低价 / 最高价
priceUnit / priceUnitName	单位
supplyStatusName	出栏情况
changeFactorsText	变化因素（顿号分隔）
trendPrediction	走势预测：按昨日概率取最大项（看涨/看平/看跌）
outboundAdvice	出栏建议

7. 界面参考

doc/交易市场平台/市场行情登记/Snipaste_2026-05-23_22-14-59.jpg、小程序 package-a/yak-market/index.vue。