> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tickdb.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 股票信息

> 獲取股票的詳細信息，包括公司名稱、行業分類、市值等基本面數據。

## 注意事項

* 返回的信息可能因數據源而異

## 支持的市場

**美股**、**港股**、**A股**

示例：

* 美股：AAPL.US、TSLA.US、MSFT.US
* 港股：700.HK、9988.HK、3690.HK
* A股：000001.SH、000001.SZ

## 請求參數

| 參數名     | 是否必須 | 描述                                                                                             |
| ------- | ---- | ---------------------------------------------------------------------------------------------- |
| symbols | 是    | 股票代碼，多個用逗號分隔，最多50個                                                                             |
| type    | 否    | 產品類型，可選。代碼無歧義時無需傳遞；若返回 `AMBIGUOUS_SYMBOL` 錯誤，按提示傳入對應值即可。可選值：`stock`、`indices`、`crypto`、`forex` |

## 返回字段說明

| 字段                  | 說明                           |
| ------------------- | ---------------------------- |
| symbol              | 交易產品                         |
| name\_cn            | 中文簡體標的名稱                     |
| name\_en            | 英文標的名稱                       |
| name\_hk            | 中文繁體標的名稱                     |
| exchange            | 標的所屬交易所                      |
| currency            | 交易幣種（CNY/USD/HKD）            |
| lot\_size           | 每手股數                         |
| total\_shares       | 總股本                          |
| circulating\_shares | 流通股本                         |
| hk\_shares          | 港股股本（僅港股）                    |
| eps                 | 每股盈利                         |
| eps\_ttm            | 每股盈利（TTM）                    |
| bps                 | 每股淨資產                        |
| dividend\_yield     | 股息（如果標的的股息是按年度計算，可提供的年度計算類型） |
| stock\_derivatives  | 可選值：1 - 期權，2 - 輪證            |


## OpenAPI

````yaml GET /v1/market/stock-info
openapi: 3.0.0
info:
  title: TickDB API
  description: >-
    Unified real-time market data API — one connection for Forex, indices, US
    stocks, HK stocks, A-shares, and Crypto via REST and WebSocket.
  version: 1.0.1
  contact:
    email: support@tickdb.ai
servers:
  - url: https://api.tickdb.ai
    description: Production server
security:
  - ApiKeyAuth: []
paths:
  /v1/market/stock-info:
    get:
      summary: Stock Information
      description: Get detailed information for stocks
      parameters:
        - name: symbols
          in: query
          required: true
          description: Comma-separated stock symbols (max 50)
          schema:
            type: string
            default: 700.HK,AAPL.US,000001.SZ
            example: 700.HK,AAPL.US,000001.SZ
        - name: type
          in: query
          required: false
          description: >-
            Symbol type, optional. Not required when the symbol is unambiguous;
            if the API returns an AMBIGUOUS_SYMBOL error, pass the value as
            indicated
          schema:
            type: string
            enum:
              - stock
              - indices
              - crypto
              - forex
            example: stock
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: integer
                    example: 0
                  message:
                    type: string
                    example: success
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        symbol:
                          type: string
                        name_cn:
                          type: string
                        name_en:
                          type: string
                        name_hk:
                          type: string
                        exchange:
                          type: string
                        currency:
                          type: string
                        lot_size:
                          type: integer
                        total_shares:
                          type: integer
                        circulating_shares:
                          type: integer
                        hk_shares:
                          type: integer
                        eps:
                          type: string
                        eps_ttm:
                          type: string
                        bps:
                          type: string
                        dividend_yield:
                          type: string
                        stock_derivatives:
                          type: array
                          items:
                            type: integer
                    example:
                      - symbol: 700.HK
                        name_cn: 腾讯控股
                        name_en: TENCENT
                        name_hk: 騰訊控股
                        exchange: SEHK
                        currency: HKD
                        lot_size: 100
                        total_shares: 9106356125
                        circulating_shares: 9106356125
                        hk_shares: 9106356125
                        eps: '23.013927604754377'
                        eps_ttm: '26.2097750997138276'
                        bps: '140.9780051897266427'
                        dividend_yield: '4.5408485490127919'
                        stock_derivatives:
                          - 2
                      - symbol: AAPL.US
                        name_cn: 苹果
                        name_en: Apple Inc.
                        name_hk: 蘋果
                        exchange: NASD
                        currency: USD
                        lot_size: 1
                        total_shares: 14681140000
                        circulating_shares: 14656175336
                        eps: '7.6295165089359546'
                        eps_ttm: '8.0223334155249524'
                        bps: '6.0070267022860623'
                        dividend_yield: '1.04'
                        stock_derivatives:
                          - 1
                      - symbol: 000001.SZ
                        name_cn: 平安银行
                        name_en: PAB
                        name_hk: 平安銀行
                        exchange: SZSE
                        currency: CNY
                        lot_size: 100
                        total_shares: 19405918198
                        circulating_shares: 19405762053
                        eps: '2.146707'
                        eps_ttm: '2.2218995030311835'
                        bps: '23.0845557231179667'
                        dividend_yield: '0.5980134452589843'
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key

````