其他时间范围和数据

介绍

Pine Script™ 允许用户从其图表使用的来源和上下文以外的来源和上下文请求数据。我们在本页介绍的功能可以从各种替代来源获取数据：

• request.security()从另一个符号、时间范围或其他上下文中检索数据。
• request.security_lower_tf()检索条形内数据，即来自低于图表时间范围的时间范围的数据。
• request.currency_rate()请求每日汇率将一种货币表示的值转换为另一种货币表示的值。
• request.dividends()、request.splits() 和 request.earnings()分别检索有关发行公司的股息、拆分和收益的信息。
• request.quandl()从NASDAQ Data Link（以前称为 Quandl）检索信息。
• request.financial()从FactSet检索财务数据 。
• request.economic()检索经济和行业数据。
• request.seed()从用户维护的GitHub 存储库检索数据。

这些是命名空间中的函数的签名request.*：

request.security(symbol, timeframe, expression, gaps, lookahead, ignore_invalid_symbol, currency, calc_bars_count) → series <type>

request.security_lower_tf(symbol, timeframe, expression, ignore_invalid_symbol, currency, ignore_invalid_timeframe, calc_bars_count) → array<type>

request.currency_rate(from, to, ignore_invalid_currency) → series float

request.dividends(ticker, field, gaps, lookahead, ignore_invalid_symbol, currency) → series float

request.splits(ticker, field, gaps, lookahead, ignore_invalid_symbol) → series float

request.earnings(ticker, field, gaps, lookahead, ignore_invalid_symbol, currency) → series float

request.quandl(ticker, gaps, index, ignore_invalid_symbol) → series float

request.financial(symbol, financial_id, period, gaps, ignore_invalid_symbol, currency) → series float

request.economic(country_code, field, gaps, ignore_invalid_symbol) → series float

request.seed(source, symbol, expression, ignore_invalid_symbol, calc_bars_count) → series <type>

该request.*()函数系列具有众多潜在应用。在本页中，我们将详细讨论这些函数及其一些典型用例。

共同特征

命名空间中的许多函数request.*()都有一些共同的属性和参数。在深入探讨每个函数之前，让我们先熟悉一下这些特性。

用法

所有request.*()函数都会返回“系列”结果，这意味着它们可以在每条柱状图上产生不同的值。但是，大多数request.*() 函数参数都需要“const”、“输入”或“简单”参数。

本质上，Pine Script™ 必须根据每个参数接受的限定类型request.*()，在编译脚本时或在第一个图表条上确定传递给函数 的大多数参数的值，并且这些值在脚本执行过程中不能更改。唯一的例外是 request.security()、 request.security_lower_tf()和 request.seed()中的参数 ，它接受“系列”参数。expression

函数调用request.*()在每个图表条上执行，并且脚本无法在执行过程中有选择地停用它们。脚本无法调用条件结构request.*()的局部范围内的函数 ，或库导出的函数和方法 ，但它们可以在非导出的用户定义函数和 方法的主体内使用此类函数调用 。

request.*()在脚本中使用任何函数时，运行时性能都是一个重要的考虑因素。这些函数会对脚本性能产生相当大的影响。虽然脚本最多可以包含 40 次对request.*()命名空间的调用，但用户应努力减少脚本中的调用次数，以尽可能降低资源消耗。有关这些函数限制的更多信息，请参阅 我们的用户手册页面中有关 Pine 限制的这一部分。

`差距`

使用request.*()函数从其他上下文检索数据时，数据可能不会像当前图表那样出现在每个新条形图中。函数gaps的参数request.*()允许用户控制函数如何响应请求系列中不存在的值。

假设我们有一个脚本，该脚本使用request.security()在 1 分钟图上执行来请求图表符号的每小时数据 。在这种情况下，函数调用将仅返回涵盖符号每小时条的开盘/收盘时间的 1 分钟条上的新值。在其他图表条上，我们可以通过参数决定函数是否返回 na 值或最后可用的值gaps。

当gaps参数使用 barmerge.gaps_on时，函数将返回 所有 图表条形图上尚未从请求的上下文确认新数据的结果。否则，当参数使用 barmerge.gaps_off时，函数将使用历史条形图上最后确认的值和实时条形图上最新发展的值填充请求数据中的空白。

