Dividends & buybacks
get_capital_returnsHow a company returns capital: dividend-rate history with each raise or cut, buyback authorizations beside the cash actually spent, splits and name changes. Forward ex-dates are not served. Use when the user asks: did X raise its dividend; is X buying back stock; has X cut it. Args: entity; kind = dividends | buybacks | actions.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"entity": "<entity>"
},
"name": "get_capital_returns"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| kind | No | "dividends" (default): the declared per-share dividend over time, each raise or cut named; "buybacks": repurchase authorisations beside the cash actually spent; "actions": stock splits and name changes; "calendar": the declared dividends (forward ex-dates are not served). | dividends |
| limit | No | Most records to return. | |
| entity | Yes | The company: a ticker (AAPL, BRK.B), a company name (Apple) or an SEC CIK. | |
| periods | No | How many of the latest filed periods to read (usually quarters). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |