# Lấy giao dịch nội bộ

**API:** Data API

**Endpoint:** `GET /v1/beta/financial/insider-trades`

**Tags:** Financial Data

Truy xuất giao dịch nội bộ của một ticker, dùng limit để giới hạn số kết quả yêu cầu. Hợp đồng này không khai báo bộ lọc tên người, loại giao dịch hoặc ngày nộp.

### Tham chiếu giá

- Đo lường: Cơ sở chi phí cố định theo yêu cầu thành công.
- Ước tính tham chiếu cho mỗi yêu cầu: USD 0.02.
- Hệ số khách hàng tham chiếu: 1.0. Không áp dụng lại cho số tiền khách hàng đã quyết toán.

Chỉ là siêu dữ liệu tham chiếu, không phải báo giá cho tài khoản, mức giá được bảo đảm hay hạn mức chi tiêu. Tín dụng tài nguyên không phải tín dụng Felo. Khoản phí cuối cùng tuân theo bản ghi thanh toán của Felo.

## Base URL

- `https://openapi.felo.ai`

## Authentication

- `FeloBearerAuth` (http bearer, bearer format Felo API Key)
- `FeloApiKey` (apiKey in header `X-API-Key`)

## Parameters

| Name | In | Required | Type | Description |
| --- | --- | --- | --- | --- |
| `limit` | query | no | string |  |
| `ticker` | query | no | string |  |

## Responses

### 200 — Phản hồi giao dịch nội bộ

Headers:
- `X-Request-Id` (string) — Mã định danh yêu cầu cần bao gồm khi liên hệ bộ phận hỗ trợ Felo.

**application/json**

Schema: `ResponseE40Feb4D3D6B_InsiderTradesResponse` (`#/components/schemas/ResponseE40Feb4D3D6B_InsiderTradesResponse`)

### 400 — Không thể xử lý yêu cầu. Hãy kiểm tra các tham số yêu cầu.

### 401 — Cần có khóa API Felo hợp lệ.

### 402 — Không thể tiếp tục yêu cầu vì chưa đáp ứng yêu cầu thanh toán.

### 403 — Tài khoản không được phép thực hiện thao tác này.

### 429 — Đã đạt giới hạn yêu cầu hoặc giới hạn chi tiêu.

### 502 — Dịch vụ không thể hoàn tất yêu cầu.

### 503 — API hoặc dịch vụ thanh toán tạm thời không khả dụng.

### 504 — Dịch vụ đã hết thời gian chờ khi xử lý yêu cầu.

### default — Phản hồi lỗi; phản hồi chuyển tiếp từ thượng nguồn có thể dùng định dạng của nhà cung cấp

**application/json**

Schema:

```json
{}
```

## Schema definitions

### ResponseE40Feb4D3D6B_InsiderTrade

`#/components/schemas/ResponseE40Feb4D3D6B_InsiderTrade`

```json
{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Mã ticker của công ty."
    },
    "issuer": {
      "type": "string",
      "description": "Tên của công ty phát hành."
    },
    "name": {
      "type": "string",
      "description": "Tên của người nội bộ."
    },
    "title": {
      "type": "string",
      "description": "Chức danh của người nội bộ."
    },
    "is_board_director": {
      "type": "boolean",
      "description": "Người nội bộ có phải là thành viên hội đồng quản trị hay không."
    },
    "form_type": {
      "type": "string",
      "description": "Loại biểu mẫu SEC: 4 (báo cáo giao dịch) hoặc 5 (báo cáo thường niên), hoặc bản sửa đổi 4/A, 5/A."
    },
    "filing_date": {
      "type": "string",
      "format": "date",
      "description": "Ngày hồ sơ được SEC chấp nhận."
    },
    "report_period": {
      "type": "string",
      "format": "date",
      "description": "Kỳ báo cáo được khai trên hồ sơ. Với Mẫu 4, đây là ngày của giao dịch sớm nhất được báo cáo và có thể sớm hơn filing_date."
    },
    "transaction_date": {
      "type": "string",
      "format": "date",
      "description": "Ngày của giao dịch."
    },
    "transaction_code": {
      "type": "string",
      "description": "Mã giao dịch theo Mẫu 4 của SEC (ví dụ `P` là mua trên thị trường mở, `S` là bán trên thị trường mở, `M` là thực hiện chứng khoán phái sinh, `F` là cổ phiếu bị giữ lại để trả thuế, `G` là tặng cho). Phân biệt từng phần riêng lẻ của một hồ sơ nhiều phần."
    },
    "transaction_type": {
      "type": "string",
      "description": "Mô tả dễ đọc về giao dịch, được suy ra từ transaction_code."
    },
    "transaction_shares": {
      "type": "number",
      "description": "Số cổ phiếu liên quan đến giao dịch."
    },
    "transaction_price_per_share": {
      "type": "number",
      "description": "Giá trên mỗi cổ phiếu trong giao dịch."
    },
    "transaction_value": {
      "type": "number",
      "description": "Tổng giá trị của giao dịch."
    },
    "shares_owned_before_transaction": {
      "type": "number",
      "description": "Số cổ phiếu sở hữu trước giao dịch."
    },
    "shares_owned_after_transaction": {
      "type": "number",
      "description": "Số cổ phiếu sở hữu sau giao dịch."
    },
    "security_title": {
      "type": "string",
      "description": "Tiêu đề của chứng khoán liên quan đến giao dịch."
    }
  }
}
```

### ResponseE40Feb4D3D6B_InsiderTradesResponse

`#/components/schemas/ResponseE40Feb4D3D6B_InsiderTradesResponse`

```json
{
  "type": "object",
  "properties": {
    "insider_trades": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/ResponseE40Feb4D3D6B_InsiderTrade"
      }
    },
    "next_page_url": {
      "type": "string",
      "description": "URL tuyệt đối của trang kết quả tiếp theo. Chỉ xuất hiện khi còn kết quả; hãy yêu cầu nguyên văn để tiếp tục. Mỗi trang chứa tối đa 10 bản ghi."
    }
  }
}
```