下面的脚本通过 绘制两个request.security()调用的结果 来演示行为的差异，这两个调用 从 1 分钟图上的每小时时间范围内 获取 当前符号的收盘gaps = barmerge.gaps_off价。第一个调用使用，第二个调用使用gaps = barmerge.gaps_on：

注意：

• barmerge.gaps_offgaps是所有适用函数中参数 的默认值request.*()。
• 该脚本将请求的系列绘制为带有断点的线条（plot.style_linebr），这些线条不会 像默认样式（plot.style_line ）那样跨越na值。
• 使用barmerge.gaps_off时 ， request.security()函数会返回 所有历史条形图上每小时时间范围内的 最后确认 收盘价。在实时条形图（本例中为带有color.aqua背景的条形图 ）上运行时，它会返回符号的当前 收盘 价，无论确认与否。有关更多信息，请参阅 本页的历史和实时行为部分。

`忽略无效符号`

ignore_invalid_symbol函数的参数决定request.*()了函数如何处理无效的数据请求，例如：

• 使用request.*()具有不存在的股票代码 ID 作为 symbol/ticker参数的函数。
• 使用 request.financial() 检索指定 symbol或不存在的信息period。
• 使用 request.economic() 来请求field不存在的country_code。

如果函数调用的参数为 ，则在发出错误请求时request.*()会产生运行时错误并暂停脚本的执行 。当此参数的值为 时，函数在这种情况下将返回 na 值，而不是引发错误。ignore_invalid_symbolfalsetrue

此示例使用用户定义函数request.*()中的调用 来检索用于估计工具市值（市值）的数据。用户定义函数调用 request.financial() 来检索符号的总流通股数，并 调用 request.security()来检索包含符号收盘 价和 货币 的元组 。我们在这两个 调用中都包含了这些内容，以防止无效请求导致运行时错误。calcMarketCap()ignore_invalid_symbol = truerequest.*()

该脚本在图表上的 表格中显示一个格式化的字符串 ，代表符号的估计市值和货币 ，并使用图表 来可视化历史记录：marketCap

注意：

• 该函数将仅返回具有总流通股数据的有效工具的值，例如我们为本示例选择的工具。它将返回 没有财务数据的其他工具calcMarketCap()的市值 na ，包括外汇、加密货币和衍生品。
• 并非所有发行公司都会发布季度财务报告。如果symbol的发行公司不按季度报告，请将此脚本中的“FQ”值更改为公司的最低报告期。 有关更多信息，请参阅request.financial()部分。
• 我们在 indicator() 和 str.tostring()调用中使用了 format.volume ，它指定图表窗格的 y 轴表示卷格式的值，并且值的“字符串”表示形式显示为卷格式的文本。marketCap
• 此脚本会创建一个 表格 并在第一个图表条上初始化其单元格，然后在后续条上更新单元格的文本 。要了解有关使用表格的更多信息，请参阅我们的用户手册中的表格页面。

`货币`

currency函数的参数允许request.*()用户指定请求数据的货币。当此参数的值与 请求上下文的syminfo.currencycurrency不同时，函数将转换请求的值以在指定的 中表示它们。此参数可以接受命名空间中的内置变量currency.*，例如 currency.JPY ，或表示ISO 4217 货币代码的“字符串” （例如“JPY”）。

请求数据的syminfo.currency 与指定数据之间的转换率 currency取决于前一天相应的“FX_IDC”每日汇率。如果没有可用的工具直接提供转换率，则该函数将使用价差符号的值来得出汇率。

`前瞻`

request.security()、 request.dividends()、 request.splits()和 request.earnings()lookahead中的参数 指定 函数调用的预测行为。其默认值为 barmerge.lookahead_off。

当从更高时间范围 (HTF) 上下文请求数据时，该 lookahead值决定函数是否可以请求超出其执行的历史条柱时间的值。换句话说，该lookahead值决定请求的数据是否可能包含历史条柱的前瞻偏差。

