tenk-cli 0.2.0

10K - CLI for tenk, fetching market data from multiple sources
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293

# tenk-cli

A command-line interface and MCP server for fetching market data from multiple sources.

## Build and Run

```bash
# Build
cargo build --release

# Run
./target/release/tenk --help
```

## MCP Server

Run as MCP server:
```bash
tenk --mcp
```

### Cursor Configuration

```json
{
  "mcpServers": {
    "tenk": {
      "command": "/path/to/tenk",
      "args": ["--mcp"]
    }
  }
}
```

### Available MCP Tools

| Tool | Description |
|------|-------------|
| `stock_quote` | Get current quotes for stocks |
| `stock_kline` | Get historical K-line data |
| `stock_minute` | Get intraday minute data |
| `stock_orderbook` | Get order book |
| `stock_ticks` | Get tick-by-tick trades |
| `stock_info` | Get stock details |
| `stock_list` | List all stock codes |
| `etf_quote` | Get current ETF quotes |
| `etf_kline` | Get ETF K-line data |
| `etf_minute` | Get ETF minute data |
| `etf_list` | List all ETF codes |
| `bond_quote` | Get bond quotes (with top gainers/losers/volume filters) |
| `bond_list` | List convertible bonds |
| `news_list` | Get latest finance news by category |
| `news_read` | Read full news content by ID |
| `capital_flow` | Get real-time capital flow data for stocks |
| `capital_flow_history` | Get historical capital flow data for a stock |
| `billboard_list` | Get Billboard list |
| `billboard_detail` | Get Billboard details for a stock |
| `earnings_forecast` | Get earnings forecast data |
| `stock_connect` | Get Stock Connect data |
| `margin_trading` | Get margin trading data for a stock |
| `ipo_list` | Get IPO list |
| `block_trades` | Get block trade list |
| `institutional_research` | Get institutional research list |
| `research_reports` | Get research reports |

## Usage

```bash
tenk [OPTIONS] <COMMAND>
```

### Global Options

| Option | Description |
|--------|-------------|
| `-f, --format <FORMAT>` | Output format: `json`, `table` (default), `csv` |
| `-o, --output <FILE>` | Save output to file instead of stdout |
| `-s, --source <SOURCE>` | Data sources: `eastmoney`, `sina`, `ths` (default: all) |
| `-L, --lang <LANG>` | Output language: `en` (default), `zh-CN` |
| `--proxy <URL>` | HTTP proxy URL |
| `-v, --verbose` | Enable verbose/debug output |

### Language Support

The CLI supports multiple output languages for table headers, messages, and labels:

```bash
# English output (default)
tenk stock list -l 3

# Chinese output
tenk --lang zh-CN stock list -l 3

# Or use environment variable
export TENK_LANG=zh-CN
tenk stock list -l 3
```

Supported languages:
- `en` - English (default)
- `zh-CN` - Simplified Chinese

## Commands

### Stock Commands

```bash
# Get real-time quotes for stocks
tenk stock quote 600519 300059

# Get daily K-line data
tenk stock kline 600519

# Get weekly K-line for date range
tenk stock kline 600519 -k weekly --start 2025-01-01 --end 2025-01-31

# Get last 10 daily records
tenk stock kline 600519 -l 10

# Get 5-minute K-line data
tenk stock kline 600519 -k min5 -l 20

# Get minute-level data for today
tenk stock minute 600519

# Get order book (5-level bid/ask)
tenk stock orderbook 600519

# Get tick data (last 50 ticks)
tenk stock ticks 600519 -l 50

# Get stock information
tenk stock info 600519

# Get stock valuation metrics (PE, PB, Market Cap, EPS, ROE, etc.)
tenk stock valuation 600519

# Get top 10 shareholders
tenk stock holders 600519

# Get fund holdings
tenk stock funds 600519 -l 10

# Get dividend history
tenk stock dividend 600519

# List all stocks
tenk stock list -l 20

# List stocks by exchange
tenk stock list -e sh -l 10
tenk stock list -e sz -l 10
```

### ETF Commands

```bash
# Get real-time ETF quotes
tenk etf quote 510300 159915

# Get ETF K-line data
tenk etf kline 510300

# Get ETF K-line for date range
tenk etf kline 510300 --start 2025-01-01 --end 2025-01-31

# Get ETF minute data
tenk etf minute 510300

# List all ETFs
tenk etf list -l 20

# List ETFs by exchange
tenk etf list -e sh -l 10
```

### Bond Commands

```bash
# Get all convertible bond quotes
tenk bond quote

# Get specific bond quotes
tenk bond quote 127046 113050

# Get top 10 gainers
tenk bond quote --top-gainers 10

# Get top 10 losers
tenk bond quote --top-losers 10

# Get top 10 by volume
tenk bond quote --top-volume 10

# List all convertible bonds
tenk bond list -l 20
```

### Market Commands

```bash
# Get real-time capital flow for stocks
tenk market flow 600519 300059

# Get historical capital flow for a stock
tenk market flow-history 600519 -l 30

# Get Billboard list (defaults to today)
tenk market billboard

# Get Billboard list for specific date
tenk market billboard -d 2026-01-16

# Get Billboard details for a stock
tenk market billboard-detail 600519 -d 2026-01-16

# Get earnings forecast
tenk market forecast -l 10

# Get earnings forecast for specific period
tenk market forecast -r 2024-12-31 -l 20

# Get Stock Connect data
tenk market connect -l 30

# Get margin trading data for a stock
tenk market margin 600519 -l 30

# Get IPO list
tenk market ipo -l 10

# Get block trade list
tenk market block -l 10

# Get institutional research list
tenk market research -l 10

# Get research reports
tenk market report -l 10

# Get research reports for a specific stock
tenk market report -c 600519 -l 10
```

### News Commands

```bash
# Get latest finance news
tenk news list

# Get news by category
tenk news list -c company -l 20

# Search news by keyword
tenk news search 600519 -l 10

# Read full news content
tenk news read 202601153620739638
```

### Output Formats

```bash
# Table output (default) - pretty formatted
tenk stock quote 600519

# JSON output - for scripting
tenk stock quote 600519 -f json

# CSV output - for spreadsheets
tenk stock quote 600519 -f csv > quotes.csv

# Save output to file
tenk stock quote 600519 -f json -o quotes.json
tenk stock kline 600519 -l 30 -o kline_data.csv -f csv
```

### Select Data Source

```bash
# Use only EastMoney source
tenk -s eastmoney stock quote 600519

# Use only Sina source
tenk -s sina stock quote 600519

# Use THS then Sina as fallback
tenk -s ths -s sina stock quote 600519
```

## License

MIT