{"id":26451211,"url":"https://github.com/cryptorzz/stocktv-api-java","last_synced_at":"2025-06-18T06:38:53.750Z","repository":{"id":277005384,"uuid":"931015866","full_name":"CryptoRzz/stocktv-api-java","owner":"CryptoRzz","description":"开源StockTV数据，印度股票，马来西亚股票，A股，股票数据源API，一键接入Java版","archived":false,"fork":false,"pushed_at":"2025-02-11T15:46:59.000Z","size":8,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-18T16:41:30.925Z","etag":null,"topics":["india","india-stock","investing-api","java","stock-data"],"latest_commit_sha":null,"homepage":"https://stocktv.top","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/CryptoRzz.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-02-11T15:31:50.000Z","updated_at":"2025-02-11T15:57:07.000Z","dependencies_parsed_at":"2025-02-11T16:39:08.887Z","dependency_job_id":"ef2fc839-9f7a-4965-bc95-e7a547fbbb8a","html_url":"https://github.com/CryptoRzz/stocktv-api-java","commit_stats":null,"previous_names":["cryptorzz/stocktv-api-java"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/CryptoRzz/stocktv-api-java","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CryptoRzz%2Fstocktv-api-java","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CryptoRzz%2Fstocktv-api-java/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CryptoRzz%2Fstocktv-api-java/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CryptoRzz%2Fstocktv-api-java/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/CryptoRzz","download_url":"https://codeload.github.com/CryptoRzz/stocktv-api-java/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CryptoRzz%2Fstocktv-api-java/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":260506668,"owners_count":23019419,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["india","india-stock","investing-api","java","stock-data"],"created_at":"2025-03-18T16:32:38.295Z","updated_at":"2025-06-18T06:38:48.739Z","avatar_url":"https://github.com/CryptoRzz.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# StockTV API Java 客户端\n\n[![License](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)\n[![Java](https://img.shields.io/badge/Java-8%2B-orange)](https://www.oracle.com/java/)\n\nStockTV API 的 Java 客户端实现，提供全球股票、外汇、期货和加密货币市场数据的接入能力。\n\n## 📦 功能特性\n\n- 完整的 API 端点覆盖（股票/外汇/期货/加密货币）\n- 同步 HTTP 请求支持（基于 OkHttp）\n- WebSocket 实时数据支持\n- 类型安全的 JSON 解析（基于 Gson）\n- 模块化设计，易于扩展\n\n## 🚀 快速开始\n\n### 环境要求\n- Java 8+\n- Maven 3.6+\n\n### 安装步骤\n\n1. 克隆仓库\n```bash\ngit clone https://github.com/CryptoRzz/stocktv-api-java.git\n```\n\n2. 构建项目\n\n```bash\nmvn clean install\n```\n\n3. 添加依赖到您的项目\n\n```xml\n\u003cdependency\u003e\n    \u003cgroupId\u003etop.stocktv\u003c/groupId\u003e\n    \u003cartifactId\u003estocktv-api-java\u003c/artifactId\u003e\n    \u003cversion\u003e1.0.0\u003c/version\u003e\n\u003c/dependency\u003e\n```\n\n## 🔧 配置使用\n\n### 初始化客户端\n\n```java\nString apiKey = \"your_api_key_here\"; // 通过官方渠道申请\nStockAPI stockAPI = new StockAPI(apiKey);\n```\n\n### 调用股票API示例\n\n```java\n// 获取印度股票列表\ntry {\n    String response = stockAPI.getStockList(\n        14,   // 国家ID（印度）\n        10,    // 每页数量\n        1      // 页码\n    );\n    System.out.println(\"股票列表: \\n\" + response);\n} catch (IOException e) {\n    System.err.println(\"API调用失败: \" + e.getMessage());\n}\n\n// 获取Nifty50指数数据\nString indicesData = stockAPI.getIndices(14, \"IN\");\n```\n\n### WebSocket 实时数据\n\n```java\nWebSocketClient wsClient = new WebSocketClient(\n    URI.create(\"wss://ws-api.stocktv.top/connect?key=\" + apiKey)) {\n\n    @Override\n    public void onMessage(String message) {\n        System.out.println(\"实时数据: \" + message);\n    }\n\n    @Override\n    public void onError(Exception ex) {\n        ex.printStackTrace();\n    }\n};\n\nwsClient.connect();\n```\n\n## 📚 API 模块概览\n\n| 模块           | 功能描述         | 关键方法示例                              |\n| -------------- | ---------------- | ----------------------------------------- |\n| **StockAPI**   | 股票市场数据     | `getKline()`, `getUpdownList()`           |\n| **ForexAPI**   | 外汇汇率与交叉盘 | `getSparkData()`, `getChartData()`        |\n| **FuturesAPI** | 期货合约行情     | `getFuturesMarket()`, `getFuturesKline()` |\n| **CryptoAPI**  | 加密货币实时数据 | `getKlines()`, `getTickerPrice()`         |\n\n## 🧪 运行测试\n\n```bash\nmvn test -Dtest=StockAPITest#testGetStockList\n```\n\n完整测试套件：\n\n```bash\nmvn test\n```\n\n## 🛠️ 开发指南\n\n### 项目结构\n\n```\nsrc/\n├── main/java/top/stocktv/api/\n│   ├── StockAPI.java       # 股票接口实现\n│   ├── ForexAPI.java       # 外汇接口实现\n│   ├── FuturesAPI.java     # 期货接口实现\n│   ├── CryptoAPI.java      # 加密货币接口\n│   └── utils/\n│       └── ApiUtils.java   # HTTP客户端工具类\n```\n\n### 扩展自定义实现\n\n```java\npublic class CustomAPI extends ApiUtils {\n    public CustomAPI(String apiKey) {\n        super(apiKey);\n    }\n    \n    public CustomResponse getCustomData() throws IOException {\n        String json = get(\"custom/endpoint\", \"param=value\");\n        return new Gson().fromJson(json, CustomResponse.class);\n    }\n}\n```\n\n## 🤝 贡献代码\n\n1. Fork 项目仓库\n2. 创建特性分支 (`git checkout -b feature/awesome-feature`)\n3. 提交修改 (`git commit -m 'Add awesome feature'`)\n4. 推送分支 (`git push origin feature/awesome-feature`)\n5. 创建 Pull Request\n\n## 📄 许可证\n\n本项目采用 [MIT 许可证](LICENSE)\n\n---\n\n**技术支持**：访问 [StockTV 官方文档](https://stocktv.top/) 或 [联系StockTV客服](https://t.me/CryptoRzz)","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcryptorzz%2Fstocktv-api-java","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcryptorzz%2Fstocktv-api-java","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcryptorzz%2Fstocktv-api-java/lists"}