行情接口说明.md 3.3KB
供应商 — 行情（移动端 / 小程序）
1. 说明
供应商底部导航 「行情」 复用牧民端牦牛行情接口，不新增 /app/supplier/** 行情路径。
| 项 | 值 |
|---|---|
| Base Path | /app/yakMarket |
| 数据表 | biz_market_daily_quote、biz_trade_market |
| 鉴权 | 需登录；不区分牧民/供应商/承销商角色 |
| 数据权限 | 全市场公开行情，不按 supplier_id 过滤 |
后台登记时，交易市场名称须与主数据 巴青牦牛交易市场 一致。
1.1 前端复用
| 项 | 路径 |
|---|---|
| API 封装 | ruoyi-ui-app/api/yakMarket.js |
| 页面参考 | package-a/yak-market/index.vue |
源文档：
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
8. 修订记录
| 版本 | 说明 |
|---|---|
| 1.0 | 供应商行情 Tab 复用 /app/yakMarket；本文收录完整接口字段（同源 doc/app/牦牛行情） |