Hacktoberfest 2026: los issues que los mantenedores marcaron para octubre, abiertos y aptos para principiantes. Explorar issues de Hacktoberfest

【开源自荐】stock-sdk:浏览器前端和 Node.js 都能直接调用的股票行情 SDK,零依赖、TypeScript 全类型、单测覆盖

Abierto
#109 0 comentarios 0 reacciones 0 asignados Ver en GitHub

Nadie ha tomado este issue todavía.

Evaluación

Dificultad
1/5
Tiempo estimado
Menos de una hora
Aptitud para principiantes
20/100
Tipo de issue
Documentación
Claridad
Necesita aclaración
Estado de actividad
Tranquilo
Stack tecnológico
node.js, typescript
Área
content

Línea de trabajo

Esto es una recomendación del propio proyecto, no una solicitud de cambio de código, y no menciona ningún archivo, prueba ni punto de entrada del repositorio semanal. Revisa primero la página del proyecto enlazada, la documentación, el Playground y el paquete npm; en el issue no se especifican criterios de finalización para un cambio en el repositorio.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

项目地址:https://github.com/chengzuopeng/stock-sdk
官方文档:https://stock-sdk.linkdiary.cn/
在线 Playground:https://stock-sdk.linkdiary.cn/playground/
NPM:https://www.npmjs.com/package/stock-sdk
看板 Demo:https://chengzuopeng.github.io/stock-dashboard/

一句话:给前端工程师的股票行情 SDK —— 不写 Python、不搭后端、不开代理,浏览器里就能直接拉 A 股 / 港股 / 美股 / 基金 / 期货 / 期权 的实时行情和 K 线。

背景

股票行情工具几乎都活在 Python 生态里(AkShare、tushare、baostock 一统天下)。前端做个看板、写个 Demo、跑个量化原型,要么得搭一层 Python 后端,要么得自己去戳腾讯/东方财富/雪球的接口、踩 GBK 编码、CORS、JSONP、并发限流的所有坑。

stock-sdk 把这些活全干完了:浏览器端用 Script Tag Injection(JSONP)跨域,Node.js 端走标准 fetch,同一份 API 两端跑。

亮点
  • 🌐 浏览器 + Node.js 双端:同一份代码,浏览器里靠 JSONP 直连数据源,没有 CORS,不用配代理
  • 📦 零依赖、轻量:发布包 gzip 后 ~27 KB,ESM + CJS 双格式
  • 🧠 完整 TypeScript 类型:所有接口、字段、错误码都有类型,IDE 自动补全
  • 📈 覆盖面广:A 股、港股、美股、公募基金的实时行情;日/周/月 K 线和 1/5/15/30/60 分钟 K 线;当日分时
  • 🔢 14 个内置技术指标:MA / MACD / BOLL / KDJ / RSI / WR / BIAS / CCI / ATR / OBV / ROC / DMI / SAR / KC
  • 🏛️ 专业数据:龙虎榜、北向资金、资金流向、盘口大单、涨停池、大宗交易、融资融券、期货库存
  • 🛡️ 请求治理:内置重试、限流、熔断、批量并发控制,可按 provider 维度覆盖
  • 🤖 AI / MCP 就绪:配套 stock-sdk-mcp,一行 npx 即可接入 Cursor / Claude Desktop / Gemini / Codex / OpenClaw,内置技术分析、智能选股、市场概览、实时监控 4 个 Skills
使用示例

ts
import { StockSDK } from 'stock-sdk';
const sdk = new StockSDK();
// 浏览器也可直接调用
await sdk.getSimpleQuotes(['sh600519']); // A 股
await sdk.getHKQuotes(['hk00700']); // 港股
await sdk.getUSQuotes(['usAAPL.O']); // 美股
await sdk.getKLine('sh600519', 'day'); // K 线
await sdk.getNorthboundFlow(); // 北向资金
await sdk.getDragonTigerList(); // 龙虎榜
await sdk.getAllAShareQuotes(); // 全市场 5000+ 只一次拉

14 个技术指标(MA / MACD / BOLL / KDJ / RSI / ATR / DMI / SAR / KC …)和期货、期权、融资融券都有。完整 TypeScript 类型,发布包 gzip 27 KB。

Image
Lenguaje dominante
Sin datos de lenguaje
Estrellas
1.8k
Forks
71
Métricas de merge de PR
Sin PR fusionados en 30 d

Preparar el entorno

Este proyecto no incluye contenedor de desarrollo, Dockerfile ni guía de contribución, así que la configuración corre por tu cuenta: empieza por su README y consulta nuestra guía para la primera contribución para los pasos generales.

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de OpenGithubs/weekly

Todos los issues de OpenGithubs/weekly

Issues similares

Más issues de Content

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.