> ## 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 股、港股、美股） | ✅ |
| 企业版 | ✅ |

## 注意事项

* 单次最多查询 500 个股票代码。
* 返回字段会因市场和个股的数据情况而异；条件字段没有可用数据时不会返回。

## 支持的市场

| 市场 | 示例 |
| - | - |
| 美股 | AAPL.US, TSLA.US, MSFT.US |
| 港股 | 700.HK, 9988.HK, 3690.HK |
| A股 | 600519.SH, 000001.SZ, 300750.SZ |

## 请求参数

| 参数名 | 是否必须 | 描述 |
| - | - | - |
| symbols | 是 | 股票代码，多个用逗号分隔，最多 500 个 |
| 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 | H股股本；港股及同时发行H股的A股公司返回 |
| eps | 每股收益；数据可用时返回 |
| eps\_ttm | 最近十二个月每股收益；港股、美股数据可用时返回 |
| bps | 每股净资产；数据可用时返回 |
| dividend\_yield | 股息率；港股、美股数据可用时返回 |
| stock\_derivatives | 支持的衍生品类型数组；`1` 表示期权，`2` 表示轮证，港股、美股数据可用时返回 |
| board | A股所属板块或证券分类代码；A股返回 |


## OpenAPI

````yaml openapi.yaml GET /v1/market/stock-info
openapi: 3.1.0
info:
  title: TickDB API
  description: TickDB 统一实时行情数据 API，提供 REST 和 WebSocket 接入。
  version: 1.0.3
  contact:
    email: support@tickdb.ai
servers:
  - url: https://api.tickdb.ai
    description: 生产环境
security:
  - ApiKeyAuth: []
paths:
  /v1/market/stock-info:
    get:
      summary: 股票信息
      description: 获取股票名称、交易所、币种、股本和每股指标等基础信息。
      parameters:
        - name: symbols
          in: query
          required: true
          description: 股票代码，多个用逗号分隔，最多 500 个
          schema:
            type: string
            default: 700.HK,AAPL.US,000001.SZ
            example: 700.HK,AAPL.US,000001.SZ
        - name: type
          in: query
          required: false
          description: >-
            产品类型，可选。代码无歧义时无需传递；若返回 `AMBIGUOUS_SYMBOL`
            错误，按提示传入对应值即可。可选值：`stock`、`indices`、`crypto`、`forex`
          schema:
            type: string
            enum:
              - stock
              - indices
              - crypto
              - forex
            example: stock
      responses:
        '200':
          description: 请求成功。
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: integer
                    example: 0
                  message:
                    type: string
                    example: success
                  data:
                    type: array
                    items:
                      type: object
                      required:
                        - symbol
                        - name_cn
                        - exchange
                        - currency
                        - lot_size
                      additionalProperties: false
                      properties:
                        symbol:
                          type: string
                          description: 交易产品
                        name_cn:
                          type: string
                          description: 中文简体标的名称
                        name_en:
                          type: string
                          description: 英文标的名称；港股、美股返回
                        name_hk:
                          type: string
                          description: 中文繁体标的名称；港股、美股返回
                        exchange:
                          type: string
                          description: 标的所属交易所
                        currency:
                          type: string
                          description: 交易币种（CNY/USD/HKD）
                        lot_size:
                          type: integer
                          description: 每手股数
                        total_shares:
                          type: integer
                          description: 总股本；数据可用时返回
                        circulating_shares:
                          type: integer
                          description: 流通股本；数据可用时返回
                        hk_shares:
                          type: integer
                          description: H股股本；港股及同时发行H股的A股公司返回
                        eps:
                          type: string
                          description: 每股收益；数据可用时返回
                        eps_ttm:
                          type: string
                          description: 最近十二个月每股收益；港股、美股数据可用时返回
                        bps:
                          type: string
                          description: 每股净资产；数据可用时返回
                        dividend_yield:
                          type: string
                          description: 股息率；港股、美股数据可用时返回
                        stock_derivatives:
                          type: array
                          description: 支持的衍生品类型数组；`1` 表示期权，`2` 表示轮证，港股、美股数据可用时返回
                          items:
                            type: integer
                            enum:
                              - 1
                              - 2
                        board:
                          type: string
                          description: A股所属板块或证券分类代码；A股返回
                    example:
                      - symbol: 700.HK
                        name_cn: 腾讯控股
                        name_en: TENCENT
                        name_hk: 騰訊控股
                        exchange: SEHK
                        currency: HKD
                        lot_size: 100
                        total_shares: 9095085993
                        circulating_shares: 9095085993
                        hk_shares: 9095085993
                        eps: '27.3701441378468889'
                        eps_ttm: '29.8128867314657505'
                        bps: '143.787288892927458'
                        dividend_yield: '5.3133478570728672'
                        stock_derivatives:
                          - 2
                      - symbol: AAPL.US
                        name_cn: 苹果
                        name_en: Apple
                        name_hk: 蘋果
                        exchange: NASD
                        currency: USD
                        lot_size: 1
                        total_shares: 14594180000
                        circulating_shares: 14569121909
                        eps: '7.6749772854658501'
                        eps_ttm: '8.8343435533890907'
                        bps: '7.3673203975831462'
                        dividend_yield: '1.06'
                        stock_derivatives:
                          - 1
                      - symbol: 000001.SZ
                        name_cn: 平安银行
                        exchange: SZ
                        currency: CNY
                        lot_size: 100
                        total_shares: 19405918198
                        circulating_shares: 19405684991
                        eps: '1.24'
                        bps: '24.13'
                        board: sz_stock
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.