財報日曆

財報日曆

curl --request GET \
  --url https://api.tickdb.ai/v1/fundamentals/calendar/report \
  --header 'X-API-Key: <api-key>'

const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};

fetch('https://api.tickdb.ai/v1/fundamentals/calendar/report', 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/report",
  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/report"

	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))

}

require 'uri'
require 'net/http'

url = URI("https://api.tickdb.ai/v1/fundamentals/calendar/report")

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

fundamentals

calendar

report

財報日曆

curl --request GET \
  --url https://api.tickdb.ai/v1/fundamentals/calendar/report \
  --header 'X-API-Key: <api-key>'

const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};

fetch('https://api.tickdb.ai/v1/fundamentals/calendar/report', 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/report",
  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/report"

	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))

}

require 'uri'
require 'net/http'

url = URI("https://api.tickdb.ai/v1/fundamentals/calendar/report")

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 股、港股、美股）	✅
企業版	✅

注意事項

此接口的事件類別固定為 report（財報及業績公布），毋須傳入 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`
`market`	否*	市場篩選：`US`、`HK`、`CN`；市場受限的 API Key 必填
`symbols`	否	股票代碼，以英文逗號分隔，最多 50 個
`limit`	否	每頁數量，`1–500`，預設 `100`
`cursor`	否	下一頁遊標；第一頁不傳

請求範例

curl -H "X-API-Key: YOUR_API_KEY" \
  "https://api.tickdb.ai/v1/fundamentals/calendar/report?from=2026-09-21&to=2026-09-28&market=US&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	當前分頁上限。

授權

X-API-Key

string

header

必填

查詢參數

from

string<date>

開始日期，格式 YYYY-MM-DD

string<date>

結束日期，格式 YYYY-MM-DD

market

enum<string>

市場篩選：US、HK、CN；市場受限的 API Key 必填

可用選項:

US,

HK,

CN

symbols

string

股票代碼，以英文逗號分隔，最多 50 個

Minimum string length: 1

範例:

"AAPL.US"

"AAPL.US,700.HK,600519.SH"

limit

integer

預設值:100

每頁數量，1–500，預設 100

必填範圍: 1 <= x <= 500

cursor

string

下一頁遊標；第一頁不傳

Minimum string length: 1

回應

財報日曆回應。

code

integer

必填

業務狀態碼，成功為 0。

data

object

必填

Show child attributes

page

object

必填

Show child attributes

介紹

入門指南

REST API

WebSocket 文檔

參考

套餐權限

注意事項

支援市場

請求參數

請求範例

返回欄位說明

授權

查詢參數

回應

​套餐權限

​注意事項

​支援市場

​請求參數

​請求範例

​返回欄位說明

授權

查詢參數

回應

套餐權限

注意事項

支援市場

請求參數

請求範例

返回欄位說明