变动率

变动率（ROC）接口计算证券价格在指定周期内的百分比变化，并返回ROC值的时间序列。该数据有助于用户通过观察价格变化速度来跟踪市场动能，从而识别潜在的价格走势。

由Twelve Data API（金融数据）

0调用量

N/A延迟

Discover -> Inspect -> Call

调用设置

工具 IDtwelvedata.roc.retrieve.v1.405f6af2

请求参数JSON

本次调用前

2.37 积分 / 次

最终费用按供应商实际用量结算，并同步到使用记录。

字段参考

symbolstring可选

标的资产的交易代码，例如 `AAPL`、`EUR/USD`、`ETH/BTC` 等

isinstring可选

按国际证券识别码（ISIN）筛选。ISIN 数据需在 <a href="https://twelvedata.com/account/add-ons">数据附加服务</a> 中启用

figistring可选

请求数据的金融工具的金融工具全球识别码（FIGI）。此参数自 <a href="https://twelvedata.com/pricing">Ultra 计划</a> 起可用

cusipstring可选

请求数据的金融工具的库斯普编号（CUSIP）。CUSIP 数据需在 <a href="https://twelvedata.com/account/add-ons">数据附加服务</a> 中启用

intervalstring必填

时间序列中两个连续数据点之间的时间间隔

outputsizeinteger可选

要获取的数据点数量，支持范围为 `1` 至 `5000`。若未设置日期参数，默认为 `30`；否则设为最大值

exchangestring可选

标的资产上市交易的交易所

mic_codestring可选

符合 ISO 10383 标准的市场识别码（MIC）

countrystring可选

标的资产交易所在的国家，例如 `美国` 或 `US`

typestring可选

标的资产所属的资产类别

timezonestring可选

输出时间戳所采用的时区。支持以下选项：<ul> <li>1. <code>Exchange</code>：使用交易所本地时间</li> <li>2. <code>UTC</code>：使用通用协调世界时（UTC）</li> <li>3. IANA 时区数据库中的时区名称，例如 <code>America/New_York</code>、<code>Asia/Singapore</code>。完整时区列表请参见 <a href="https://en.wikipedia.org/wiki/List_of_tz_database_time_zones" target="blank">此处</a></li> </ul> 注意：IANA 时区名称区分大小写

start_datestring可选

可单独使用或与 `end_date` 配合使用。格式为 `2006-01-02` 或 `2006-01-02T15:04:05`。默认时区：<ul> <li>外汇及加密货币 — <code>UTC</code></li> <li>股票 — 交易所所在地时区（例如 AAPL 对应 <code>America/New_York</code>）</li> </ul> 若提供了 <code>timezone</code> 参数，则 <code>start_date</code> 和 <code>end_date</code> 均按该时区解析。 示例：<ul> <li>1. <code>&symbol=AAPL&start_date=2019-08-09T15:50:00&…</code> 返回自 2019-08-09T15:50:00（纽约时间）起至当前的所有记录</li> <li>2. <code>&symbol=EUR/USD&timezone=Asia/Singapore&start_date=2019-08-09T15:50:00&…</code> 返回自 2019-08-09T15:50:00（新加坡时间）起至当前的所有记录</li> <li>3. <code>&symbol=ETH/BTC&timezone=Europe/Zurich&start_date=2019-08-09T15:50:00&end_date=2019-08-09T15:55:00&...</code> 返回自 2019-08-09T15:50:00（苏黎世时间）至 2019-08-09T15:55:00（苏黎世时间）的所有记录</li> </ul>

end_datestring可选

数据选取的截止日期和时间，详情请参阅 `start_date` 的说明

datestring可选

指定获取数据的确切日期，可以是标准日期格式（如 `2021-10-27`），也可使用自然语言表达（如 `today` 或 `yesterday`）

orderstring可选

输出结果的排序方式

prepostboolean可选

返回包含盘前与盘后行情的报价。仅适用于 `Pro` 及以上订阅计划。仅对美股在 `1min`、`5min`、`15min` 和 `30min` 周期下可用；开盘价、最高价、最低价、收盘价有提供，但无成交量数据

formatstring可选

响应数据的格式

delimiterstring可选

CSV 响应数据中使用的分隔符

dpinteger可选

指定浮点数值的小数位数，取值范围为 [0, 11]（含端点）。默认情况下，小数位数将根据实际数值自动确定

previous_closeboolean可选

布尔型参数，用于在 time_series 数据中包含前一交易时段的收盘价。若为 true，则将前一根 K 线的收盘价添加至当前对象中

adjuststring可选

价格调整模式

series_typestring可选

技术指标所基于的价格类型

time_periodinteger可选

用于平均计算的周期数，取值范围为 `1` 至 `800`

include_ohlcboolean可选

指定是否在输出中包含 OHLC（开盘价、最高价、最低价、收盘价）数值

变动率