Skip to main content
POST
/
v1
/
stock
/
earnings-calendar
Stock Earnings Calendar
curl --request POST \
  --url https://api.reportify.cn/v1/stock/earnings-calendar \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "area": "cn",
  "start_date": "2025-11-20",
  "end_date": "2025-12-31",
  "symbol": "000300"
}
'
{
  "status": 123,
  "code": 123,
  "message": "<string>",
  "data": {}
}

​
查询股票财报日历

URL: /v1/stock/earnings-calendar
方法: POST
描述: 根据市场区域和日期范围查询股票财报发布日历。

​
请求参数

参数名类型必填描述
areastring是市场区域：cn（中国）、hk（香港）、us（美国）
symbolstring否股票代码（可选，用于查询特定股票）
start_datestring是开始日期（格式：YYYY-MM-DD）
end_datestring是结束日期（格式：YYYY-MM-DD）

​
响应参数

参数名类型描述
statusintegerHTTP 状态码
codeinteger业务状态码
messagestring响应消息
dataobject响应数据

​
data 对象结构

参数名类型描述
itemsarray财报发布项目列表

​
财报项目对象结构

参数名类型描述
symbolstring股票代码
namestring公司名称
fillingDatestring财报发布日期（ISO 8601）

​
示例代码

​
cURL 示例

curl -X POST "https://api.example.com/v1/stock/earnings-calendar" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "area": "hk",
    "start_date": "2025-08-01",
    "end_date": "2025-08-31"
  }'

​
Python 示例

import requests

url = "https://api.example.com/v1/stock/earnings-calendar"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
}
data = {
    "area": "hk",
    "start_date": "2025-08-01",
    "end_date": "2025-08-31"
}

response = requests.post(url, headers=headers, json=data)
result = response.json()

print(f"状态码: {result['status']}")
print(f"财报发布数量: {len(result['data']['items'])}")

for item in result['data']['items']:
    print(f"\n股票代码: {item['symbol']}")
    print(f"公司名称: {item['name']}")
    print(f"发布日期: {item['fillingDate']}")

​
Python 示例（查询特定股票）

import requests

url = "https://api.example.com/v1/stock/earnings-calendar"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
}
data = {
    "area": "cn",
    "symbol": "000300",
    "start_date": "2025-11-20",
    "end_date": "2025-12-31"
}

response = requests.post(url, headers=headers, json=data)
result = response.json()

if result['data']['items']:
    item = result['data']['items'][0]
    print(f"股票代码: {item['symbol']}")
    print(f"公司名称: {item['name']}")
    print(f"财报发布日期: {item['fillingDate']}")
else:
    print("指定股票代码在指定日期范围内没有财报发布")

​
响应示例

​
成功响应（有数据）

{
  "status": 200,
  "code": 0,
  "message": "",
  "data": {
    "items": [
      {
        "symbol": "01997",
        "name": "九龙仓置业",
        "fillingDate": "2025-08-07T00:00:00+08:00"
      },
      {
        "symbol": "00087",
        "name": "太古股份公司B",
        "fillingDate": "2025-08-07T00:00:00+08:00"
      },
      {
        "symbol": "00019",
        "name": "太古股份公司A",
        "fillingDate": "2025-08-07T00:00:00+08:00"
      }
    ]
  }
}

​
成功响应（无数据）

{
  "status": 200,
  "code": 0,
  "message": "",
  "data": {
    "items": []
  }
}

​
注意事项

  • area 参数值：
    • cn - 中国 A 股市场
    • hk - 香港股票市场
    • us - 美国股票市场
  • 日期格式：start_date 和 end_date 必须使用 YYYY-MM-DD 格式
  • 日期范围：建议查询范围不超过 3 个月，以获得最佳性能
  • symbol 参数：可选参数，不提供时返回该时间段内所有股票的财报日历
  • 时间格式：fillingDate 使用 ISO 8601 格式，包含时区信息
  • 排序：结果按 fillingDate 升序排列
  • 空响应：如果 data.items 为空数组，说明指定股票代码在指定日期范围内没有财报发布

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Input schema for StockEarningsCalendarTool

​
area
enum<string>
required

Market area: cn, hk, or us

Available options:
cn,
hk,
us
Example:

"cn"

​
start_date
string
required

Start date (YYYY-MM-DD)

Example:

"2025-11-20"

​
end_date
string
required

End date (YYYY-MM-DD)

Example:

"2025-12-31"

​
symbol
string

Stock symbol (optional)

Example:

"000300"

Response

Successful Response

Generic response wrapper from stock API

​
status
integer

HTTP status code

​
code
integer

Response code (0 for success)

​
message
string

Response message

​
data
Data · object

Response data (structure varies by endpoint)