EVE Metal · 美股港股 API

白标对接路线图 · 1个月开发 + 2个月售后支持
🇺🇸 美股 (US Stocks) 🇭🇰 港股 (HK Stocks) 🔑 白标多租户 📡 RESTful API
对接周期 30天 · 售后支持 60天
26+
API 端点
2
市场覆盖
30天
对接开发
60天
售后保障

📦 现有基础设施

模块当前状态说明
美股行情 & 交易 ✅ 已就绪 Alpaca API 已集成,支持实时报价、K线、下单、持仓、账户管理
白标多租户架构 ✅ 已就绪 每个客户独立 API Key、费率体系、资金隔离
EVE Metal OAuth2 认证 ✅ 已就绪 SSO 登录服务已运行 (端口 8991),对接 Base44 平台
港股行情数据 🆕 待开发 需接入港交所数据源 (HKEX / 富途 / 老虎证券 OpenAPI)
app.evemetal.com 域名 ⏳ 待配置 需配置 DNS + nginx 反向代理 + SSL 证书

🗺️ 1个月对接路线图

第 1 周 基础架构 & 域名部署
  • DNS 配置:app.evemetal.com → 服务器 IP
  • Nginx 反向代理 + Let's Encrypt SSL 证书
  • 白标 API 服务部署到 app.evemetal.com
  • EVE Metal OAuth2 SSO 与 API 权限打通
  • 管理后台:客户管理、费率配置、运营仪表盘
  • API 文档生成 (Swagger / ReDoc)
📦 交付物:可访问的 API 域名 + 管理后台 + API 文档
第 2 周 美股 API 对接 & 测试
  • 实时行情:个股报价、批量快照、历史K线
  • 交易接口:市价单、限价单、止损单、撤单
  • 账户接口:余额、购买力、持仓、盈亏
  • 费率引擎:按客户配置佣金、最低收费、结算
  • 沙盒环境 (Paper Trading) 开放给客户测试
📦 交付物:美股全功能 API + 沙盒测试环境 + SDK 示例代码
第 3 周 港股数据接入 & API 扩展
  • 接入港股数据源(HKEX / 富途 / 老虎 OpenAPI)
  • 港股实时报价、K线、盘口数据
  • 港币/美元汇率换算
  • 统一 API 接口设计:美股港股同一套调用方
  • 交易时间判断(港交所交易时段)
  • 港股代码映射(如 00700 → 腾讯控股)
📦 交付物:港股行情 API + 统一美股港股接口
第 4 周 联调验收 & 上线
  • 客户技术团队联调测试(提供技术支持)
  • 压力测试 & 性能优化
  • 安全审计:API Key 加密、速率限制、IP 白名单
  • 监控告警:服务健康检查、异常自动通知
  • 生产环境上线 + 切换
  • 操作手册 & 技术培训文档交付
📦 交付物:生产环境上线 + 技术文档 + 培训

🔌 API 接口预览

接口方法说明市场
/v1/market/quotesGET实时报价🇺🇸 🇭🇰
/v1/market/snapshotsGET批量快照 (OHLCV)🇺🇸 🇭🇰
/v1/market/barsGET历史K线🇺🇸 🇭🇰
/v1/assetsGET股票搜索🇺🇸 🇭🇰
/v1/clockGET市场开收盘状态🇺🇸 🇭🇰
/v1/ordersPOST下单 (市价/限价/止损)🇺🇸
/v1/ordersGET查询订单🇺🇸
/v1/orders/{id}DELETE撤单🇺🇸
/v1/positionsGET持仓查询🇺🇸
/v1/accountGET账户信息🇺🇸
/v1/admin/clientsGET客户管理 (Admin)
/v1/admin/statsGET运营数据 (Admin)
# 获取腾讯控股实时报价 curl https://app.evemetal.com/v1/market/quotes \ -H "X-API-Key: ev_live_xxxx" \ -G --data "symbols=00700.HK,AAPL" # 响应 { "quotes": { "00700.HK": { "price": 385.40, "currency": "HKD", "change_pct": +1.23 }, "AAPL": { "price": 275.15, "currency": "USD", "change_pct": -0.41 } } }

🛡️ 2个月售后支持计划

🔧 技术保障

第 1-2 个月(上线后 60 天)
  • API 接口 Bug 修复 & 热更新
  • 数据源切换/降级保障
  • 港股数据源稳定性维护
  • SSL 证书续期 & 服务器维护
  • 数据库备份 & 灾难恢复

📞 响应服务

工作日响应 · 紧急 7×24
  • Telegram/微信 群技术支持
  • P0 紧急问题:2小时内响应
  • P1 一般问题:当天响应
  • P2 咨询问题:24小时内回复
  • 每周一次定期同步会议

📈 功能迭代

售后期内免费
  • 新股票代码/ETF 支持
  • API 性能优化
  • 文档更新 & SDK 维护
  • 管理后台功能增强
  • 小范围需求变更(≤3人日)

📊 运营支持

数据驱动
  • API 调用量监控报告
  • 错误率 & 延迟仪表盘
  • 月度运营数据报表
  • 客户反馈收集 & 改进
  • 上线满月复盘 + 优化建议

🎯 关键里程碑

时间节点里程碑验收标准
Day 7 API 域名上线 app.evemetal.com 可访问,管理后台可用,API 文档发布
Day 14 美股沙盒开放 客户可测试全部美股 API,沙盒环境稳定运行
Day 21 港股数据接入 港股行情可查询,延迟 <3秒,代码映射完整
Day 30 正式上线 生产环境通过验收,客户联调完成,交付全部文档
Day 60 第一个月售后复盘 稳定性 ≥99.5%,累计 Bug 修复完成
Day 90 售后期满交接 交付运维手册,培训客户技术团队,可选续约

🏗️ 技术架构

层级技术说明
API 层FastAPI + Uvicorn高性能异步框架,OpenAPI 自动文档
认证层OAuth2 SSO + API KeyEVE Metal 统一登录 + 每租户密钥
美股数据Alpaca Markets API实时行情 + 模拟交易 + 历史数据
港股数据HKEX / 富途 / 老虎 OpenAPI实时报价 + K线 + 盘口
数据库SQLite → PostgreSQL租户隔离、订单记录、费率结算
部署Nginx + SSL + systemd反向代理、自动续期、进程守护
监控健康检查 + 告警异常自动通知,SLA 保障

准备好开始了吗?

KOPI AI · 企业级金融 API 解决方案

联系我们 →