免费股票API接口全面指南 - 详解

在数字经济时代，股票数据API接口已成为金融科技创新的核心驱动力。本文将带您深入了解如何通过这些接口获取有价值的市场数据，并构建智能化的投资分析系统。

现代股票API接口提供三大类数据服务：

实时行情数据

· 最新报价与成交数据
· 买卖五档盘口信息

历史数据服务

· 历史技术指标
· 历史分时数据

衍生数据资源

· 技术指标计算
· 财务基本面数据
· 市场情绪指标

在量化分析领域，实时、准确的数据接口太重要了。我亲测了几个，都很靠谱，现在就把这些好资源分享给量化分析的朋友们，希望能对你们有所帮助！

【特别提示】：下方验证接口的licence证书（LICENCE-66D8-9F96-0C7F0FBCD073）为官方提供的验证证书，该证书只能验证股票代码000001的股票，因此，下方的接口连接中，即使换掉代码实际返回的也是000001的数据，在实际应用中，需要自己去申请一个免费证书更换掉就可以随意请求数据了，免费证书的申请连接（点击即可马上得到证书）：https://www.mairui.club/gratis.html

沪深两市股票列表

API接口链接（可点击验证）：http://api.mairuiapi.com/hslt/list/LICENCE-66D8-9F96-0C7F0FBCD073

【实时数据接口】

沪深两市实时交易数据接口

API接口链接（可点击验证）：https://api.mairuiapi.com/hsstock/real/time/000001/LICENCE-66D8-9F96-0C7F0FBCD073

1、python

import requests
url = "https://api.mairuiapi.com/hsstock/real/time/000001/LICENCE-66D8-9F96-0C7F0FBCD073"
response = requests.get(url)
data = response.json()
print(data)

2、JavaScript (Node.js)

const axios = require('axios');
const url = "https://api.mairuiapi.com/hsstock/real/time/000001/LICENCE-66D8-9F96-0C7F0FBCD073";
axios.get(url)
.then(response => {
console.log(response.data);
})
.catch(error => {
console.log(error);
});

3、Java

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.io.IOException;
public class Main {
public static void main(String[] args) {
HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://api.mairuiapi.com/hsstock/real/time/000001/LICENCE-66D8-9F96-0C7F0FBCD073"))
.build();
try {
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());System.out.println(response.body());} catch (IOException | InterruptedException e) {e.printStackTrace();}}}

返回的数据：

{"fm":"-0.20","h":"10.26","hs":"0.67","lb":"1.38","l":"10.11","lt":"197161074084.00","o":"10.11","pe":"3.81","pc":"0.30","p":"10.16","sz":"197164128892.00","cje":"1318858687.52","ud":"0.03","v":"1294059","yc":"10.13","zf":"1.48","zs":"-0.20","sjl":"0.48","zdf60":"-0.20","zdfnc":"17.19","t":"2024-08-30 15:29:03"}

沪深两市买卖五档盘口

API接口链接（可点击验证）：https://api.mairuiapi.com/hsstock/real/five/000001/LICENCE-66D8-9F96-0C7F0FBCD073

沪深两市最新分时交易

API接口链接（可点击验证）：https://api.mairuiapi.com/hsstock/latest/000001.SZ/d/n/LICENCE-66D8-9F96-0C7F0FBCD073

当天逐笔交易

API接口链接（可点击验证）：http://api.mairuiapi.com/hsrl/zbjy/000001/LICENCE-66D8-9F96-0C7F0FBCD073

【历史数据接口】

沪深两市历史分时交易

API接口链接（可点击验证）：https://api.mairuiapi.com/hsstock/history/000001.SZ/d/n/LICENCE-66D8-9F96-0C7F0FBCD073?st=20250101&et=20250430

沪深两市历史分时KDJ

API接口链接（可点击验证）：http://api.mairuiapi.com/hsstock/history/kdj/000001.SZ/d/n/LICENCE-66D8-9F96-0C7F0FBCD073

沪深两市历史分时MACD

API接口链接（可点击验证）：http://api.mairuiapi.com/hsstock/history/macd/000001.SZ/d/n/LICENCE-66D8-9F96-0C7F0FBCD073

沪深两市历史分时MA

API接口链接（可点击验证）：http://api.mairuiapi.com/hsstock/history/ma/000001.SZ/d/n/LICENCE-66D8-9F96-0C7F0FBCD073

沪深两市历史分时BOLL

API接口链接（可点击验证）：http://api.mairuiapi.com/hsstock/history/boll/000001.SZ/d/n/LICENCE-66D8-9F96-0C7F0FBCD073

API说明文档

沪深两市股票

API接口：http://api.mairuiapi.com/hslt/list/您的licence

接口说明：获取沪深两市所有股票的代码、名称、所属交易所信息，用于后续接口的传递参数。

数据更新：每日16:20更新

字段名称	数据类型	字段说明
dm	string	股票的六位交易代码，例如：000001
mc	string	股票名称，例如：平安银行
jys	string	交易所，"sh"表示上证，"sz"表示深证

