# 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 时间表示美东时间零点。