其他日历
curl --request GET \
--url https://api.tickdb.ai/v1/fundamentals/calendar/other \
--header 'X-API-Key: <api-key>'import requests
url = "https://api.tickdb.ai/v1/fundamentals/calendar/other"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://api.tickdb.ai/v1/fundamentals/calendar/other', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.tickdb.ai/v1/fundamentals/calendar/other",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-API-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.tickdb.ai/v1/fundamentals/calendar/other"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.tickdb.ai/v1/fundamentals/calendar/other")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.tickdb.ai/v1/fundamentals/calendar/other")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"code": 0,
"data": {
"from": "2023-12-25",
"to": "2023-12-25",
"events": [
{
"category": "<string>",
"event_datetime": "2023-11-07T05:31:56Z",
"symbol": "<string>",
"market": "US",
"event_type": "<string>",
"content": "<string>",
"counter_name": "<string>",
"date_type": "<string>",
"star": 123,
"currency": "<string>",
"issue_price": "<string>",
"data": [
{
"key": "<string>",
"value_type": "<string>",
"value_text": "<string>",
"value_raw": "<string>"
}
]
}
]
},
"page": {
"next_cursor": "<string>",
"limit": 250
}
}财经日历
其他日历
按类别查询宏观数据、休市、会议等其他财经事件。
GET
/
v1
/
fundamentals
/
calendar
/
other
其他日历
curl --request GET \
--url https://api.tickdb.ai/v1/fundamentals/calendar/other \
--header 'X-API-Key: <api-key>'import requests
url = "https://api.tickdb.ai/v1/fundamentals/calendar/other"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://api.tickdb.ai/v1/fundamentals/calendar/other', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.tickdb.ai/v1/fundamentals/calendar/other",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-API-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.tickdb.ai/v1/fundamentals/calendar/other"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.tickdb.ai/v1/fundamentals/calendar/other")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.tickdb.ai/v1/fundamentals/calendar/other")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"code": 0,
"data": {
"from": "2023-12-25",
"to": "2023-12-25",
"events": [
{
"category": "<string>",
"event_datetime": "2023-11-07T05:31:56Z",
"symbol": "<string>",
"market": "US",
"event_type": "<string>",
"content": "<string>",
"counter_name": "<string>",
"date_type": "<string>",
"star": 123,
"currency": "<string>",
"issue_price": "<string>",
"data": [
{
"key": "<string>",
"value_type": "<string>",
"value_text": "<string>",
"value_raw": "<string>"
}
]
}
]
},
"page": {
"next_cursor": "<string>",
"limit": 250
}
}套餐权限
| 套餐 | 可用 |
|---|---|
| 免费版 | ❌ |
| 基础版 | ✅ |
| 专业版 | ✅ |
| 全量套餐(A 股、港股、美股) | ✅ |
| 企业版 | ✅ |
注意事项
- 必须传入一种
category;财报、股息、拆股和新股事件请使用各自的专用日历接口。 from默认为当前 UTC 日期;to默认为from后 7 天。日期范围两端均包含。- 默认每页 100 条,最多 500 条。第一页不传
cursor;后续保持筛选条件不变,并将上一页的page.next_cursor原样传入,直到其为null。若首次未传日期,后续页请使用首响应的data.from、data.to固定日期范围。 - API Key 仅允许部分市场时,必须传入已获准的
market;无对应事件时返回空events数组。
支持的市场
| 市场 | 示例 |
|---|---|
| 美股 | US |
| 港股 | HK |
| A股 | CN |
请求参数
| 参数 | 必填 | 说明 |
|---|---|---|
from | 否 | 起始日期,格式 YYYY-MM-DD |
to | 否 | 结束日期,格式 YYYY-MM-DD |
category | 是 | 其他事件类别,取值见下表 |
market | 否* | 市场过滤:US、HK、CN;市场受限的 API Key 必填 |
symbols | 否 | 股票代码,英文逗号分隔,最多 50 个 |
limit | 否 | 每页数量,1–500,默认 100 |
cursor | 否 | 下一页游标;第一页不传 |
category 取值
| 取值 | 说明 |
|---|---|
macrodata | 宏观经济数据公布 |
closed | 市场休市 |
meeting | 会议 |
merge | 并购与合并 |
halt_resume | 停复牌 |
special_treatment | 特别处理 |
special_treatment_start | 特别处理开始 |
special_treatment_end | 特别处理结束 |
listing_status | 上市状态 |
listing_suspension | 暂停上市 |
listing_resumption | 恢复上市 |
delisting | 退市 |
lockup_expiry | 限售股解禁 |
请求示例
curl -H "X-API-Key: YOUR_API_KEY" \
"https://api.tickdb.ai/v1/fundamentals/calendar/other?from=2026-09-21&to=2026-09-28&market=US&category=macrodata&limit=100"
返回字段说明
成功响应包含顶层code、data 和 page。
| 字段 | 说明 |
|---|---|
| code | 业务状态码,成功为 0。 |
| data | 当前页的日期范围和事件数据。 |
| └─ from | 查询起始日期,YYYY-MM-DD。 |
| └─ to | 查询结束日期,YYYY-MM-DD。 |
| └─ events | 当前页事件列表;无事件时为空数组。 |
| └─ event_datetime | 事件时间,UTC 日期时间字符串。 |
| └─ market | 所属市场。 |
| └─ symbol | 关联产品代码;不适用时可能为空。 |
| └─ category | 事件细分类别,可能细于请求类别。 |
| └─ event_type | 事件类型。 |
| └─ content | 事件内容。 |
| └─ counter_name | 关联名称;可能为 null。 |
| └─ currency | 币种;可能为 null。 |
| └─ star | 重要程度。 |
| └─ date_type | 事件日期类型;可能为 null。 |
| └─ data | 可选的事件附加数据数组。 |
| └─ key | 附加数据键名。 |
| └─ value_raw | 原始值;可能为 null。 |
| └─ value_text | 展示值;可能为 null。 |
| └─ value_type | 值类型。 |
| page | 分页信息。 |
| └─ next_cursor | 下一页游标;末页为 null。 |
| └─ limit | 当前分页上限。 |
授权
查询参数
起始日期,格式 YYYY-MM-DD
结束日期,格式 YYYY-MM-DD
其他事件类别,取值见下表
可用选项:
macrodata, closed, meeting, merge, halt_resume, special_treatment, special_treatment_start, special_treatment_end, listing_status, listing_suspension, listing_resumption, delisting, lockup_expiry 市场过滤:US、HK、CN;市场受限的 API Key 必填
可用选项:
US, HK, CN 股票代码,英文逗号分隔,最多 50 个
Minimum string length:
1示例:
"AAPL.US"
"AAPL.US,700.HK,600519.SH"
每页数量,1–500,默认 100
必填范围:
1 <= x <= 500下一页游标;第一页不传
Minimum string length:
1