实时交易数据接口

API接口：https://api.mairuiapi.com/hsstock/real/time/股票代码(如000001)/您的licence

接口说明：根据《股票列表》得到的股票代码获取实时交易数据（您可以理解为日线的最新数据）。

数据更新：实时

字段名称	数据类型	字段说明
p	number	最新价
o	number	开盘价
h	number	最高价
l	number	最低价
yc	number	前收盘价
cje	number	成交总额
v	number	成交总量
pv	number	原始成交总量
ud	float	涨跌额
pc	float	涨跌幅
zf	float	振幅
t	string	更新时间

买卖五档盘口

API接口：https://api.mairuiapi.com/hsstock/real/five/股票代码(如000001)/您的licence

接口说明：根据《股票列表》得到的股票代码获取实时买卖五档盘口数据。

数据更新：实时

字段名称	数据类型	字段说明
ps	number	委卖价
pb	number	委买价
vs	number	委卖量
vb	number	委买量
t	string	更新时间

最新分时交易

API接口：https://api.mairuiapi.com/hsstock/latest/股票代码.市场（如000001.SZ）/分时级别(如d)/除权方式/您的licence?lt=最新条数(如10)

接口说明：根据《股票列表》得到的股票代码和分时级别获取最新交易数据，交易时间升序。目前分时级别支持5分钟、15分钟、30分钟、60分钟、日线、周线、月线、年线，对应的请求参数分别为5、15、30、60、d、w、m、y，日线以上除权方式有不复权、前复权、后复权、等比前复权、等比后复权，对应的参数分别为n、f、b、fr、br，分钟级无除权数据，对应的参数为n。同时可以指定获取数据条数，例如指定lt=10，则获取最新的10条数据。

数据更新：实时

字段名称	数据类型	字段说明
t	string	交易时间
o	float	开盘价
h	float	最高价
l	float	最低价
c	float	收盘价
v	float	成交量
a	float	成交额
pc	float	前收盘价
sf	int	停牌 1停牌，0 不停牌

当天逐笔交易

API接口：http://api.mairuiapi.com/hsrl/zbjy/股票代码(如000001)/您的licence

接口说明：根据《股票列表》得到的股票代码获取当天逐笔交易数据，按时间倒序。

数据更新：每日21:00

字段名称	数据类型	字段说明
d	string	数据归属日期（yyyy-MM-dd）
t	string	时间（HH:mm:dd）
v	number	成交量（股）
p	number	成交价
ts	number	交易方向（0：中性盘，1：买入，2：卖出）

历史分时交易

API接口：https://api.mairuiapi.com/hsstock/history/股票代码.市场（如000001.SZ）/分时级别(如d)/除权方式/您的licence?st=开始时间(如20240601)&et=结束时间(如20250430)&lt=最新条数(如100)

接口说明：根据《股票列表》得到的股票代码和分时级别获取历史交易数据，交易时间升序。目前分时级别支持5分钟、15分钟、30分钟、60分钟、日线、周线、月线、年线，对应的请求参数分别为5、15、30、60、d、w、m、y，日线以上除权方式有不复权、前复权、后复权、等比前复权、等比后复权，对应的参数分别为n、f、b、fr、br，分钟级无除权数据，对应的参数为n。开始时间以及结束时间的格式均为 YYYYMMDD 或 YYYYMMDDhhmmss，例如：‘20240101’ 或’20241231235959’。不设置开始时间和结束时间则为全部历史数据。同时可以指定获取数据条数，例如指定lt=10，则获取最新的10条数据。

数据更新：分钟级别数据盘中更新，分时越小越优先更新，如5分钟级别会每5分钟更新，15分钟级别会每15分钟更新，以此类推，日线及以上级别每日15:30开始更新，预计17:10完成

字段名称	数据类型	字段说明
t	string	交易时间
o	float	开盘价
h	float	最高价
l	float	最低价
c	float	收盘价
v	float	成交量
a	float	成交额
pc	float	前收盘价
sf	int	停牌 1停牌，0 不停牌

历史分时KDJ

API接口：http://api.mairuiapi.com/hsstock/history/kdj/股票代码(如000001.SZ)/分时级别(如d)/除权类型(如n)/您的licence?st=开始时间&et=结束时间&lt=最新条数

接口说明：根据《股票列表》得到的股票代码和分时级别获取历史KDJ数据，交易时间升序。目前分时级别支持5分钟、15分钟、30分钟、60分钟、日线、周线、月线、年线，对应的请求参数分别为5、15、30、60、d、w、m、y，日线以上除权方式有不复权、前复权、后复权、等比前复权、等比后复权，对应的参数分别为n、f、b、fr、br，分钟级仅限请求不复权数据，对应的参数为n。开始时间以及结束时间的格式均为 YYYYMMDD 或 YYYYMMDDhhmmss，例如：‘20240101’ 或’20241231235959’。不设置开始时间和结束时间则为全部历史数据。同时可以指定获取数据条数，例如指定lt=10，则获取最新的10条数据。

