type
status
date
slug
summary
tags
category
icon
password

📈股票市场信息集成

这是一个Home Assistant自定义集成,用于获取和显示全球股票市场的实时行情数据,基于新浪财经数据源。
💡
地址:

功能特性

  • 支持添加多个股票代码
  • 显示股票的实时价格、涨跌幅、涨跌额等关键信息
  • 支持全球多个股票市场(上证、深证、港股、美股等)
  • 支持自定义刷新间隔
  • 动态显示货币单位
  • 遵循Home Assistant的标准单位属性规范

安装方法

通过HACS(推荐)

  1. 打开HACS
  1. 点击"集成"
  1. 点击右上角的三个点,选择"自定义存储库"
  1. 添加此存储库的URL
  1. 搜索"股票市场信息"并安装

手动安装

  1. 下载集成的ZIP文件
  1. 解压并将stock_market文件夹复制到Home Assistant的config/custom_components/目录下
  1. 重启Home Assistant

配置方法

  1. 在Home Assistant中,前往"配置" > "集成" > "添加集成"
  1. 搜索并选择"股票市场信息"
  1. 在配置表单中填写以下信息:
      • 股票符号:新浪财经格式的股票符号,如sh000001(上证)、sh600519(贵州茅台)
      • 股票名称:自定义的股票名称
  1. 点击"提交"完成配置
示例股票符号
  • 上证指数:sh000001
  • 深圳成指:sz399001
  • 贵州茅台:sh600519
  • 招商银行:sh600036
  • 比亚迪:sz002594
  • 美股(纳斯达克、纽约证券交易所):
    • 苹果(NASDAQ):gb_aapl
    • 微软(NASDAQ):gb_msft
    • 亚马逊(NASDAQ):gb_amzn
    • 特斯拉(NASDAQ):gb_tsla
    • 谷歌(NASDAQ):gb_googl
    • VRT(NYSE):gb_vrt
  • 美股指数:
    • 纳斯达克综合指数:gb_ixic
    • 道琼斯工业平均指数:gb_dji
    • 标普500指数:gb_spx
  • 港股:
    • 腾讯控股:hk00700
    • 阿里巴巴:hk9988

实体属性

每个股票实体提供以下属性:
  • 状态:当前价格(动态货币单位)
  • 额外属性
    • stock_name: 股票名称
    • stock_code: 股票代码
    • change_percent: 涨跌幅(%)
    • change_amount: 涨跌额
    • prev_close: 昨收价
    • volume: 成交量
    • currency: 货币类型
    • timestamp: 数据更新时间

自定义选项

在集成配置完成后,您可以通过以下步骤调整刷新间隔:
  1. 前往"配置" > "集成"
  1. 找到已配置的"股票市场信息"集成
  1. 点击"选项"
  1. 调整"数据刷新间隔(秒)"(最小值30秒,最大值86400秒)
  1. 点击"提交"保存更改

注意事项

  • 本集成基于新浪财经公开API,主要支持A股市场
  • 数据刷新频率过高可能导致API访问限制,建议合理设置刷新间隔
  • 建议设置合理的刷新间隔(默认10800秒,即3小时)
  • 新浪财经主要支持A股市场,对于港股和美股的支持有限
  • 数据仅供个人学习和研究使用

故障排除

常见问题

  1. 实体状态显示为"未知"
      • 检查股票代码和市场类型是否正确
      • 等待几分钟,让集成有时间获取数据
      • 检查Home Assistant日志中的错误信息
  1. 无法添加集成
      • 确保您的Home Assistant版本符合要求(2023.8.0或更高)
      • 检查custom_components目录中的文件是否完整

更新日志

0.4.0

  • 重大更新:移除雅虎金融支持,仅保留新浪财经数据源
  • 简化了配置流程,移除数据源选择选项
  • 优化了代码结构,移除了不必要的雅虎金融相关代码
  • 简化了README文档,只保留新浪财经相关信息

0.3.0

  • 重大更新:新增支持新浪财经数据源,解决雅虎金融在某些地区无法访问的问题
  • 支持在配置时选择数据源(雅虎金融或新浪财经)
  • 优化了数据处理逻辑,适配不同数据源的数据结构
  • 动态显示不同数据源的制造商信息
  • 修复:解决了config_flow.py文件截断导致配置失败的问题

0.2.0

  • 重大更新:将API从东方财富网切换到雅虎金融
  • 支持全球多个股票市场
  • 动态显示货币单位
  • 新增市值、平均成交量等属性
  • 简化了配置流程
  • 修复:实现了crumb和cookie认证,解决了401未授权错误
  • 修复:添加了对大响应头的支持,解决了"Got more than 8190 bytes"错误
  • 优化:修改了timestamp属性的显示格式,从Unix时间戳改为可读的时间日期格式
  • 优化:调整了最小刷新间隔,从600秒改为30秒,与参考集成保持一致
  • 优化:改进了错误处理和重试机制,提高了集成的稳定性

0.1.1

  • 修复:解决设备名称配置问题,确保设备名称与实体名称(股票名称)保持一致
  • 优化:移除不再使用的常量导入

0.1.0

  • 初始版本发布
  • 支持添加多个股票代码
  • 显示实时价格、涨跌幅、成交量等关键数据
  • 支持自定义刷新间隔

感谢

本集成基于新浪财经的公开API,感谢新浪财经提供的服务。
 

☝应用展示

💡
有关问题,欢迎您在底部评论区留言,一起交流~
home assistant UI篇-股票行情展示计算机网络- iStoreOS域名解析时好时坏问题
Loading...