当从较低时间范围 (LTF) 上下文请求数据时，该 lookahead参数确定函数是否从每个图表条上的第一个或最后一个内部条(LTF 条) 请求值。

程序员在脚本中使用 lookahead 时应格外小心，即在请求更高时间范围的数据时。 使用 barmerge.lookahead_on 作为值时，请确保它不会通过将未来数据泄露到历史图表条中而lookahead损害脚本逻辑的完整性。

以下场景是在request.*()调用中可以启用前瞻的情况：

• request.security ()expression中的 引用具有历史偏移量 的系列（例如），这可以防止函数请求它无法实时访问的未来值。close[1]
• 调用中指定的timeframe与脚本执行的图表相同，即 timeframe.period。
• 函数调用请求来自 intrabar 时间范围的数据，即小于 timeframe.period 的时间范围 。有关 更多信息，请参阅本节。

此示例演示了该lookahead参数如何影响更高时间范围数据请求的行为，以及为什么在 request.security()中启用前瞻 而不偏移expression会产生误导。脚本调用 request.security()以三种不同的方式 获取 当前图表符号的 HTF 高价，并 在图表上绘制结果系列以供比较。

第一个调用使用 barmerge.lookahead_off （默认），其他调用使用 barmerge.lookahead_on。但是，第三个 request.security() 调用也使用历史引用运算符 []进行偏移 ，以避免将未来的数据泄露到过去。expression

正如我们在图表上看到的， 使用barmerge.lookahead_on 请求的系列 图 没有偏移（紫红色 线） 在历史条形图上实际可用之前显示 了最终的 HTF 高价，而其他两个调用则没有：

注意：

• 使用barmerge.lookahead_off请求的系列 在每个 HTF 周期结束 时都有一个新的历史值，而使用 barmerge.lookahead_on请求的两个系列在每个周期开始 时都有新的历史数据。
• 在实时条形图上，无前瞻系列（蓝色）和有前瞻且无历史偏移的系列（紫红色）的绘图显示相同的值（即 HTF 期间未确认的 高价 ），因为这些点之外不存在任何数据可以泄漏到过去。这两个绘图都将在重新启动脚本执行后 重新绘制其结果，因为实时 条形图将成为 历史 条形图。
• 使用前瞻和历史偏移 ( aqua )的系列不会重绘其值，因为它始终引用 更高时间范围内的 最后确认值。有关更多信息，请参阅本页的避免重绘部分。

数据馈送

TradingView 的数据提供商提供不同的数据源，脚本可以访问这些数据源来检索有关工具的信息，其中包括：

• 日内历史数据（时间范围小于 1 天）
• 每日收盘（EOD）历史数据（时间范围 >= 1D）
• 实时数据（可能会延迟，具体取决于您的帐户类型和额外的数据服务）
• 延长营业时间数据

并非所有这些数据馈送类型都适用于每种工具。例如，符号“BNC:BLX”仅具有 EOD 数据可用。

对于某些具有日内和日外历史数据的工具，交易量数据可能不相同，因为某些交易（大宗交易、场外交易等）可能仅在交易日结束时可用。因此，日外数据将包含此交易量数据，但日内数据则不会。对于加密货币等工具，日外数据和日内交易量数据之间的差异几乎不存在，但在股票中却很常见。

EOD 和盘中数据之间也可能出现轻微的价格差异。例如，一个 EOD 柱状图上的高值可能与数据提供商当天提供的任何盘中高值不匹配。

EOD 和日内数据馈送之间的另一个区别是，EOD 馈送不包含延长时段的信息。

使用函数检索实时条形图信息时request.*() ，需要注意的是，某一工具的历史数据和实时数据报告通常依赖于不同的数据馈送。经纪商/交易所可能会追溯修改实时条形图报告的值，而这些数据只有在刷新图表或重新启动脚本执行后才会反映出来。

另一个重要的考虑因素是图表的数据馈送和脚本从提供商处请求的馈送由 独立的并发进程管理。因此，在极少数情况下，可能会发生竞争，请求的结果暂时与实时条形图上的图表不同步，脚本在重新启动执行后会进行追溯调整。

