指数移动平均线（EMA）

端点

GET /v1/indicators/ema

示例

GET /v1/indicators/ema?symbol=600519.SH&window=50&timespan=day&limit=10

请求示例

修改参数后，可自动生成 Shell / Python / JavaScript / Go 请求代码及 Python 客户端调用示例。

参数输入

symbol timespan dayadjusted truefalsewindow series_type closeopenhighlowexpand_underlying （不设置）truefalseorder ascdesclimit

请求代码

import os
import requests

r = requests.get(
    "https://api.aeolus-ai.com/v1/indicators/ema",
    params={
        "symbol": "600519.SH",
        "timespan": "day",
        "adjusted": true,
        "window": 50,
        "series_type": "close",
        "order": "desc",
        "limit": 10,
    },
    headers={"Authorization": f"Bearer {os.environ['AEOLUS_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

说明

在指定时间范围内，返回一只或多只 A 股标的的 指数移动平均线（EMA）。EMA 对近期价格赋予更高权重，能更快反映趋势变化。

典型场景： 趋势识别、EMA 金叉/死叉信号、动态支撑/阻力参考、根据近期波动调整策略参数。

多标的请求在 results[] 中 按标的分组 返回序列。

查询参数

参数	类型	必填	默认	说明
symbol	string	是	—	带交易所后缀的代码，如 600519.SH；多个用英文逗号分隔。
timestamp	string	否	—	按时间查询：YYYY-MM-DD 或 Unix 毫秒时间戳。
timespan	string	否	day	聚合时间窗口单位。v1 仅支持 day。
adjusted	boolean	否	true	计算所用聚合价是否按拆分复权。设为 false 则使用未复权序列。
window	integer	否	50	EMA 窗口长度。例如 window=10 且 timespan=day 表示 10 日 EMA。
series_type	string	否	close	用于计算的价字段：open、high、low、close。
expand_underlying	boolean	否	false	为 true 时，响应中包含计算所用序列的元信息（见响应字段）。
order	string	否	desc	按时间戳排序：asc（升序）或 desc（降序）。
limit	integer	否	10	返回结果条数上限，最大 5000。
timestamp.gte	string	否	—	时间范围下界（含）。
timestamp.gt	string	否	—	时间范围下界（不含）。
timestamp.lte	string	否	—	时间上界（含）。
timestamp.lt	string	否	—	时间上界（不含）。

响应字段

顶层

字段	类型	说明
status	string	单标的为 OK；多标的且任一标的 values 为空时为 PARTIAL，否则 OK。
request_id	string	服务端分配的请求 ID。
results	object / array	单标的为 object；多标的为 array（见下）。
resultsCount	integer	仅多标的时返回；为标的数量。

单标的 · results 对象

字段	类型	说明
values	array	指标序列，每项含 timestamp 与 value。
underlying	object	仅当 expand_underlying=true；字段见下。

underlying 对象（expand_underlying=true）

字段	类型	说明
series_type	string	本次计算使用的价字段，如 close。
adjusted	boolean	本次计算是否使用复权序列。

多标的 · results[] 每项

字段	类型	说明
symbol	string	请求的代码。
resultsCount	integer	该标的 values 数组长度。
values	array	同单标的 values 项结构。
underlying	object	仅当 expand_underlying=true；结构同上。

values[] 每项

字段	类型	说明
timestamp	integer	Unix 毫秒时间戳。
value	number	该时点的 EMA 值。

响应示例

单标的

{
  "status": "OK",
  "request_id": "a47d1beb-8c11-4b6a-897a-b76cdbbf35a3",
  "results": {
    "values": [
      {
        "timestamp": 1704124800000,
        "value": 1682.45
      }
    ]
  }
}

多标的

{
  "status": "PARTIAL",
  "request_id": "a47d1beb-8c11-4b6a-897a-b76cdbbf35a3",
  "resultsCount": 2,
  "results": [
    {
      "symbol": "600519.SH",
      "resultsCount": 10,
      "values": [
        { "timestamp": 1704124800000, "value": 1682.45 }
      ],
      "underlying": { "series_type": "close", "adjusted": true }
    },
    {
      "symbol": "000001.SZ",
      "resultsCount": 0,
      "values": []
    }
  ]
}

数据特性

• 合法 symbol、窗口内无可用点时返回 HTTP 200，对应 values: []（非 404）。
• 多标的且部分为空：status 为 PARTIAL。

相关错误码

code	HTTP	场景
INVALID_SYMBOL	400	代码未知或格式错误
INVALID_PARAMETER	400	参数非法
UNAUTHORIZED	401	API Key 无效
INSUFFICIENT_CREDITS	402	账户暂不可用（请在控制台查看）
PLAN_LIMIT	403	超出当前账户允许范围
INTERNAL_ERROR	500	服务器错误

完整列表：错误码。