China equities

Procurement And Sales

ProcurementAndSales

Paid · PlusJSONTry online

This API requires paid access or an active trial. Review its fields and examples first; online payments are not available yet.

Data description

Use the field names shown below when building requests.

主要供应商与客户接口用于获取沪深北上市公司前五大客户销售情况和前五大供应商采购情况；该接口包含日期、证券名称、前五大客户销售明细（客户名称、销售金额、销售额占总额比例）、前五大客户销售合计、前五大供应商采购明细（供应商名称、采购金额、采购额占总额比例）以及前五大供应商采购合计等关键指标使用场景： -支持用户获取公司前五大客户及对应销售情况信息； -支持用户获取公司前五大供应商及对应采购情况信息

POST /v1/data/operations/ProcurementAndSales · JSON

Input parameters

Field	Type	Constraint	Description and example
`stockObject` 股票代码	string_array `string_array`	Required Dictionary selection: `STOCK_A_COMPANY`	股票代码是指沪深北上市公司通用的股票代码，支持一次获取多个品种数据 Example: `["1679"]`
`relationType` 关系类型	string_array `string_array`	Optional Dictionary selection: `RELATIONTYPE`	关系类型是指公司在采购交易时，对手方的的关系类型，包括客户、供应商 Example: `[…]`
`beginDate` 起始日期	date `date`	Optional	起始日期是查询会计报告期区间的开始日期，输入格式“YYYY-MM-DD” Example: `2026-09-30`
`endDate` 截止日期	date `date`	Optional	截止日期是查询会计报告期区间的结束日期，输入格式“YYYY-MM-DD” Example: `2026-09-30`
`pageNo` 页面编号	number `number`	Optional	定位分页查询的目标页码，默认不限 Example: `1`
`pageSize` 页内记录数	number `number`	Optional	单页返回的最大记录条数，默认不限 Example: `5`

Response fields

Field	Type	Constraint	Description and example
`stockobject` 股票内码	string `string`	—	沪深北上市股票的内部编码 Example: `Example text`
`stockname` 股票名称	string `string`	—	沪深北上市公司的股票简称 Example: `Example text`
`stockcode` 股票代码	string `string`	—	沪深北上市公司的通用股票代码 Example: `Example text`
`reportdate` 报告期	string `string`	—	主要供应商/客户数据的报告期 Example: `Example text`
`relationtype` 关系类型	string `string`	—	主要供应商/客户的关系类型：客户\供应商 Example: `Example text`
`serialnumber` 关系排名	string `string`	—	主要供应商/客户的关系排名 Example: `Example text`
`relatedpartyname` 供应商/客户名称	string `string`	—	主要供应商/客户的名称 Example: `Example text`
`tradingvalue` 交易金额（万元）	string `string`	—	主要供应商/客户的交易金额 Example: `Example text`
`ratiointotal` 占总额比例（%）	string `string`	—	主要供应商/客户的交易金额占总交易额之比 Example: `Example text`
`remark` 备注说明	string `string`	—	主要供应商/客户信息的备注说明 Example: `Example text`

Request example

Example instruments, required parameters and applicable page limits are prefilled. Open the side drawer for field notes and a live response.

{
  "parameters": {
    "stockObject": [
      "1679"
    ],
    "pageNo": 1,
    "pageSize": 5
  }
}

stockObject: 贵州茅台 · 600519.SH
Samples use verified instruments and dictionary values. Records depend on the query range, data updates and the selected key's permissions.
The sample requests 5 records; some business aggregates may return more rows, as shown in the actual response.

Coverage and access boundaries

Run the example to check the securities, dates and fields you need. Available history and content rights vary by endpoint. Requests use your account access and the selected API key.

Follow the parameter notes for minute intervals, price adjustment and time units. A missing field does not mean a zero value.