接口端点
GET
/api/v1/stock/realtime?symbol={symbol}&market={market}&fields={fields}
请求参数
| 参数名 |
类型 |
必填 |
描述 |
示例值 |
| symbol |
string |
是 |
股票代码，不同市场格式不同 |
600519 (A股), AAPL (美股) |
| market |
string |
是 |
市场标识: sh/sz (A股), hk (港股), us (美股) |
sh |
| fields |
string |
否 |
返回字段，多个用逗号分隔，默认返回全部字段 |
price,change_percent,volume |
| token |
string |
是 |
API访问令牌，需在请求头或参数中传递 |
your_api_key |
返回字段
| 字段名 |
类型 |
描述 |
示例值 |
| symbol |
string |
股票代码 |
600519 |
| name |
string |
股票名称 |
贵州茅台 |
| price |
float |
最新价 |
1785.00 |
| open |
float |
今开价 |
1778.00 |
| high |
float |
最高价 |
1792.50 |
| low |
float |
最低价 |
1775.00 |
| close |
float |
昨收价 |
1778.50 |
| change |
float |
涨跌额 |
6.50 |
| change_percent |
float |
涨跌幅(%) |
0.37 |
| volume |
int |
成交量(手) |
35678 |
| amount |
float |
成交额(万元) |
63789.25 |
| timestamp |
int |
时间戳(毫秒) |
1677643200000 |
响应示例
{
"code": 200,
"message": "success",
"data": {
"symbol": "600519",
"name": "贵州茅台",
"price": 1785.00,
"open": 1778.00,
"high": 1792.50,
"low": 1775.00,
"close": 1778.50,
"change": 6.50,
"change_percent": 0.37,
"volume": 35678,
"amount": 63789.25,
"timestamp": 1677643200000
}
}
错误代码
| 错误码 |
描述 |
解决方案 |
| 400 |
参数错误 |
检查请求参数是否符合要求 |
| 401 |
未授权 |
检查API密钥是否正确 |
| 403 |
禁止访问 |
检查订阅套餐是否包含此接口 |
| 404 |
数据不存在 |
检查股票代码和市场是否正确 |
| 429 |
请求过于频繁 |
降低请求频率或升级套餐 |
| 500 |
服务器错误 |
稍后重试或联系技术支持 |
使用限制
- 免费套餐：每分钟5次请求，每天100次请求
- 基础套餐：每分钟20次请求，每天5000次请求
- 专业套餐：每分钟100次请求，无日请求限制
- 企业套餐：自定义请求频率，专属数据通道