# CapitalGains

Used to record a distribution of cash that an issuer has determined will be declared as income financed from capital gains and not ordinary income and details related to the capital gain

## Example Usage

```typescript
import { CapitalGains } from "@apexfintechsolutions/ascend-sdk/models/components";

let value: CapitalGains = {};
```

## Fields

| Field                                                                                                                                                                         | Type                                                                                                                                                                          | Required                                                                                                                                                                      | Description                                                                                                                                                                   | Example                                                                                                                                                                       |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `cashRate`                                                                                                                                                                    | [components.EntryCashRate](../../models/components/entrycashrate.md)                                                                                                          | :heavy_minus_sign:                                                                                                                                                            | The rate (raw value, not a percentage, example: 50% will be .5 in this field) at which cash will be disbursed to the shareholder                                              | {<br/>"value": "0.25"<br/>}                                                                                                                                                   |
| `corporateActionGeneralInformation`                                                                                                                                           | [components.EntryCapitalGainsCorporateActionGeneralInformation](../../models/components/entrycapitalgainscorporateactiongeneralinformation.md)                                | :heavy_minus_sign:                                                                                                                                                            | Common fields for corporate actions                                                                                                                                           |                                                                                                                                                                               |
| `longTermGain`                                                                                                                                                                | *boolean*                                                                                                                                                                     | :heavy_minus_sign:                                                                                                                                                            | Corresponds to corporateactions.announcement.capital_gains                                                                                                                    | false                                                                                                                                                                         |
| `paymentDate`                                                                                                                                                                 | [components.EntryPaymentDate](../../models/components/entrypaymentdate.md)                                                                                                    | :heavy_minus_sign:                                                                                                                                                            | The anticipated payment date at the depository                                                                                                                                | {<br/>"day": 14,<br/>"month": 5,<br/>"year": 2024<br/>}                                                                                                                       |
| `qualified`                                                                                                                                                                   | *boolean*                                                                                                                                                                     | :heavy_minus_sign:                                                                                                                                                            | Identifies whether dividend income is potentially qualified for the lower maximum individual federal tax rate under the Jobs and Growth Tax Relief Reconciliation Act of 2003 | false                                                                                                                                                                         |
| `quantity`                                                                                                                                                                    | [components.EntryCapitalGainsQuantity](../../models/components/entrycapitalgainsquantity.md)                                                                                  | :heavy_minus_sign:                                                                                                                                                            | Corresponds to the position's trade quantity                                                                                                                                  | {<br/>"value": "0.25"<br/>}                                                                                                                                                   |
| `recordDate`                                                                                                                                                                  | [components.RecordDate](../../models/components/recorddate.md)                                                                                                                | :heavy_minus_sign:                                                                                                                                                            | The date on which positions are recorded in order to calculate entitlement                                                                                                    | {<br/>"day": 14,<br/>"month": 5,<br/>"year": 2024<br/>}                                                                                                                       |
| `reinvested`                                                                                                                                                                  | *boolean*                                                                                                                                                                     | :heavy_minus_sign:                                                                                                                                                            | Indicates whether the cash dividend was reinvested                                                                                                                            | false                                                                                                                                                                         |