查詢公司行動

此端點提供股票公司行動資訊查詢，包括拆股、合股、分紅派息等公司行動事件。

---

HTTP 請求

GET /market/v1/tickers/{symbol}/corporate-actions

請求參數

參數名稱	類型	是否必填	說明
symbol	STRING	是	股票代碼，例如：AAPL
market	STRING	是	市場代碼，詳見市場枚舉定義中的值
action_type	STRING	是	公司行動類型，詳見公司行動類型枚舉定義中的值

cURL 請求範例

curl --location --request GET '{$base_url}/market/v1/tickers/AAPL/corporate-actions?market=usex&action_type=dividend' \
--header 'X-API-Key: YOUR_API_KEY' \
--header 'X-API-Signature: YOUR_GENERATED_SIGNATURE' \
--header 'X-API-Timestamp: 1746774142'

---

回應格式

分紅派息回應欄位

欄位名稱	類型	說明
symbol	STRING	股票代碼
market	STRING	市場代碼
action_type	STRING	公司行動類型
ex_dividend_date	LONG	除淨日（毫秒時間戳）
dividend_date	LONG	派息日（毫秒時間戳）
equity_registration_date	LONG	股權登記日（毫秒時間戳）
distribution_plan	STRING	行動方案
value	DECIMAL	每股派息金額

成功回應範例

{
    "code": 0,
    "data": [
        {
            "symbol": "AAPL",
            "market": "usex",
            "action_type": "dividend",
            "ex_dividend_date": 1762664400000,
            "dividend_date": 1762923600000,
            "equity_registration_date": 1762664400000,
            "distribution_plan": "1 Share Dividend 0.25999999 USD",
            "value": 0.25999999
        },
        {
            "symbol": "AAPL",
            "market": "usex",
            "action_type": "dividend",
            "ex_dividend_date": 1754798400000,
            "dividend_date": 1755057600000,
            "equity_registration_date": 1754798400000,
            "distribution_plan": "1 Share Dividend 0.25999999 USD",
            "value": 0.25999999
        }
    ]
}

拆合股回應欄位

欄位名稱	類型	說明
symbol	STRING	股票代碼
market	STRING	市場代碼
action_type	STRING	公司行動類型
distribution_plan	STRING	行動方案
value	DECIMAL	拆合股比例
date	LONG	拆合股日（毫秒時間戳）

成功回應範例

{
    "code": 0,
    "data": [
        {
            "symbol": "TSLA",
            "market": "usex",
            "action_type": "split",
            "distribution_plan": "Code 3 For 1 Stock Split",
            "value": 0.333332986,
            "date": 1661313600000
        }
    ]
}

錯誤回應範例

{
    "code": 500,
    "message": "Internal Service Error",
    "details": ""
}