# Buyback

`GET` `/v1/quote/buy-backs`

Get share buyback data including historical buyback amounts and ratios.

## Parameters

### Query Parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `symbol` | string | Yes | Security symbol, e.g. `AAPL.US` |

## Request Example

```bash
curl --request GET \
  --url 'https://openapi.longbridge.com/v1/quote/buy-backs?symbol=<symbol>' \
  --header 'Authorization: Bearer <access_token>'
```

## Response

### Response Properties

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `recent_buybacks` | object | No | Trailing 12-month buyback summary |
| `└ net_buyback_ttm` | string | No | Net buyback (trailing 12 months) |
| `└ net_buyback_yield_ttm` | string | No | Buyback yield (trailing 12 months) |
| `└ currency` | string | No | Currency |
| `buyback_history` | object[] | No | Annual buyback history |
| `└ fiscal_year` | string | No | Fiscal year |
| `└ fiscal_year_range` | string | No | Fiscal year date range |
| `└ net_buyback` | string | No | Net buyback amount |
| `└ net_buyback_yield` | string | No | Buyback yield |
| `└ net_buyback_growth_rate` | string | No | Buyback growth rate |
| `└ currency` | string | No | Currency |
| `└ total_shareholder_yield` | string | No | Total shareholder yield. |
| `└ dividend` | string | No | Dividend per share. |
| `└ dividend_yield` | string | No | Dividend yield. |
| `└ dividend_growth_rate` | string | No | Dividend growth rate. |
| `└ dividend_payout_ratio` | string | No | Dividend payout ratio. |
| `└ dividend_to_cashflow_ratio` | string | No | Dividend-to-cashflow ratio. |
| `└ net_buyback_payout_ratio` | string | No | Buyback payout ratio |
| `└ net_buyback_to_cashflow_ratio` | string | No | Buyback to free cash flow ratio |
| `buyback_ratios` | object[] | No | Buyback ratio history |
| `└ fiscal_year` | string | No | Fiscal year |
| `└ fiscal_year_range` | string | No | Fiscal year date range |
| `└ net_buyback_payout_ratio` | string | No | Buyback payout ratio |
| `└ net_buyback_to_cashflow_ratio` | string | No | Buyback to free cash flow ratio |
| `└ total_shareholder_yield` | string | No | Total shareholder yield. |
| `└ dividend` | string | No | Dividend per share. |
| `└ dividend_yield` | string | No | Dividend yield. |
| `└ dividend_growth_rate` | string | No | Dividend growth rate. |
| `└ dividend_payout_ratio` | string | No | Dividend payout ratio. |
| `└ dividend_to_cashflow_ratio` | string | No | Dividend-to-cashflow ratio. |
| `└ net_buyback` | string | No | Net buyback amount |
| `└ net_buyback_yield` | string | No | Buyback yield |
| `└ net_buyback_growth_rate` | string | No | Buyback growth rate |
| `└ currency` | string | No | Currency |

### Response JSON Example

```json
{
  "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"
    }
  }
}
```