这些点可能解释了函数从其他上下文请求数据时检索到的值的变化 request.*()。它们还可能导致实时条和历史条上收到的数据不一致。对于人们在请求的数据馈送中可能遇到的变化，没有固定的规则。

当使用从其他上下文请求的数据馈送时，考虑脚本执行的图表与请求的馈送之间的时间轴request.*()差异也至关重要，因为函数会将返回的系列调整到图表的时间轴。例如，使用 request.security()请求“SPY”图表上的“BTCUSD”数据 ，只有当“SPY”图表也有新数据时才会显示新值。由于“SPY”不是 24 小时符号，因此返回的“BTCUSD”数据将包含直接查看其图表时不存在的缺口。

`request.security()`

request.security () 函数允许脚本从脚本执行的图表以外的其他上下文请求数据，例如：

• 其他符号，包括价差符号
• 其他时间范围（请参阅我们的用户手册中的 时间范围页面，了解 Pine Script™ 中的时间范围规格）
• ticker.*()使用函数自定义上下文，包括备选会话、价格调整、图表类型等

这是该函数的签名：

request.security(symbol, timeframe, expression, gaps, lookahead, ignore_invalid_symbol, currency, calc_bars_count) → series <type>

该symbol值是代表要从中获取数据的代码的股票标识符。此参数接受以下任意格式的值：

• 表示符号（例如“IBM”或“EURUSD”）或“交易所：符号”对（例如“NYSE：IBM”或“OANDA：EURUSD”）的“字符串”。当值不包含交易所前缀时，函数会自动选择交易所。我们建议尽可能指定交易所前缀以获得一致的结果。用户还可以将空字符串传递给此参数，以提示函数使用当前图表的符号。
• 表示价差符号的“字符串” （例如“AMD/INTC”）。请注意，“条形图重放”模式不适用于这些符号。
• syminfo.ticker 或 syminfo.tickerid 内置变量，返回当前图表引用的符号或“交易所：符号”对。我们建议使用 syminfo.tickerid以避免歧义，除非 交易所信息在数据请求中无关紧要。有关变量的更多信息，请参阅 我们图表信息页面的此部分 。syminfo.*
• 使用函数创建的自定义股票代码标识符ticker.*()。由这些函数构造的股票代码 ID 可能包含使用 非标准图表计算、替代会话和其他上下文请求数据的其他设置。 有关更多信息，请参阅自定义上下文部分。

该timeframe值指定请求数据的时间范围。此参数接受我们 时间范围规范格式的“字符串”值（例如，“1D”值代表每日时间范围）。要从与脚本执行的图表相同的时间范围内请求数据，请使用 timeframe.period 变量或空字符串。

request.security()expression函数的参数 决定 了它从指定上下文中检索的数据。这个多功能参数接受 int、 float、 bool、 color、 string和chart.point类型的“系列”值。它还可以接受 tuple、 collections、 用户定义类型以及函数和 方法调用的输出。有关可以检索的数据的更多详细信息，请参阅 下面的可请求数据部分。

时间范围

request.security () 函数可从任何可用时间范围请求数据，无论脚本在哪个图表上执行。检索到的数据的时间范围取决于timeframe函数调用中的参数，该参数可能表示更高的时间范围（例如，在日内图表上运行脚本时使用“1D”作为值timeframe ）或图表的时间范围（即使用 timeframe.period 或空字符串作为参数timeframe）。

脚本还可以使用request.security()请求较低时间范围内的有限数据 （例如，在 60 分钟图表上运行脚本时使用“1”作为参数）。但是，我们通常不建议将此函数用于 LTF 数据请求。 对于此类情况， request.security_lower_tf() 函数更为理想。timeframe

更高的时间范围

request.security()的大多数用例 涉及请求高于或等于图表时间范围的数据。例如，此脚本 从请求中检索hl2higherTimeframe价格。它将 结果系列与当前图表的hl2一起绘制在图表上 以供比较：

注意：

• 我们在参数中添加了一个偏移量expression，并 在 request.security()中使用了barmerge.lookahead_on ，以确保返回的序列在历史和实时条形图上的行为相同。 有关更多信息，请参阅避免重绘部分。

