# 盈虧分析明細

`GET` `/v1/portfolio/profit-analysis/detail`

獲取指定證券的詳細盈虧分析，包含交易流水和成本分解。

## Parameters

### Query Parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `symbol` | string | Yes | 證券代碼，例如 `AAPL.US` |
| `start` | string | No | 開始日期，格式 `YYYY-MM-DD` |
| `end` | string | No | 結束日期，格式 `YYYY-MM-DD` |

## Request Example

```bash
curl --request GET \
  --url 'https://openapi.longbridge.com/v1/portfolio/profit-analysis/detail?symbol=<symbol>' \
  --header 'Authorization: Bearer <access_token>'
```

## Response

### Response Properties

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `profit` | string | No | 總盈虧 |
| `underlying_details` | object | No | 正股盈虧明細 |
| `└ holding_value` | string | No | 當前持倉市值 |
| `└ profit` | string | No | 總盈虧 |
| `└ cumulative_credited_amount` | string | No | 累計入賬金額 |
| `└ credited_details` | array | No | 入賬明細 |
| `└ cumulative_debited_amount` | string | No | 累計出賬金額 |
| `└ debited_details` | array | No | 出賬明細 |
| `└ cumulative_fee_amount` | string | No | 累計費用金額 |
| `└ fee_details` | array | No | 費用明細 |
| `└ short_holding_value` | string | No | 空頭持倉市值 |
| `└ long_holding_value` | string | No | 多頭持倉市值 |
| `└ holding_value_at_beginning` | string | No | 期初持倉市值 |
| `└ holding_value_at_ending` | string | No | 期末持倉市值 |
| `derivative_pnl_details` | object | No | 衍生品盈虧明細 |
| `└ holding_value` | string | No | 當前持倉市值 |
| `└ profit` | string | No | 總盈虧 |
| `└ cumulative_credited_amount` | string | No | 累計入賬金額 |
| `└ credited_details` | array | No | 入賬明細 |
| `└ cumulative_debited_amount` | string | No | 累計出賬金額 |
| `└ debited_details` | array | No | 出賬明細 |
| `└ cumulative_fee_amount` | string | No | 累計費用金額 |
| `└ fee_details` | array | No | 費用明細 |
| `└ short_holding_value` | string | No | 空頭持倉市值 |
| `└ long_holding_value` | string | No | 多頭持倉市值 |
| `└ holding_value_at_beginning` | string | No | 期初持倉市值 |
| `└ holding_value_at_ending` | string | No | 期末持倉市值 |
| `name` | string | No | 標的名稱。 |
| `updated_at` | string | No | 最後更新時間 |
| `default_tag` | integer | No | 默認顯示標簽 |
| `currency` | string | No | 貨幣 |
| `start` | string | No | 統計期開始 |
| `end` | string | No | 統計期結束 |
| `start_date` | string | No | 開始日期 |
| `end_date` | string | No | 結束日期 |
| `updated_date` | string | No | 最後更新日期 |

### Response JSON Example

```json
{
  "code": 0,
  "message": "success",
  "data": {
    "name": "Apple",
    "currency": "USD",
    "profit": "100.00",
    "start": "1763769600",
    "end": "1778724973",
    "start_date": "2025-11-22",
    "end_date": "2026-05-14",
    "default_tag": 0,
    "updated_at": "1778724973",
    "updated_date": "2026-05-14",
    "underlying_details": {
      "profit": "100.00",
      "holding_value": "1790.16",
      "holding_value_at_beginning": null,
      "holding_value_at_ending": "1790.16",
      "long_holding_value": "1790.16",
      "short_holding_value": "0.00",
      "cumulative_credited_amount": "0.00",
      "cumulative_debited_amount": "0.00",
      "cumulative_fee_amount": "0.00",
      "credited_details": [],
      "debited_details": [],
      "fee_details": []
    },
    "derivative_pnl_details": {
      "profit": "0.00",
      "holding_value": "0.00",
      "holding_value_at_beginning": null,
      "holding_value_at_ending": "0.00",
      "long_holding_value": "0.00",
      "short_holding_value": "0.00",
      "cumulative_credited_amount": "0.00",
      "cumulative_debited_amount": "0.00",
      "cumulative_fee_amount": "0.00",
      "credited_details": [],
      "debited_details": [],
      "fee_details": []
    }
  }
}
```
