53 lines
1.6 KiB
Markdown
53 lines
1.6 KiB
Markdown
|
# `openstock order`
|
||
|
|
|
||
|
|
## Purpose
|
||
|
|
|
||
|
|
Place and query live KIS domestic stock orders.
|
||
|
|
|
||
|
|
## Subcommands
|
||
|
|
|
||
|
|
| Command | Purpose |
|
||
|
|
| --- | --- |
|
||
|
|
| `openstock order buy <symbol> --qty QTY (--price PRICE|--market)` | Place a live buy order. |
|
||
|
|
| `openstock order sell <symbol> --qty QTY (--price PRICE|--market)` | Place a live sell order. |
|
||
|
|
| `openstock order status [order_no] [--from YYYYMMDD] [--to YYYYMMDD]` | Query order/execution status. |
|
||
|
|
|
||
|
|
## Safety
|
||
|
|
|
||
|
|
`buy` and `sell` are live financial orders. Do not run them unless the user explicitly asks for a real order in the current task.
|
||
|
|
|
||
|
|
Before placing an order:
|
||
|
|
|
||
|
|
1. Run `openstock account status`.
|
||
|
|
2. Confirm the symbol with `search` or `market`.
|
||
|
|
3. Confirm side, quantity, order type, and price.
|
||
|
|
4. Prefer `order status` for verification after order placement.
|
||
|
|
|
||
|
|
## IO
|
||
|
|
|
||
|
|
| Direction | Data |
|
||
|
|
| --- | --- |
|
||
|
|
| Env read | `KIS_ACCESS_TOKEN`, `KIS_APPKEY`, `KIS_APPSECRET`, `KIS_ACCOUNT` |
|
||
|
|
| External IO | KIS order and order inquiry endpoints. |
|
||
|
|
| Side effect | `buy` and `sell` place live orders. `status` is read-only. |
|
||
|
|
|
||
|
|
## Output Fields
|
||
|
|
|
||
|
|
| Field | Meaning |
|
||
|
|
| --- | --- |
|
||
|
|
| `broker` | Broker used for order. |
|
||
|
|
| `side` | `buy` or `sell`. |
|
||
|
|
| `symbol` | Ordered symbol. |
|
||
|
|
| `qty` | Order quantity. |
|
||
|
|
| `order_type` | `limit` or `market`. |
|
||
|
|
| `price` | Limit price or market-order price representation. |
|
||
|
|
| `order` | Broker order result. |
|
||
|
|
| `account` | Account queried for status. |
|
||
|
|
| `order_no` | Requested order number filter. |
|
||
|
|
| `orders` | Order/execution list. |
|
||
|
|
| `summary` | Broker summary values. |
|
||
|
|
|
||
|
|
## Agent Notes
|
||
|
|
|
||
|
|
For analysis-only tasks, never use `buy` or `sell`. Use `order status` only when order history is relevant.
|