Fundamental
Authorization
Signed mode: every request is signed with your App Key/Secret. Header set:
| Name | Type | Required | Description |
|---|---|---|---|
Authorization | string · header | Required | The account Access Token from the OpenAPI dashboard — passed as the raw token (no Bearer prefix) and included in the signature calculation. |
X-Api-Key | string · header | Required | Your App Key. |
X-Timestamp | string · header | Required | Request timestamp in seconds (Unix epoch). |
X-Api-Signature | string · header | Required | HMAC-SHA256 signature. Format: HMAC-SHA256 SignedHeaders=authorization;x-api-key;x-timestamp, Signature=. |
Get share buyback data including historical buyback amounts and ratios.
Request
Query parameters
| Name | Type | Required | Description |
|---|---|---|---|
symbol | string | Required | Security symbol, e.g. `AAPL.US` |
Response
Response properties
| Name | Type | Required | Description |
|---|---|---|---|
recent_buybacks | object | Optional | Trailing 12-month buyback summary |
└ net_buyback_ttm | string | Optional | Net buyback (trailing 12 months) |
└ net_buyback_yield_ttm | string | Optional | Buyback yield (trailing 12 months) |
└ currency | string | Optional | Currency |
buyback_history | object[] | Optional | Annual buyback history |
└ fiscal_year | string | Optional | Fiscal year |
└ fiscal_year_range | string | Optional | Fiscal year date range |
└ net_buyback | string | Optional | Net buyback amount |
└ net_buyback_yield | string | Optional | Buyback yield |
└ net_buyback_growth_rate | string | Optional | Buyback growth rate |
└ currency | string | Optional | Currency |
└ total_shareholder_yield | string | Optional | Total shareholder yield. |
└ dividend | string | Optional | Dividend per share. |
└ dividend_yield | string | Optional | Dividend yield. |
└ dividend_growth_rate | string | Optional | Dividend growth rate. |
└ dividend_payout_ratio | string | Optional | Dividend payout ratio. |
└ dividend_to_cashflow_ratio | string | Optional | Dividend-to-cashflow ratio. |
└ net_buyback_payout_ratio | string | Optional | Buyback payout ratio |
└ net_buyback_to_cashflow_ratio | string | Optional | Buyback to free cash flow ratio |
buyback_ratios | object[] | Optional | Buyback ratio history |
└ fiscal_year | string | Optional | Fiscal year |
└ fiscal_year_range | string | Optional | Fiscal year date range |
└ net_buyback_payout_ratio | string | Optional | Buyback payout ratio |
└ net_buyback_to_cashflow_ratio | string | Optional | Buyback to free cash flow ratio |
└ total_shareholder_yield | string | Optional | Total shareholder yield. |
└ dividend | string | Optional | Dividend per share. |
└ dividend_yield | string | Optional | Dividend yield. |
└ dividend_growth_rate | string | Optional | Dividend growth rate. |
└ dividend_payout_ratio | string | Optional | Dividend payout ratio. |
└ dividend_to_cashflow_ratio | string | Optional | Dividend-to-cashflow ratio. |
└ net_buyback | string | Optional | Net buyback amount |
└ net_buyback_yield | string | Optional | Buyback yield |
└ net_buyback_growth_rate | string | Optional | Buyback growth rate |
└ currency | string | Optional | Currency |
Response JSON example
{
"code": 0,
"message": "success",
"data": {
"buyback_history": [
{
"fiscal_year": "FY2024",
"fiscal_year_range": "2024-01-01~2024-12-31",
"net_buyback": "94949000000",
"net_buyback_yield": "0.0241",
"net_buyback_growth_rate": "-0.1233"
}
],
"buyback_ratios": [
{
"net_buyback_payout_ratio": "0.9502",
"net_buyback_to_cashflow_ratio": "0.8821"
}
],
"recent_buybacks": {
"currency": "USD",
"net_buyback_ttm": "94949000000",
"net_buyback_yield_ttm": "0.0241"
}
}
}Error code
See the Error Codes page for the full list of error codes.