美股实时数据
获取美股实时行情快照,含最新价、涨跌幅与成交量额。适合美股盘中监控,也可以观察中概股走势对次日 A 股相关板块的传导。
说明:套餐用户请把 apiKey 替换为 apiToken 调用接口。
接口地址: api.cxdy.vip/api/gbss
返回格式: JSON
请求方式: GET
请求示例: https://api.cxdy.vip/api/gbss?apiKey=你的apiKey
请求参数说明:
apiKey — 单接口购买用户的密钥,购买后在会员中心获取;apiToken — 套餐用户的访问令牌,在会员中心生成。
返回参数说明:
| 名称 | 类型 | 说明 |
|---|---|---|
| 序号 | int | 序号 |
| 名称 | string | 证券简称 |
| 最新价 | float | 最新价(元) |
| 涨跌额 | float | 涨跌额(元) |
| 涨跌幅 | float | 涨跌幅(%) |
| 开盘价 | float | 开盘价(元) |
| 最高价 | float | 最高价(元) |
| 最低价 | float | 最低价(元) |
| 昨收价 | float | 昨日收盘价(元) |
| 总市值 | string | 总市值(元) |
| 市盈率 | string | 市盈率(TTM) |
| 成交量 | int | 成交量 |
| 成交额 | int | 成交额(元) |
| 振幅 | int | 振幅(%) |
| 换手率 | string | 换手率(%) |
| 代码 | string | 证券代码 |
返回示例:
[{
"序号": 11574,
"名称": "Grom Social Enterprises Inc Wt",
"最新价": 1.22,
"涨跌额": -2.14,
"涨跌幅": -63.69,
"开盘价": 1.22,
"最高价": 1.22,
"最低价": 1.22,
"昨收价": 3.36,
"总市值": null,
"市盈率": null,
"成交量": 262,
"成交额": 319,
"振幅": 0,
"换手率": null,
"代码": "105.GROMW"
}]
错误码格式说明:
| 名称 | 类型 | 说明 |
|---|---|---|
| 200 | int | 请求成功 |
| 203 | int | 请求过于频繁(触发限流),请稍后再试 |
| 400 | int | 请求参数错误:缺少必填参数或参数格式不正确 |
| 401 | int | 鉴权失败:apiKey 无效、API Token 无效或已过期、付费接口未传有效凭证 |
| 403 | int | 拒绝访问:接口已到期请续费,或账号/IP 因违规调用被临时封禁 |
| 404 | int | 接口不存在或已下架;或来源 IP 不在该接口的 IP 白名单内 |
| 429 | int | 调用超限:免费/套餐/单接口用户的当日调用次数已达上限 |
| 500 | int | 服务器错误:上游数据源暂时不可用,请稍后重试 |
代码示例:
curl 请求示例(apiKey,单接口购买用户):
curl "https://api.cxdy.vip/api/gbss?apiKey=你的apiKey"
curl 请求示例(apiToken,套餐用户):
curl "https://api.cxdy.vip/api/gbss?apiToken=你的apiToken"
PHP 请求示例:
<?php
// 套餐用户请将 apiKey=你的apiKey 换成 apiToken=你的apiToken
$ch = curl_init('https://api.cxdy.vip/api/gbss?apiKey=你的apiKey');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
echo $response;
Python 请求示例:
import requests
url = "https://api.cxdy.vip/api/gbss"
params = {"apiKey": "你的apiKey"} # 套餐用户将 apiKey 换成 apiToken
response = requests.get(url, params=params)
print(response.json())
请求参数设置:
| 参数名称 | 参数值 |
|---|---|
[{
"序号": 11574,
"名称": "Grom Social Enterprises Inc Wt",
"最新价": 1.22,
"涨跌额": -2.14,
"涨跌幅": -63.69,
"开盘价": 1.22,
"最高价": 1.22,
"最低价": 1.22,
"昨收价": 3.36,
"总市值": null,
"市盈率": null,
"成交量": 262,
"成交额": 319,
"振幅": 0,
"换手率": null,
"代码": "105.GROMW"
}]