# 3-4、Symbology
# Symbology（商品体系）
- - - - - -
图表库使用您自己的数据，您自己定义商品体系。 您可以根据需要命名商品。
但有些细节你应该知道:
1. 我们自己定义的商品名称必须为此格式：`EXCHANGE:SYMBOL`。 图表默认使用此格式
2. 如果已经有或者考虑区别不同的商品，那么你可能需要使用`ticker`字段。 `ticker` 为商品唯一标识符，只用于图表的内部，您的用户将不会看到它。 `ticker`为 **仅在** 图表库内部使用的商品唯一标识符。 您的用户将永远无法看到它。 只需在所有SymbolInfo对象和商品搜索结果中输入`ticker`值，图表库将根据这些值请求数据。
## [商品信息结构](#%E5%95%86%E5%93%81%E4%BF%A1%E6%81%AF%E7%BB%93%E6%9E%84)
这一节非常重要。 图表库用户遇到的72.2％的问题，都是由于错误的/格式错误的SymbolInfo数据引起的。
SymbolInfo是一个包含商品metadata的对象。 该对象是解析商品的结果。 SymbolInfo有以下字段：
##### [name](#name)
商品名称。您的用户将看到它(作为一个字符串)。 此外，如果您不使用`tickers`，它将用于数据请求。
##### [ticker](#ticker)
它是您的商品体系中此商品的唯一标识符。如果您指定此属性，则其值将用于所有数据请求，`ticker`如果未明确指定，则被视为等于`symbol`。(译者注：请一定指定`ticker`，如果没有`ticker`可以将`symbol`赋值给`ticker`，未指定`ticker`时会发生错误。)
##### [description](#description)
商品说明。这个商品说明将被打印在图表的标题栏中。
##### [type](#type)
仪表的可选类型。
*可能的类型是:*
- `stock`
- `index`
- `forex`
- `futures`
- `bitcoin`
- `expression`
- `spread`
- `cfd`
- 或其他字符串。
##### [session](#session)
商品交易时间。请参阅交易日细节了解更多详情。[交易时段](Trading-Sessions.html)
##### [exchange, listed\_exchange](#exchange-listedexchange)
现在，这两个字段都为某个交易所的略称。将被显示在图表的图例中，以表示此商品。目前此字段不用于其他目的。
##### [timezone](#timezone)
这个商品的交易所时区。我们希望以olsondb格式获取时区的名称。
*支持的时区为:*
- `Etc/UTC`
- `Africa/Cairo`
- `Africa/Johannesburg`
- `Africa/Lagos`
- `America/Argentina/Buenos_Aires`
- `America/Bogota`
- `America/Caracas`
- `America/Chicago`
- `America/El_Salvador`
- `America/Juneau`
- `America/Lima`
- `America/Los_Angeles`
- `America/Mexico_City`
- `America/New_York`
- `America/Phoenix`
- `America/Santiago`
- `America/Sao_Paulo`
- `America/Toronto`
- `America/Vancouver`
- `Asia/Almaty`
- `Asia/Ashkhabad`
- `Asia/Bahrain`
- `Asia/Bangkok`
- `Asia/Chongqing`
- `Asia/Dubai`
- `Asia/Ho_Chi_Minh`
- `Asia/Hong_Kong`
- `Asia/Jakarta`
- `Asia/Jerusalem`
- `Asia/Kathmandu`
- `Asia/Kolkata`
- `Asia/Kuwait`
- `Asia/Muscat`
- `Asia/Qatar`
- `Asia/Riyadh`
- `Asia/Seoul`
- `Asia/Shanghai`
- `Asia/Singapore`
- `Asia/Taipei`
- `Asia/Tehran`
- `Asia/Tokyo`
- `Atlantic/Reykjavik`
- `Australia/ACT`
- `Australia/Adelaide`
- `Australia/Brisbane`
- `Australia/Sydney`
- `Europe/Athens`
- `Europe/Belgrade`
- `Europe/Berlin`
- `Europe/Copenhagen`
- `Europe/Helsinki`
- `Europe/Istanbul`
- `Europe/London`
- `Europe/Luxembourg`
- `Europe/Madrid`
- `Europe/Moscow`
- `Europe/Paris`
- `Europe/Riga`
- `Europe/Rome`
- `Europe/Stockholm`
- `Europe/Tallinn`
- `Europe/Vilnius`
- `Europe/Warsaw`
- `Europe/Zurich`
- `Pacific/Auckland`
- `Pacific/Chatham`
- `Pacific/Fakaofo`
- `Pacific/Honolulu`
- `Pacific/Norfolk`
- `US/Mountain`
##### [minmov(最小波动), pricescale(价格精度), minmove2, fractional(分数)](#minmov%E6%9C%80%E5%B0%8F%E6%B3%A2%E5%8A%A8-pricescale%E4%BB%B7%E6%A0%BC%E7%B2%BE%E5%BA%A6-minmove2-fractional%E5%88%86%E6%95%B0)
1. 最小的价格变化是由这些值决定的。
2. PriceScale 参数确定了图表价格量表上的价格线之间的周期。
这三个键有不同意义时，使用通常价格和分数价格。
##### [通常价格](#%E9%80%9A%E5%B8%B8%E4%BB%B7%E6%A0%BC)
```
MinimalPossiblePriceChange（最小可能价格变动） = minmov / pricescale
```
`minmov`数字型单位组成一个tick。例如，美国股票价格和tick有小数，并可以上下浮动+/- 0.01。
##### [分数价格](#%E5%88%86%E6%95%B0%E4%BB%B7%E6%A0%BC)
分数显示价格,1 - xx'yy（例如，133'21)或 2 - xx'yy'zz （例如，133'21'5）。
##### [minmove2<0>](#minmove20)
这是一个神奇的数字来格式化复杂情况下的价格。这里有一些例子:
```
典型的股票以0.01价格增量：minmov = 1，pricecale = 100，minmove2 = 0
ZBM2014（国债），1/32：minmov = 1，pricecale = 32，minmove2 = 0
ZCM2014（玉米），2/8：minmov = 2，pricecale = 8，minmove2 = 0
ZFM2014（5年期国债），1/32的1/4：minmov = 1，pricecale = 128，minmove2 = 4
```
##### [has\_intraday](#hasintraday)
布尔值显示商品是否具有日内（分钟）历史数据。 如果它为`false`，则当图表中的该商品处于活动状态时，日内周期的所有按钮将被禁用。 如果设置为`true`，则由datafeed直接提供的所有周期必须在intraday\_multipliers数组中设定。
##### [supported\_resolutions](#supportedresolutions)
在这个商品的周期选择器中启用一个周期数组。 数组的每个项目都是字符串。
被datafeed支持（见datafeed配置数据）但不受当前商品支持的周期,将在周期选择器部件中禁用。 如果更改商品，新商品不支持选定的周期，则周期将切换到支持的周期列表中的第一项。 周期可用性逻辑（伪代码）:
```
resolutionAvailable =
resolution.isIntraday ?
symbol.has_intraday && symbol.supports_resoluiton(resolution) :
symbol.supports_resoluiton(resolution);
```
如果在商品信息中没有supported\_resolutionsin，则所有DWM(daily, weekly, monthly)周期都可用。 如果has\_intraday为true，则日内周期可用。
支持的周期也会影响可用的时间范围。 如果使用不支持的周期，则时间范围将不可用。
##### [intraday\_multipliers <\[\]>](#intradaymultipliers-)
这是一个包含日内周期(分钟单位)的数组，datafeed将会自行构建它。
举例来说：如果datafeed报告说它支持 \["1", "5", "15"\]，但事实上股票X只有1分钟的数据，股票X将设定 intraday\_multipliers = \[1\]，那么Charting Library将自行构建5分钟和15分钟的周期。
##### [has\_seconds](#hasseconds)
布尔值显示商品是否具有以秒为单位的历史数据。如果它为`false`，那么在图表中此商品处于活动状态时，所有秒的周期的按钮将被禁用。如果它为`true`，则由datafeed直接提供的所有周期必须在`seconds_multipliers`数组中设定。
##### [seconds\_multipliers <\[\]>](#secondsmultipliers-)
这是一个包含秒周期(以秒为单位，无小数) ，datafeed将会自行构建它。
举例来说：如果datafeed报告说它支持 \["1S", "5S", "15S"\]，但事实上股票X只有1秒钟的数据，股票X将设定 seconds\_multipliers = \[1\]，那么Charting Library将自行构建5S和15S的周期。
##### [has\_daily](#hasdaily)
布尔值显示商品是否具有以日为单位的历史数据。如果它为false，则Charting Library将自行构建日单位的周期。如果没有，则会向datafeed请求这些数据。
##### [has\_weekly\_and\_monthly](#hasweeklyandmonthly)
布尔值显示商品是否具有以W和M为单位的历史数据。如果它为false，则Charting Library将通过日单位的周期自行构建。如果没有，则会向datafeed请求这些数据。
##### [has\_empty\_bars](#hasemptybars)
布尔值显示在交易过程中，当datafeed没有数据返回时,library是否会生成空的K柱。
即，如果您的交易时间为0900-1600，而您的实际数据在11:00和12:00之间没有交易，而您的has\_empty\_bars为true，那么Library会在此段时间贴上退化的K柱。
##### [force\_session\_rebuild](#forcesessionrebuild)
布尔值显示library是否会随着当前交易而过滤K柱。如果为false，则当library从其他周期构建数据或将has\_empty\_bars设置为true时，K柱将被过滤。 如果为true，Library将会删除那些不是交易K柱的数据。
##### [has\_no\_volume](#hasnovolume)
布尔表示商品是否拥有成交量数据。
##### [has\_fractional\_volume](#hasfractionalvolume--%E5%B7%B2%E8%BF%87%E6%97%B611---15-%E7%94%A8%E6%B3%95%E4%B8%8Evolumeprecision%E7%9B%B8%E5%8F%8D) | 已过时(1.1 - 1.5), 用法与volume\_precision相反
如果has\_fractional\_volume = true，成交量指标值将不会舍入为整数值。
##### [volume\_precision <0>](#volumeprecision-0)
整数显示此商品的成交量数字的小数位。0表示只显示整数。1表示保留小数位的1个数字字符，等等。
##### [data\_status](#datastatus)
数据状态码。状态显示在图表的右上角。
*支持的值:*
- `streaming`(实时)
- `endofday`(已收盘)
- `pulsed`(脉冲)
- `delayed_streaming`(延迟流动中)
##### [expired](#expired)
期满，布尔值显示此商品是否为到期的期货合约。
##### [expiration\_date](#expirationdate)
到期日(Unix时间戳)。 如果`expired` = `true`，则必须设置此值。 图表库将从该时间点而不是实际时刻请求该商品的数据。
##### [sector](#sector)
板块，将在股票信息中显示。
##### [industry](#industry)
行业，将在股票信息中显示。
##### [currency\_code](#currencycode)
货币代码，将在商品信息中显示。
- 序言
- 更新日志
- 1、Charting Library是什么
- 2-1、图表库内容
- 2-2、运行图表库
- 3-1、如何连接我的数据
- 3-2、JS Api
- 3-3、UDF
- 3-4、Symbology
- 3-5、交易时段
- 3-6、报价
- 4-1、定制概述
- 4-2、Widget构造器
- 4-3、Widget方法
- 4-4、图表方法
- 4-5、功能集
- 4-7、定制的使用案例
- 5-1、交易终端简介
- 5-2、交易控制器
- 5-3、经纪商API
- 5-4、交易主机
- 5-5、账户管理器
- 5-6、交易对象和常量
- 6、储存和载入图表
- 7、创建自定义指标
- 7、最佳做法
- 9、经常被问到的问题
- 10、版本变更点
- 周期
- 时间范围
- 本地化
- 覆盖
- 绘图覆盖
- 指标覆盖
- 形状与覆盖
- 订阅
- 交易元语
- 在K线上做标记
- 委托
- WatchedValue
- 指标API
- 形状API
- 容器API
- 价格坐标Api