# Insider transaction

The insider transaction endpoint provides detailed data on trades executed by company insiders, such as executives and directors. It returns information including the insider's name, their role, the transaction type, the number of shares, the transaction date, and the price per share. This endpoint is useful for tracking insider activity and understanding potential insider sentiment towards a company's stock.

**API credits cost:** `200` per symbol

> **Note:** This API endpoint is available starting with the [Pro](https://twelvedata.com/pricing) plan.

## Parameters

- `symbol` (string, optional, see notes)
  The ticker symbol of an instrument for which data is requested, e.g., `AAPL`, `TSLA`.
For preffered stocks use dot(.) delimiter.
E.g. `BRK.A` or `BRK.B` will be correct


- `figi` (string, optional, see notes)
  Filter by financial instrument global identifier (FIGI). This request parameter is available starting with the Ultra plan


- `isin` (string, optional, see notes)
  Filter by international securities identification number (ISIN). ISIN access is activating in the Data add-ons section


- `cusip` (string, optional, see notes)
  The CUSIP of an instrument for which data is requested. CUSIP access is activating in the Data add-ons section


- `exchange` (string, optional)
  Exchange where instrument is traded, e.g., `Nasdaq`, `NSE`


- `mic_code` (string, optional)
  Market Identifier Code (MIC) under ISO 10383 standard


- `country` (string, optional)
  Country where instrument is traded, e.g., United States or US.


**Notes:**

 - At least one of the following parameters is required: `symbol`, `figi`, `isin`, `cusip`.

## Response

- `meta` (object)
  Metadata about the instrument
  - `symbol` (string)
    Ticker symbol of instrument
  - `name` (string)
    Name of the company
  - `currency` (string)
    Currency of the instrument according to the ISO 4217 standard
  - `exchange` (string)
    Exchange where instrument is traded
  - `mic_code` (string)
    Market identifier code (MIC) under ISO 10383 standard
  - `exchange_timezone` (string)
    Timezone of the exchange

- `insider_transactions` (array of object)
  List of insider transactions
  - `full_name` (string)
    Full name of an individual, including first name, middle name, last name, and suffix
  - `position` (string)
    Job position of insider
  - `date_reported` (string)
    Date the transaction was reported
  - `is_direct` (boolean)
    `true` if direct, `false` if indirect
  - `shares` (integer)
    As per report the number of shares acquired or disposed of the transaction
  - `value` (integer)
    Represents the value of transaction, calculated as price multiplied by the volume
  - `description` (string)
    Exact price or price range of the transaction if available


## Example Request

```bash
curl "https://api.twelvedata.com/insider_transactions?symbol=AAPL&apikey=demo"
```

## Example Response

```json
{
    "meta": {
        "symbol": "AAPL",
        "name": "Apple Inc",
        "currency": "USD",
        "exchange": "NASDAQ",
        "mic_code": "XNAS",
        "exchange_timezone": "America/New_York"
    },
    "insider_transactions": [
        {
            "full_name": "ADAMS KATHERINE L",
            "position": "General Counsel",
            "date_reported": "2021-05-03",
            "is_direct": true,
            "shares": 17000,
            "value": 2257631,
            "description": "Sale at price 132.57 - 133.93 per share."
        }
    ]
}
```