API 文档
接口地址: https://api.gugudata.com/stock/us
返回格式: application/json; charset=utf-8
请求方式: GET
请求协议: HTTPS
请求示例: https://api.gugudata.com/stock/us?appkey=YOUR_APPKEY&symbol=AAPL&beginDate=20261019&endDate=20261023&adjust=
数据预览: https://www.gugudata.com/preview/stockus
接口测试: https://api.gugudata.com/stock/us/demo
OpenAPI: https://www.gugudata.com/openapi/gugudata.openapi.3.1.json
前置接口说明: 查询美股股票代码列表数据,支持分页查询
前置接口地址: https://api.gugudata.com/stock/ussymbols?appkey=YOUR_APPKEY&pageindex=1&pagesize=20
前置接口参数说明: appkey=YOUR_APPKEY&pageindex=第几页&pagesize=每页返回数量,最大 20 条
前置接口返回格式: application/json; charset=utf-8
前置接口返回说明: 包含股票编码、股票名称、股票中文名称
前置接口请求方式: GET
前置接口请求协议: HTTPS
| 参数名 |
参数类型 |
是否必须 |
默认值 |
备注 |
| appkey |
string |
是 |
无 |
付费后获取的 APPKEY。 |
| symbol |
string |
是 |
无 |
美股代码,支持英文股票代码;多个代码使用英文逗号分隔,最多 10 个。 仅展示当前有效代码,历史代码仍可用于已支持的历史数据查询。 |
| beginDate |
string |
是 |
无 |
查询开始日期,格式 yyyyMMdd;与 endDate 最大间隔为 3660 天。 |
| endDate |
string |
是 |
无 |
查询结束日期,格式 yyyyMMdd;与 beginDate 最大间隔为 3660 天。 |
| adjust |
string |
否 |
无 |
复权类型,可为空;按所选复权口径返回。 |
| 参数名 |
参数类型 |
备注 |
| Data.TimeKey |
integer |
交易日期。 |
| Data.Symbol |
string |
美股代码。 |
| Data.Open |
number |
开盘价。 |
| Data.Close |
number |
收盘价。 |
| Data.High |
number |
最高价。 |
| Data.Low |
number |
最低价。 |
| Data.Volume |
number |
成交量。 |
| Data.TradingAmount |
number | null |
成交额,单位:美元 |
| Data.Swing |
number | null |
振幅,单位:%。 |
| Data.ChangePercent |
number | null |
涨跌幅,单位:%。 |
| Data.ChangeAmount |
number | null |
涨跌额。 |
| Data.TurnoverRate |
number | null |
换手率,单位:%。 |
仅展示部分示例数据,数组最多展示 3 项,长内容已省略;完整数据请调用接口获取。
{
"DataStatus": {
"RequestParameter": "symbol=AAPL&beginDate=20260930&endDate=20261030&adjust=",
"StatusCode": 100,
"StatusDescription": "请求成功",
"ResponseDateTime": "2026-11-02 15:27:19.541",
"DataTotalCount": 23
},
"Data": [
{
"Symbol": "AAPL",
"TimeKey": 20260930,
"Open": 330.79998779296875,
"Close": 333.01998901367188,
"High": 339.5,
"Low": 330.1400146484375,
"Volume": 49988560,
"TradingAmount": 16742537472,
"Swing": 2.84,
"ChangePercent": 1.1,
"ChangeAmount": 3.62,
"TurnoverRate": 0.34
},
{
"Symbol": "AAPL",
"TimeKey": 20261001,
"Open": 330,
"Close": 330.32000732421875,
"High": 332.48199462890625,
"Low": 325.80999755859375,
"Volume": 36306344,
"TradingAmount": 11966601984,
"Swing": 2,
"ChangePercent": -0.81,
"ChangeAmount": -2.7,
"TurnoverRate": 0.25
},
{
"Symbol": "AAPL",
"TimeKey": 20261002,
"Open": 333.260009765625,
"Close": 333.69000244140625,
"High": 334.54000854492188,
"Low": 330.6099853515625,
"Volume": 33278552,
"TradingAmount": 11087258112,
"Swing": 1.19,
"ChangePercent": 1.02,
"ChangeAmount": 3.37,
"TurnoverRate": 0.23
}
]
}