请注意，在上面的例子中，可以选择一个 实际上代表比图表使用的时间范围更低的higherTimeframe值 ，因为代码不会阻止它。在设计专门用于更高时间范围的脚本时，我们建议加入条件以防止其访问更低的时间范围，特别是如果您打算 发布它时。

下面，我们在前面的示例中添加了一个 if结构， 当输入表示的时间范围小于图表时间范围时，会引发运行时错误，从而有效地阻止脚本请求 LTF 数据：higherTimeframe

较低的时间范围

尽管 request.security() 函数旨在在大于或等于图表时间范围的时间范围内运行，但它也可以expression从较低的时间范围请求数据，但有限制。当调用此函数访问较低的时间范围时，它将从 LTF 上下文中评估。但是，它只能返回每个图表条上的单个内部条（LTF 条）的结果。

函数在每个历史图表条形图上返回数据的 intrabar 取决于lookahead函数调用中的值。使用 barmerge.lookahead_on时，它将返回图表周期中 第一个可用的 intrabar。使用barmerge.lookahead_off时，它将返回图表周期中的最后一个intrabar。在实时条形图上，它会返回时间范围内的最后一个可用值expression，无论值如何lookahead，因为函数检索到的实时 intrabar 信息尚未排序。

此脚本 从最接近图表时间范围大小四分之一的有效时间范围内 检索收盘数据。它使用 不同的值对request.security()lookahead进行两次调用。第一次调用使用 barmerge.lookahead_on 访问每个图表条中的第一个内部条值。第二次调用使用默认lookahead值 ( barmerge.lookahead_off )，它请求分配给每个图表条的最后一个内部条值。脚本在图表上绘制两次调用的输出以比较差异：

注意：

• 该脚本通过使用timeframe.in_seconds()lowerTimeframe计算图表时间范围内的秒数 来确定值，然后除以四并 通过 timeframe.from_seconds()将结果转换为有效的时间范围字符串。
• 没有前瞻的系列图（紫色）与 图表时间范围内的收盘值对齐 ，因为这是图表条中的最后一个条内值。
• 两个 request.security() 调用都会在每个实时条形图上返回相同的值（当前 收盘价） ，如橙色背景 的条形图上所示 。
• 脚本可以从较低时间范围的上下文中检索最多 100,000 个内部条形图。请参阅 限制页面的 此部分 。

可请求的数据

request.security()函数 用途广泛，因为它可以检索任何基本类型（int、float、bool、color或string）的值。它还可以请求引用基本类型的数据结构和内置或 用户定义类型的 ID 。此函数请求的数据取决于其expression参数，该参数接受以下任何参数：

• 内置变量和函数调用
• 脚本计算的变量
• 元组
• 调用用户定义函数
• 图表要点
• 收藏
• 用户定义类型

内置变量和函数

request.security()的一个常见用例 是从另一个符号或时间范围 请求内置变量或函数/方法调用的输出。

例如，假设我们想在日内图上计算 某个符号 ohlc4价格在日线时间范围内的 20 条SMA 。我们可以用一行代码完成此操作：

上面这一行根据每日时间范围计算当前符号的ta.sma(ohlc4, 20)的值。

值得注意的是，Pine 的新手有时可能会混淆上面的代码行，认为它等同于下面的代码行：

但是，此行将返回完全不同的结果。它不是从每日时间范围内请求 20 条 SMA，而是 从每日时间范围内 请求ohlc4价格，并计算 20 条图表条形图 结果的ta.sma()。

本质上，当意图从其他上下文请求表达式的结果时，将表达式直接传递给 request.security()expression调用中的参数 ，如最初的示例所示。

让我们扩展这个概念。下面的脚本计算多时间范围 (MTF) 移动平均线带，其中带中的每个移动平均线在其各自的时间范围内计算相同数量的条形图。每个 request.security() 调用都使用ta.sma(close, length) 作为expression参数来返回length指定时间范围内的 -bar SMA：

注意：