数据更新：分钟级别数据盘中更新，分时越小越优先更新，如5分钟级别会每5分钟更新，15分钟级别会每15分钟更新，以此类推，日线及以上级别每日15:35更新

字段名称	数据类型	字段说明
t	string	交易时间，短分时级别格式为yyyy-MM-ddHH:mm:ss，日线级别为yyyy-MM-dd
k	number	K值
d	number	D值
j	number	J值

历史分时MACD

API接口：http://api.mairuiapi.com/hsstock/history/macd/股票代码(如000001.SZ)/分时级别(如d)/除权类型(如n)/您的licence?st=开始时间&et=结束时间&lt=最新条数

接口说明：根据《股票列表》得到的股票代码和分时级别获取历史MACD数据，交易时间升序。目前分时级别支持5分钟、15分钟、30分钟、60分钟、日线、周线、月线、年线，对应的请求参数分别为5、15、30、60、d、w、m、y，日线以上除权方式有不复权、前复权、后复权、等比前复权、等比后复权，对应的参数分别为n、f、b、fr、br，分钟级仅限请求不复权数据，对应的参数为n。开始时间以及结束时间的格式均为 YYYYMMDD 或 YYYYMMDDhhmmss，例如：‘20240101’ 或’20241231235959’。不设置开始时间和结束时间则为全部历史数据。同时可以指定获取数据条数，例如指定lt=10，则获取最新的10条数据。

数据更新：分钟级别数据盘中更新，分时越小越优先更新，如5分钟级别会每5分钟更新，15分钟级别会每15分钟更新，以此类推，日线及以上级别每日15:35更新

字段名称	数据类型	字段说明
t	string	交易时间，短分时级别格式为yyyy-MM-ddHH:mm:ss，日线级别为yyyy-MM-dd
diff	number	DIFF值
dea	number	DEA值
macd	number	MACD值
ema12	number	EMA（12）值
ema26	number	EMA（26）值

历史分时MA

API接口：http://api.mairuiapi.com/hsstock/history/ma/股票代码(如000001.SZ)/分时级别(如d)/除权类型(如n)/您的licence?st=开始时间&et=结束时间&lt=最新条数

接口说明：根据《股票列表》得到的股票代码和分时级别获取历史MA数据，交易时间升序。目前分时级别支持5分钟、15分钟、30分钟、60分钟、日线、周线、月线、年线，对应的请求参数分别为5、15、30、60、d、w、m、y，日线以上除权方式有不复权、前复权、后复权、等比前复权、等比后复权，对应的参数分别为n、f、b、fr、br，分钟级仅限请求不复权数据，对应的参数为n。开始时间以及结束时间的格式均为 YYYYMMDD 或 YYYYMMDDhhmmss，例如：‘20240101’ 或’20241231235959’。不设置开始时间和结束时间则为全部历史数据。同时可以指定获取数据条数，例如指定lt=10，则获取最新的10条数据。

数据更新：分钟级别数据盘中更新，分时越小越优先更新，如5分钟级别会每5分钟更新，15分钟级别会每15分钟更新，以此类推，日线及以上级别每日15:35更新

字段名称	数据类型	字段说明
t	string	交易时间，短分时级别格式为yyyy-MM-ddHH:mm:ss，日线级别为yyyy-MM-dd
ma3	number	MA3，没有则为null
ma5	number	MA5，没有则为null
ma10	number	MA10，没有则为null
ma15	number	MA15，没有则为null
ma20	number	MA20，没有则为null
ma30	number	MA30，没有则为null
ma60	number	MA60，没有则为null
ma120	number	MA120，没有则为null
ma200	number	MA200，没有则为null
ma250	number	MA250，没有则为null

历史分时BOLL

API接口：http://api.mairuiapi.com/hsstock/history/boll/股票代码(如000001.SZ)/分时级别(如d)/除权类型(如n)/您的licence?st=开始时间&et=结束时间&lt=最新条数

接口说明：根据《股票列表》得到的股票代码和分时级别获取历史BOLL数据，交易时间升序。目前分时级别支持5分钟、15分钟、30分钟、60分钟、日线、周线、月线、年线，对应的请求参数分别为5、15、30、60、d、w、m、y，日线以上除权方式有不复权、前复权、后复权、等比前复权、等比后复权，对应的参数分别为n、f、b、fr、br，分钟级仅限请求不复权数据，对应的参数为n。开始时间以及结束时间的格式均为 YYYYMMDD 或 YYYYMMDDhhmmss，例如：‘20240101’ 或’20241231235959’。不设置开始时间和结束时间则为全部历史数据。同时可以指定获取数据条数，例如指定lt=10，则获取最新的10条数据。

数据更新：分钟级别数据盘中更新，分时越小越优先更新，如5分钟级别会每5分钟更新，15分钟级别会每15分钟更新，以此类推，日线及以上级别每日15:35更新

字段名称	数据类型	字段说明
t	string	交易时间，短分时级别格式为yyyy-MM-ddHH:mm:ss，日线级别为yyyy-MM-dd
u	number	上轨
d	number	下轨
m	number	中轨