## 提示

- `live-or-trading-module-only`


## 原型

```python
get_underlying_code(symbols)
```

## 释义

get_underlying_code 是 PTrade 中用于获取证券的关联代码的接口。

研究：不支持；回测：不支持；模拟：官方目录未明确；实盘：支持。

## 参数

| 参数 | 是否必填 | 官方原始定义 |
|---|---:|---|
| `symbols` | 是 | symbols |

## 返回值

正常返回一个dict字典，里面包含需要查询的证券，关联类型和关联代码(dict{str:[int,str],...})，

返回每个代码的信息包含以下字段内容：

underlying_type: 关联类型(int)；

underlying_code: 关联代码(str)；

## 示例

```python
def initialize(context):

g.security = '000001.SZ'

set_universe(g.security)

def handle_data(context, data):

#获取110063.SS的关联的代码信息

underlying_code_info = get_underlying_code("110063.SS")

log.info(underlying_code_info)

#获取110063.SS的正股代码

underlying_code = underlying_code_info["110063.SS"][1]

log.info(underlying_code)
```

## 详细说明

get_underlying_code(symbols)

### 使用场景

该函数在交易模块可用

### 接口说明

该接口用于获取证券的关联代码。

### 注意事项

无

### 参数详细说明

symbols: 需要查询的代码(str/list)

### 返回值

正常返回一个dict字典，里面包含需要查询的证券，关联类型和关联代码(dict{str:[int,str],...})，

返回每个代码的信息包含以下字段内容：

underlying_type: 关联类型(int)；

underlying_code: 关联代码(str)；