`list_compound_prices`

化合物价格时序（按 mol_id / cas_no，可选日期范围）。

英文描述

List historical price records for a chemical over time from ads_compound_price. Use when the user asks about price trends, quotations, or time-series pricing for a substance. Requires mol_id or cas_no. Supports optional date range. Not for market-wide summary—use search_price_summary.

文档更新：2026-06-23T10:00:00+08:00

请求参数

参数名	参数说明	数据类型	样例数据
`mol_id`	选填；至少 1 个字符	string	（选填，示例中省略）
`cas_no`	选填；至少 1 个字符	string	（选填，示例中省略）
`date_from`	选填；至少 10 个字符	string	（选填，示例中省略）
`date_to`	选填；至少 10 个字符	string	（选填，示例中省略）
`limit`	选填	integer	20
`offset`	选填	integer	0

响应参数

参数名	参数说明	数据类型	样例数据
`data`	业务记录数组	array	[{"cas_no": "64-17-5", "mol_id": "MOL2024010112345678", "price_date": "2024-01-15", "price": 5800.0, "currency": "CNY", "unit": "吨"}]
`data[].cas_no`	CAS 号	string	64-17-5
`data[].mol_id`	化合物 ID	string	MOL2024010112345678
`data[].price_date`	价格日期	string	2024-01-15
`data[].price`	价格	number	5800
`data[].currency`	币种	string	CNY
`data[].unit`	计量单位	string	吨
`meta.total`	命中总数	integer	100
`meta.limit`	本页 limit	integer	20
`meta.offset`	本页 offset	integer	0
`meta.has_more`	是否还有下一页	boolean	true

响应状态说明

状态	说明
`success`	调用成功，返回业务数据
`failed`	参数错误、后端业务错误或系统异常
`denied`	API Key 无效、无权限、RBAC/菜单拒绝等

请求示例

{
  "limit": 20,
  "offset": 0
}

响应示例

{
  "data": [
    {
      "cas_no": "64-17-5",
      "mol_id": "MOL2024010112345678",
      "price_date": "2024-01-15",
      "price": 5800,
      "currency": "CNY",
      "unit": "吨"
    }
  ],
  "meta": {
    "total": 1,
    "limit": 20,
    "offset": 0,
    "has_more": false
  }
}