> For the complete documentation index, see [llms.txt](https://doc.itick.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.itick.org/apis/stock.md).

# Stock

## GET /stock/base

> Product Query

```json
{"openapi":"3.0.1","info":{"title":"Default module","version":"1.0.0"},"tags":[{"name":"Stock"}],"servers":[{"url":"https://api.itick.org","description":"正式环境"}],"security":[],"paths":{"/stock/base":{"get":{"summary":"Product Query","deprecated":false,"description":"","tags":["Stock"],"parameters":[{"name":"region","in":"query","description":"Market","required":true,"schema":{"type":"string"}},{"name":"code","in":"query","description":"Code","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","description":"Response Code, 0: Success"},"msg":{"type":"string","description":"Exception Information, exists when not equal to 0"},"data":{"$ref":"#/components/schemas/Base","description":"Response Data"}},"required":["code","msg","data"]}}},"headers":{}}}}}},"components":{"schemas":{"Base":{"type":"object","properties":{"s":{"type":"string","description":"Product Code"},"nc":{"type":"string","description":"Simplified Chinese Underlying Name"},"ne":{"type":"string","description":"English Underlying Name"},"nh":{"type":"string","description":"Traditional Chinese Underlying Name"},"e":{"type":"string","description":"Exchange of the Underlying Asset"},"c":{"type":"string","description":"Trading Currency"},"l":{"type":"integer","description":"Shares per Lot"},"t":{"type":"integer","description":"Total Share Capital"},"cs":{"type":"integer","description":"Circulating Share Capital"},"hs":{"type":"integer","description":"Hong Kong Stock Capital (Only Hong Kong Stocks)"},"ep":{"type":"integer","description":"Earnings Per Share"},"ept":{"type":"integer","description":"Earnings Per Share (TTM)"},"bps":{"type":"integer","description":"Net Asset Value Per Share"},"dy":{"type":"integer","description":"Dividends"},"b":{"type":"string","description":"Sector of the Underlying Asset"},"sd":{"type":"string","description":"If the underlying asset is a stock, the available types of derivative market data are: 1 - Options; 2 - Warrants"}},"required":["s","nc","ne","nh","e","c","l","t","cs","hs","ep","ept","bps","dy","b","sd"]}}}}
```

## GET /stock/tick

> Real-time Transaction

```json
{"openapi":"3.0.1","info":{"title":"Default module","version":"1.0.0"},"tags":[{"name":"Stock"}],"servers":[{"url":"https://api.itick.org","description":"正式环境"}],"security":[],"paths":{"/stock/tick":{"get":{"summary":"Real-time Transaction","deprecated":false,"description":"","tags":["Stock"],"parameters":[{"name":"region","in":"query","description":"Market Code","required":true,"schema":{"type":"string"}},{"name":"code","in":"query","description":"Product Code","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","description":"Response Code, 0: Success"},"msg":{"type":"string","description":"Exception Information, exists when not equal to 0"},"data":{"description":"Response Data","$ref":"#/components/schemas/Tick"}},"required":["code","msg","data"]}}},"headers":{}}}}}},"components":{"schemas":{"Tick":{"type":"object","properties":{"s":{"type":"string","description":"Symbol Code"},"ld":{"type":"integer","description":"Latest Price"},"t":{"type":"integer","description":"Timestamp of the Latest Transaction"},"v":{"type":"number","description":"Transaction Volume"},"tu":{"type":"number","description":"Transaction Amount"},"ts":{"type":"integer","description":"Trading Status of the Asset"}},"required":["s","ld","t","v","tu","ts"],"description":"Tick"}}}}
```

## GET /stock/depth

> Real-time Order Book

```json
{"openapi":"3.0.1","info":{"title":"Default module","version":"1.0.0"},"tags":[{"name":"Stock"}],"servers":[{"url":"https://api.itick.org","description":"正式环境"}],"security":[],"paths":{"/stock/depth":{"get":{"summary":"Real-time Order Book","deprecated":false,"description":"","tags":["Stock"],"parameters":[{"name":"region","in":"query","description":"Market Code","required":true,"schema":{"type":"string"}},{"name":"code","in":"query","description":"Product Code","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","description":"Response Code, 0: Success"},"msg":{"type":"string","description":"Exception Information, exists when not equal to 0"},"data":{"description":"Response Data","$ref":"#/components/schemas/Depth"}},"required":["code","msg","data"]}}},"headers":{}}}}}},"components":{"schemas":{"Depth":{"type":"object","properties":{"s":{"type":"string","description":"Underlying Code"},"a":{"type":"array","items":{"type":"object","properties":{"po":{"type":"integer","description":"Level"},"p":{"type":"number","description":"Price"},"v":{"type":"number","description":"Order Volume"},"o":{"type":"number","description":"Order Quantity"}},"required":["po","p","v","o"]},"description":"Sell Side"},"b":{"type":"array","items":{"type":"object","properties":{"po":{"type":"integer","description":"Level"},"p":{"type":"number","description":"Price"},"v":{"type":"number","description":"Order Volume"},"o":{"type":"number","description":"Order Quantity"}},"required":["po","p","v","o"]},"description":"Buy Side"}},"required":["s","a","b"]}}}}
```

## GET /stock/kline

> Candlestick Query

```json
{"openapi":"3.0.1","info":{"title":"Default module","version":"1.0.0"},"tags":[{"name":"Stock"}],"servers":[{"url":"https://api.itick.org","description":"正式环境"}],"security":[],"paths":{"/stock/kline":{"get":{"summary":"Candlestick Query","deprecated":false,"description":"","tags":["Stock"],"parameters":[{"name":"region","in":"query","description":"Market Code","required":true,"schema":{"type":"string"}},{"name":"code","in":"query","description":"Product Code","required":true,"schema":{"type":"string"}},{"name":"kType","in":"query","description":"Cycle 1 minute, 2 five minutes, 3 ten minutes, 4 thirty minutes, 5 one hour, 6 two hours, 7 four hours, 8 one day, 9 one week, 10 one month","required":true,"schema":{"type":"string"}},{"name":"et","in":"query","description":"Query deadline","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","description":"Query number","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","description":"Response Code, 0: Success"},"msg":{"type":"string","description":"Exception Information, exists when not equal to 0"},"data":{"type":"array","items":{"$ref":"#/components/schemas/Kline"},"description":"Response Data"}},"required":["code","msg","data"]}}},"headers":{}}}}}},"components":{"schemas":{"Kline":{"type":"object","properties":{"tu":{"type":"number","description":"Transaction Amount"},"c":{"type":"number","description":"Closing Price of the Candlestick"},"t":{"type":"integer","description":"Timestamp"},"v":{"type":"integer","description":"Transaction Volume"},"h":{"type":"number","description":"Highest Price of the Candlestick"},"l":{"type":"number","description":"Lowest Price of the Candlestick"},"o":{"type":"number","description":"Opening Price of the Candlestick"}}}}}}
```

## GET /stock/quote

> Real-time Quotation

```json
{"openapi":"3.0.1","info":{"title":"Default module","version":"1.0.0"},"tags":[{"name":"Stock"}],"servers":[{"url":"https://api.itick.org","description":"正式环境"}],"security":[],"paths":{"/stock/quote":{"get":{"summary":"Real-time Quotation","deprecated":false,"description":"","tags":["Stock"],"parameters":[{"name":"region","in":"query","description":"Market Code","required":true,"schema":{"type":"string"}},{"name":"code","in":"query","description":"Product Code","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","description":"Response Code, 0: Success"},"msg":{"type":"string","description":"Exception Information, exists when not equal to 0"},"data":{"description":"Response Data","$ref":"#/components/schemas/Tick"}},"required":["code","msg","data"]}}},"headers":{}}}}}},"components":{"schemas":{"Tick":{"type":"object","properties":{"s":{"type":"string","description":"Symbol Code"},"ld":{"type":"integer","description":"Latest Price"},"t":{"type":"integer","description":"Timestamp of the Latest Transaction"},"v":{"type":"number","description":"Transaction Volume"},"tu":{"type":"number","description":"Transaction Amount"},"ts":{"type":"integer","description":"Trading Status of the Asset"}},"required":["s","ld","t","v","tu","ts"],"description":"Tick"}}}}
```

## GET /stock/klines

> Batch Candlestick Query

```json
{"openapi":"3.0.1","info":{"title":"Default module","version":"1.0.0"},"tags":[{"name":"Stock"}],"servers":[{"url":"https://api.itick.org","description":"正式环境"}],"security":[],"paths":{"/stock/klines":{"get":{"summary":"Batch Candlestick Query","deprecated":false,"description":"","tags":["Stock"],"parameters":[{"name":"region","in":"query","description":"Market Code","required":true,"schema":{"type":"string"}},{"name":"codes","in":"query","description":"Product Code","required":true,"schema":{"type":"string"}},{"name":"kType","in":"query","description":"Cycle 1 minute, 2 five minutes, 3 ten minutes, 4 thirty minutes, 5 one hour, 6 two hours, 7 four hours, 8 one day, 9 one week, 10 one month","required":true,"schema":{"type":"string"}},{"name":"et","in":"query","description":"Query deadline","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","description":"Query number","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","description":"Response Code 0: Success"},"msg":{"type":"string","description":"Exception Information exists when not equal to 0"},"data":{"type":"object","properties":{"code":{"type":"array","items":{"$ref":"#/components/schemas/Kline"}}},"description":"Response Data","required":["code"]}},"required":["code","data","msg"],"description":"Return Result"}}},"headers":{}}}}}},"components":{"schemas":{"Kline":{"type":"object","properties":{"tu":{"type":"number","description":"Transaction Amount"},"c":{"type":"number","description":"Closing Price of the Candlestick"},"t":{"type":"integer","description":"Timestamp"},"v":{"type":"integer","description":"Transaction Volume"},"h":{"type":"number","description":"Highest Price of the Candlestick"},"l":{"type":"number","description":"Lowest Price of the Candlestick"},"o":{"type":"number","description":"Opening Price of the Candlestick"}}}}}}
```

## GET /stock/ticks

> Batch Real-time Transactions

```json
{"openapi":"3.0.1","info":{"title":"Default module","version":"1.0.0"},"tags":[{"name":"Stock"}],"servers":[{"url":"https://api.itick.org","description":"正式环境"}],"security":[],"paths":{"/stock/ticks":{"get":{"summary":"Batch Real-time Transactions","deprecated":false,"description":"","tags":["Stock"],"parameters":[{"name":"region","in":"query","description":"Market Code","required":true,"schema":{"type":"string"}},{"name":"codes","in":"query","description":"Product Code","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","description":"Response Code, 0: Success"},"msg":{"type":"string","description":"Exception Information, exists when not equal to 0"},"data":{"type":"object","properties":{"s":{"type":"string","description":"Symbol Code"},"ld":{"type":"integer","description":"Latest Price"},"t":{"type":"integer","description":"Timestamp of the Latest Transaction"},"v":{"type":"number","description":"Transaction Volume"},"tu":{"type":"number","description":"Transaction Amount"},"ts":{"type":"integer","description":"Trading Status of the Asset"}},"required":["s","ld","t","v","tu","ts"],"description":"Response Data"}},"required":["code","msg","data"],"description":"Return Result"}}},"headers":{}}}}}}}
```

## GET /stock/quotes

> Batch Real-time Quotation

```json
{"openapi":"3.0.1","info":{"title":"Default module","version":"1.0.0"},"tags":[{"name":"Stock"}],"servers":[{"url":"https://api.itick.org","description":"正式环境"}],"security":[],"paths":{"/stock/quotes":{"get":{"summary":"Batch Real-time Quotation","deprecated":false,"description":"","tags":["Stock"],"parameters":[{"name":"region","in":"query","description":"Market Code","required":true,"schema":{"type":"string"}},{"name":"codes","in":"query","description":"Product Code","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","description":"Response Code, 0: Success"},"msg":{"type":"string","description":"Exception Information, exists when not equal to 0"},"data":{"type":"object","properties":{"s":{"type":"string","description":"Symbol Code"},"ld":{"type":"integer","description":"Latest Price"},"t":{"type":"integer","description":"Timestamp of the Latest Transaction"},"v":{"type":"number","description":"Transaction Volume"},"tu":{"type":"number","description":"Transaction Amount"},"ts":{"type":"integer","description":"Trading Status of the Asset"}},"required":["s","ld","t","v","tu","ts"],"description":"Response Data"}},"required":["code","msg","data"],"description":"Return Result"}}},"headers":{}}}}}}}
```

## GET /stock/depths

> Batch Real-time Order Book

```json
{"openapi":"3.0.1","info":{"title":"Default module","version":"1.0.0"},"tags":[{"name":"Stock"}],"servers":[{"url":"https://api.itick.org","description":"正式环境"}],"security":[],"paths":{"/stock/depths":{"get":{"summary":"Batch Real-time Order Book","deprecated":false,"description":"","tags":["Stock"],"parameters":[{"name":"region","in":"query","description":"Market Code","required":true,"schema":{"type":"string"}},{"name":"codes","in":"query","description":"Product Code","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","description":"Response Code, 0: Success"},"msg":{"type":"string","description":"Exception Information, exists when not equal to 0"},"data":{"description":"Response Data","$ref":"#/components/schemas/Depth"}},"required":["code","msg","data"]}}},"headers":{}}}}}},"components":{"schemas":{"Depth":{"type":"object","properties":{"s":{"type":"string","description":"Underlying Code"},"a":{"type":"array","items":{"type":"object","properties":{"po":{"type":"integer","description":"Level"},"p":{"type":"number","description":"Price"},"v":{"type":"number","description":"Order Volume"},"o":{"type":"number","description":"Order Quantity"}},"required":["po","p","v","o"]},"description":"Sell Side"},"b":{"type":"array","items":{"type":"object","properties":{"po":{"type":"integer","description":"Level"},"p":{"type":"number","description":"Price"},"v":{"type":"number","description":"Order Volume"},"o":{"type":"number","description":"Order Quantity"}},"required":["po","p","v","o"]},"description":"Buy Side"}},"required":["s","a","b"]}}}}
```