StockTV API 的 Java 客户端实现，提供全球股票、外汇、期货和加密货币市场数据的接入能力。
- 完整的 API 端点覆盖（股票/外汇/期货/加密货币）
- 同步 HTTP 请求支持（基于 OkHttp）
- WebSocket 实时数据支持
- 类型安全的 JSON 解析（基于 Gson）
- 模块化设计，易于扩展
- Java 8+
- Maven 3.6+
- 克隆仓库
git clone https://github.com/CryptoRzz/stocktv-api-java.git- 构建项目
mvn clean install- 添加依赖到您的项目
<dependency>
<groupId>top.stocktv</groupId>
<artifactId>stocktv-api-java</artifactId>
<version>1.0.0</version>
</dependency>String apiKey = "your_api_key_here"; // 通过官方渠道申请
StockAPI stockAPI = new StockAPI(apiKey);// 获取印度股票列表
try {
String response = stockAPI.getStockList(
14, // 国家ID（印度）
10, // 每页数量
1 // 页码
);
System.out.println("股票列表: \n" + response);
} catch (IOException e) {
System.err.println("API调用失败: " + e.getMessage());
}
// 获取Nifty50指数数据
String indicesData = stockAPI.getIndices(14, "IN");WebSocketClient wsClient = new WebSocketClient(
URI.create("wss://ws-api.stocktv.top/connect?key=" + apiKey)) {
@Override
public void onMessage(String message) {
System.out.println("实时数据: " + message);
}
@Override
public void onError(Exception ex) {
ex.printStackTrace();
}
};
wsClient.connect();| 模块 | 功能描述 | 关键方法示例 |
|---|---|---|
| StockAPI | 股票市场数据 | getKline(), getUpdownList() |
| ForexAPI | 外汇汇率与交叉盘 | getSparkData(), getChartData() |
| FuturesAPI | 期货合约行情 | getFuturesMarket(), getFuturesKline() |
| CryptoAPI | 加密货币实时数据 | getKlines(), getTickerPrice() |
mvn test -Dtest=StockAPITest#testGetStockList完整测试套件：
mvn testsrc/
├── main/java/top/stocktv/api/
│ ├── StockAPI.java # 股票接口实现
│ ├── ForexAPI.java # 外汇接口实现
│ ├── FuturesAPI.java # 期货接口实现
│ ├── CryptoAPI.java # 加密货币接口
│ └── utils/
│ └── ApiUtils.java # HTTP客户端工具类
public class CustomAPI extends ApiUtils {
public CustomAPI(String apiKey) {
super(apiKey);
}
public CustomResponse getCustomData() throws IOException {
String json = get("custom/endpoint", "param=value");
return new Gson().fromJson(json, CustomResponse.class);
}
}- Fork 项目仓库
- 创建特性分支 (
git checkout -b feature/awesome-feature) - 提交修改 (
git commit -m 'Add awesome feature') - 推送分支 (
git push origin feature/awesome-feature) - 创建 Pull Request
本项目采用 MIT 许可证
技术支持：访问 StockTV 官方文档 或 联系StockTV客服