• 该脚本通过将图表的 timeframe.in_seconds() 值乘以 2、3 和 4 来计算功能区的更高时间范围，然后 使用 timeframe.from_seconds()将每个结果转换为有效的时间范围字符串。
• 无需 在每个 request.security()调用中调用ta.sma() ，只需在每个调用中使用该变量即可 获得相同的结果。 有关更多信息，请参阅下一节。chartAvgexpression
• 在实时条形图上，此脚本还会跟踪每个较高时间范围内 未确认的SMA 值。请参阅历史和实时行为部分以了解更多信息。

计算变量

request.security()expression的参数 接受 在全局范围内声明的变量，允许脚本从其他上下文评估其变量的计算，而无需在每个函数调用中冗余地列出操作。

例如，可以声明以下变量：

并使用request.security()从另一个上下文执行变量的计算 ：

上面一行中的函数调用将返回 priceReturn对另一个symbol数据的计算结果作为适合当前图表的系列，脚本可以直接在图表上显示该结果或在其他操作中使用。

以下示例比较当前图表符号和另一个指定 的价格回报symbol。脚本 priceReturn从图表上下文中声明变量，然后在 request.security()中使用该变量 来评估其对另一个 的计算symbol。然后，它计算 和 之间的相关性，并 在图表上绘制结果：priceReturnrequestedReturn

注意：

• request.security () 调用执行与声明中相同的计算priceReturn ，但它使用 从输入中获取的接近symbol值。
• 该脚本根据值使用渐变色为图表着色 correlation。要了解有关 Pine 中颜色渐变的更多信息，请参阅 我们用户手册中有关颜色的页面的 此部分。

元组

Pine Script™ 中的元组是用逗号分隔的括号中的表达式集，可以容纳任何可用类型的多个值。我们在创建返回多个值的函数或其他本地块时使用元组。

request.security () 函数可以接受元组作为其expression参数，从而允许脚本使用单个函数调用请求多个不同类型的系列。请求的元组中的表达式可以是 本页可请求数据部分中列出的任何类型，但不包括其他元组。

当脚本需要从特定上下文中检索多个值时，元组特别方便。

例如，此脚本计算收盘 价在柱状图上 的 百分比排名，并将表达式分配给变量 。然后，它调用 request.security()来 从指定的 请求包含、ta.crossover(rank, 50)和ta.crossunder(rank, 50)值的元组。该脚本 绘制 并使用bgcolor()中的和“bool”值 有条件地突出显示图表窗格的背景：lengthrankranktimeframerequestedRankcrossOvercrossUnder

注意：

• rank我们使用历史引用运算符 []将变量的表达式偏移了一个条形图 ，并 在 request.security()调用中包含了barmerge.lookahead_on ，以确保实时条形图上的值在成为历史条形图后不会重新绘制。有关更多信息，请参阅 避免重新绘制部分。
• request.security () 调用返回一个元组，因此我们使用元组声明来声明requestedRank、crossOver和crossUnder变量。要了解有关使用元组的更多信息，请参阅 我们用户手册的 类型系统 页面的此部分。

用户定义函数

用户定义函数和 方法 是由用户编写的自定义函数。它们允许用户定义与标识符关联的操作序列，脚本可以在执行过程中方便地调用这些操作序列（例如myUDF()）。

request.security ()函数可以请求用户定义的函数和 方法 的结果 ，其范围由本页的 可请求数据部分概述的任何类型组成。

例如，此脚本包含一个用户定义weightedBB()函数，该函数使用由指定系列加权的基准平均值来计算布林带weight。该函数返回 自定义带值元组。脚本调用request.security() 中的参数 weightedBB()来 检索 根据指定计算的带值元组，并 在图表上绘制结果：expressiontimeframe

注意：

• 我们在 request.security()中偏移了用作 的调用中的source和weight参数 ，并使用了 barmerge.lookahead_on来确保请求的结果反映了实时条形图中 最后确认的值。请参阅此部分以了解更多信息。weightedBB()expressiontimeframe

图表要点

图表点是表示图表上坐标的引用类型。 线、 框、 折线和标签 使用 chart.point 对象来设置其显示位置。

request.security ()函数可以 在其参数中使用chart.point实例 的 ID expression，允许脚本从其他上下文中检索图表坐标。

