# longbridge kline

取得任意標的的 K 線數據，支援多種週期和歷史日期範圍。

<QuotePermission command="kline" />

## 配額說明

歷史 K 線數據的訪問按帳戶等級配額，每個帳戶每月可查詢的標的數量有上限。配額按自然月計算，每月初重置，上月剩餘額度不累計。同一自然月內重複查詢同一標的，僅統計一次。

新入金帳戶的配額在下個交易日生效；當總資產或月交易筆數達到更高等級時，新配額在下一個交易日生效。

**總資產**：港股、美股、A 股等證券帳戶的總資產，按匯率換算為港元。取上個自然月最後一個交易日的總資產與最近一個完整交易日的總資產的較大值。

**月交易筆數**：有成交的訂單數量（部分成交、多次成交或一次全部成交均算 1 筆）。取上個自然月與當前自然月成交筆數的較大值。

| 帳戶等級 | 每月可查詢標的數量（只）|
|---|---|
| 用戶開戶 | 100 |
| 總資產達 1 萬 HKD | 400 |
| 總資產達 8 萬 HKD | 600 |
| 總資產達 40 萬 HKD 或月交易筆數 > 160 筆 | 1,000 |
| 總資產達 400 萬 HKD 或月交易筆數 > 1,600 筆 | 2,000 |
| 總資產達 600 萬 HKD 或月交易筆數 > 2,500 筆 | 3,000 |

## 基本用法

```bash
longbridge kline TSLA.US --period day --count 3
```

```
| Time                | Open    | High    | Low     | Close   | Volume   | Turnover        |
|---------------------|---------|---------|---------|---------|----------|-----------------|
| 2026-04-07 04:00:00 | 346.440 | 348.020 | 337.240 | 346.650 | 74515355 | 25563965746.000 |
| 2026-04-08 04:00:00 | 363.790 | 364.500 | 339.670 | 343.250 | 78838616 | 27457043487.000 |
| 2026-04-09 04:00:00 | 343.150 | 348.880 | 337.250 | 345.620 | 62164016 | 21375312140.000 |
```

## 示例

### 日線（最近 100 天，默認）

```bash
longbridge kline TSLA.US
```

默認返回最近 100 根日線，每根包含開盤價、最高價、最低價、收盤價、成交量和成交額。

### 不同週期的分時 K 線

```bash
longbridge kline TSLA.US --period 1h --count 48
```

使用 `--period` 切換粒度（如 `1m`、`5m`、`15m`、`30m`、`1h`、`day`、`week`、`month`、`year`），用 `--count` 控制返回的 K 線條數。

### 歷史日期範圍

```bash
longbridge kline history TSLA.US --period day --start 2025-01-01 --end 2025-03-31
longbridge kline history TSLA.US --period day --start 2025-01-01 --end 2025-03-31 --format json
```

使用 `history` 子命令配合 `--start` 和 `--end`（格式：`YYYY-MM-DD`）取得指定日期窗口的 K 線。`--adjust forward` 可取得前復權價格。JSON 輸出中的 `time` 欄位表示 K 線開盤時間——美股日線以 UTC 時間表示美東時間零點。