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

# Stock codes

# 股票代码体系

了解A股市场的股票代码体系对于正确使用AlphaFinance API至关重要。本文档将帮助您理解A股市场的股票代码规则和我们API中的代码使用方式。

## A股股票代码规则

A股市场（中国内地股票市场）的股票代码由6位数字组成，不同交易所的股票代码有不同的规则：

### 上海证券交易所（SSE）

* **60开头**：主板
* **688开头**：科创板
* **900开头**：B股（以美元交易）

### 深圳证券交易所（SZSE）

* **000开头**：主板
* **002开头**：中小板（已与主板合并，但代码保留）
* **003开头**：主板（新增）
* **300开头**：创业板
* **200开头**：B股（以港元交易）

### 北京证券交易所（BSE）

* **8开头**：北交所上市公司（如 830978）

## 在AlphaFinance API中使用股票代码

在使用我们的API时，您有多种方式指定股票：

### 1. 原始代码

直接使用6位数字代码，例如：

```bash theme={null}
curl -X GET "https://api.alphafin.x-pai.com/v1/stock/basic-info?symbol=600519" \
  -H "X-API-KEY: your_api_key_here"
```

### 2. 带市场前缀的代码

您也可以使用带交易所前缀的代码，格式为 `{交易所}.{代码}`：

* **sh.600519** - 上海交易所的贵州茅台
* **sz.000858** - 深圳交易所的五粮液
* **bj.830978** - 北京交易所的诺思兰德

例如：

```bash theme={null}
curl -X GET "https://api.alphafin.x-pai.com/v1/stock/basic-info?symbol=sh.600519" \
  -H "X-API-KEY: your_api_key_here"
```

### 3. 统一标准代码

我们还支持国际通用的统一标准代码，格式为 `{代码}.{交易所}`：

* **600519.SH** - 上海交易所的贵州茅台
* **000858.SZ** - 深圳交易所的五粮液
* **830978.BJ** - 北京交易所的诺思兰德

例如：

```bash theme={null}
curl -X GET "https://api.alphafin.x-pai.com/v1/stock/basic-info?symbol=600519.SH" \
  -H "X-API-KEY: your_api_key_here"
```

<Note>
  所有三种格式在我们的API中都是有效的，您可以根据您的习惯选择使用哪种格式。
</Note>

## 批量请求多个股票

对于支持批量查询的API端点，您可以通过逗号分隔多个股票代码：

```bash theme={null}
curl -X GET "https://api.alphafin.x-pai.com/v1/market/daily?symbol=600519,000858,300750&begin_date=2023-01-01&end_date=2023-01-10" \
  -H "X-API-KEY: your_api_key_here"
```

## 特殊代码

### 指数代码

沪深市场的主要指数代码如下：

* **000001.SH** - 上证指数
* **000300.SH** - 沪深300指数
* **000688.SH** - 科创50指数
* **000016.SH** - 上证50指数
* **000905.SH** - 中证500指数
* **399001.SZ** - 深证成指
* **399006.SZ** - 创业板指数
* **399673.SZ** - 创业板50指数

例如，获取沪深300指数数据：

```bash theme={null}
curl -X GET "https://api.alphafin.x-pai.com/v1/market/daily?symbol=000300.SH&begin_date=2023-01-01&end_date=2023-01-10" \
  -H "X-API-KEY: your_api_key_here"
```

### 行业指数

行业指数通常以特定前缀开头，例如：

* **801开头** - 申万行业指数
* **000开头** - 中证行业指数

## 通过名称搜索股票

如果您不确定股票代码，可以使用我们的搜索API通过名称查找：

```bash theme={null}
curl -X GET "https://api.alphafin.x-pai.com/v1/stock/search?keyword=茅台" \
  -H "X-API-KEY: your_api_key_here"
```

响应示例：

```json theme={null}
{
  "code": 200,
  "message": "success",
  "data": [
    {
      "symbol": "600519",
      "name": "贵州茅台",
      "exchange": "SSE",
      "standard_symbol": "600519.SH",
      "industry": "食品饮料"
    },
    {
      "symbol": "002646",
      "name": "天佑德酒",
      "exchange": "SZSE",
      "standard_symbol": "002646.SZ",
      "industry": "食品饮料"
    }
    // 可能有更多结果...
  ]
}
```

## 最佳实践

* **使用标准化代码**：建议在代码中使用统一标准代码（如 `600519.SH`），以避免歧义。
* **验证股票代码**：使用 [股票基本信息](/api-reference/stock/basic-info) API验证股票代码是否有效。
* **使用批量请求**：对于多个股票的查询，尽量使用批量请求而不是多个单独请求，以提高效率。
* **考虑代码变更**：股票代码可能因重组、转板等原因变更，请使用 [股票代码变更](/api-reference/stock/code-change) API追踪历史变更。

## 常见问题

<AccordionGroup>
  <Accordion title="为什么我的股票代码无法识别？">
    可能的原因包括：

    1. 代码格式错误（应为6位数字）
    2. 股票已退市或暂停交易
    3. 新上市股票尚未在数据库中更新

    建议使用搜索API确认正确的代码。
  </Accordion>

  <Accordion title="如何处理股票代码的历史变更？">
    使用我们的 [股票代码变更](/api-reference/stock/code-change) API获取股票代码的历史变更记录，包括重组、转板等情况。
  </Accordion>

  <Accordion title="我可以使用港股或美股代码吗？">
    目前我们主要支持A股市场数据。港股和美股数据将在未来更新中添加。
  </Accordion>
</AccordionGroup>

## 相关资源

* [股票搜索API](/api-reference/stock/search)
* [股票基本信息API](/api-reference/stock/basic-info)
* [上市状态API](/api-reference/stock/listing-status)
* [代码变更API](/api-reference/stock/code-change)