下面的示例请求更高时间范围内的历史 图表点元组，并使用它们在图表上绘制 框。脚本声明引用 最后确认的条形图 的chart.pointtopLeft ID 的和bottomRight变量 。然后，它使用request.security() 请求 包含代表和的 图表点ID 的 元组。topLeftbottomRighthigherTimeframe

当在 上开始新的条形图时higherTimeframe，脚本将 使用和坐标从和 图表点绘制一个新框：timepricerequestedTopLeftrequestedBottomRight

注意：

• 由于此示例是专门为更高的时间范围设计的，因此我们包含了一个自定义运行时错误，当timeframe.in_seconds() 小于higherTimeframe图表的时间范围 时，脚本会引发该 错误。

收藏

Pine Script™集合（数组和映射）是包含任意数量具有指定类型的元素的数据结构。 request.security()函数可以检索元素包含以下内容的集合 的 ID ：

• 基本类型
• 图表要点
• 满足以下部分所列条件的 用户定义类型

此示例计算已确认条形图的高低范围与 从指定和开始的 10 条条形图的最高值 和 最低值之间的范围的比率。它使用 映射来保存计算中使用的值。symboltimeframe

该脚本创建一个data带有“string”键和“float”值的映射，以保存 每个条形图上的高价、 低价、 最高价和 最低expression价值，并在 request.security()中使用这些值 来计算otherData表示data指定上下文的映射。它使用与映射的“High”、“Low”、“Highest”和“Lowest”键关联的值otherData来计算图表窗格中的比例that it图：

注意：

• 如果指定上下文中没有可用数据，此脚本中的 request.security() 调用将返回 na。由于当映射变量的值为 na 时无法对其调用方法 ， 因此 我们添加了 if 结构，以便 仅 在引用 有效 映射 ID 时计算新值。ratiootherData

用户定义类型

用户定义类型 (UDT)是包含任意数量 字段的复合类型，这些字段可以是任何可用类型，包括其他 用户定义类型。

如果UDT生成的 对象的 字段包含以下内容，则 request.security() 函数可以从其他上下文中检索 这些对象 的 ID ：

• 基本类型
• 图表要点
• 满足上文所列标准的 藏品
• 字段由以下任意类型组成的其他UDT

以下示例 使用指定的请求对象symbolID ，并在图表窗格上显示其字段值。

该脚本包含一个TickerInfoUDT，其中包含用于 syminfo.*值 的“字符串”字段 、用于存储最近“浮点”价格数据的 数组字段以及用于保存请求的股票行情的bar_index 值的“整数”字段。它为每个条形图上的变量分配一个新的TickerInfoID info，并使用该变量作为request.security()expression中的 ，以检索表示从指定的 计算出的 的对象 的 ID 。infosymbol

该脚本在标签requestedInfo中显示对象的description、 tickerType、currency和barIndex值 ，并使用 plotcandle() 显示其数组中的值：prices

注意：

• 此脚本中使用的变量syminfo.*均返回“简单字符串”限定类型。但是， Pine 中的对象始终被限定为“系列”。因此，分配给info对象字段的所有值都会自动采用“系列” 限定符。
• 由于请求的数据 与主图表之间存在差异， request.security()调用可能 会返回 na 。在这种情况下，此脚本会将一个新 对象分配给 ，以防止运行时错误。symbolTickerInforequestedInfo

`请求.security_lower_tf()`

request.security_lower_tf()函数 是request.security() 的替代方案 ，旨在可靠地从较低时间帧 (LTF) 上下文请求信息。

request.security() 可以从每个图表条中的单个内部条 (LTF 条) 检索数据， 而 request.security_lower_tf()可以 从每个图表条中所有可用的内部条中检索数据，脚本可以访问这些数据并将其用于其他计算。每次 request.security_lower_tf() 调用都可以从较低的时间范围内检索最多 100,000 个内部条。有关更多信息，请参阅 我们的限制页面的此 部分。

下面是该函数的签名，与request.security()类似 ：

request.security_lower_tf(symbol, timeframe, expression, ignore_invalid_symbol, currency, ignore_invalid_timeframe, calc_bars_count) → array<type>

此函数仅请求小于或等于图表时间范围的时间范围的数据。如果timeframe请求的时间范围高于图表的时间范围，则该函数将引发运行时错误或返回 na 值，具体取决于ignore_invalid_timeframe调用中的参数。此参数的默认值为false，这意味着在尝试请求 HTF 数据时它将引发错误并停止脚本的执行。

请求内部数据

Intrabar 数据可以为脚本提供额外的信息，这些信息可能不明显，或者仅通过分析图表的计时器框架上采样的数据无法获得。 request.security_lower_tf() 函数可以从 intrabar 上下文中检索许多数据类型。

在进一步了解本节之前，我们建议您先了解一下 上文request.security()部分中的可请求数据部分 ，该部分提供了有关可请求数据类型的基本信息。 request.security_lower_tf()中的参数 接受该部分中讨论的大部分相同参数，但不包括对 脚本主范围内声明的集合和可变变量的直接引用。虽然它接受许多相同类型的参数，但此函数返回 数组 结果，这在解释和处理方面存在一些差异，如下所述。expression

Intrabar 数据阵列

较低的时间范围比较高的时间范围包含更多的数据点，因为新值的出现频率更高。例如，当比较 1 分钟图和 1 小时图时，1 分钟图每小时的条形图数量最多是 60 倍，具体取决于可用数据。

为了解决图表条内有多个内部条的情况， request.security_lower_tf() 总是以数组形式返回其结果。返回数组中的元素 表示 expression从较低时间范围内检索的值，并根据每个内部条的时间戳按升序排序。

分配给返回 数组的类型模板与request.security_lower_tf()调用中传递的值类型相对应 。例如，使用“int”作为将生成一个 实例，“bool”作为将生成一个 实例，等等。expressionarray<int>expressionarray<bool>

以下脚本使用 intrabar 信息将图表的收盘价变化分解为正值和负值。它调用 request.security_lower_tf() 从每个图表条形图上的 中 获取 ta.change(close)值 的 “浮点”数组，然后使用for…in循环访问数组的所有元素以 累积和求和。该脚本将累积值相加以计算，然后 将结果绘制在图表上，并与进行比较：lowerTimeframepositiveChangenegativeChangenetChangepriceChange

注意：

• 基于 intrabar 数据的图表可能不会出现在所有可用的图表条上，因为 request.security_lower_tf ()只能访问请求上下文中可用的最近 100,000 个 intrabar。在没有可访问的 intrabar 数据的 图表条上执行此函数时，它将返回一个空数组。
• 每个图表条的 intrabar 数量可能因上下文中可用的数据和脚本执行的图表而异。例如，由于某些 1 分钟间隔内缺乏交易活动，提供商的 1 分钟数据馈送可能不包含 60 分钟时间范围内每分钟的数据。要检查为图表条检索到的 intrabar 数量，可以对 结果 数组使用array.size()。
• 如果该lowerTimeframe值大于图表的时间范围，脚本将引发运行时错误，因为我们没有ignore_invalid_timeframe在 request.security_lower_tf() 调用中提供参数。

条内数据元组

当传递元组或返回元组的函数调用作为 request.security_lower_tf()expression中的 参数时，结果是一个数组元组，其 类型模板与参数中的类型相对应。例如，使用元组作为将导致函数返回数据。使用元组允许脚本 通过单个 request.security_lower_tf() 函数调用获取多个内部数据数组。[float, string, color]expression[array<float>, array<string>, array<color>]expression

以下示例请求较低时间范围内的 OHLC 数据，并使用线条和框在图表上可视化当前条形图的内部条形图 。脚本调用 request.security_lower_tf() 并以[open, high, low, close]元组作为其expression来检索 表示来自计算的 OHLC 信息的数组lowerTimeframe元组。然后，它使用 for循环设置线条坐标，并使用检索到的数据和当前条形图索引来显示当前图表条形图旁边的结果，从而提供最新蜡烛图内价格变动的“放大视图”。它还 在线条 周围绘制一个框，以指示内部条形图所占据的图表区域：