SuperAPI AI 工具集

@1363/position-snapshot

通用与其它

查看项目

更新于 10-16 09:31

技能介绍

用途:根据用户持仓与行情数据,生成带持仓叠加层的 OHLC 蜡烛图,用于直观查看开仓价、未成交限价单、盈亏以及自定义价格区间相对价格走势的位置。适用时机:用户要求查看其仓位图表、查看订单相对价格的位置,或表达“看看我们现在在哪”“把我的仓位画出来”等意图。

工作流程:先获取持仓数据(调用 hl_account() 或 orderly_positions() 取得开仓价、数量、方向、未实现盈亏、杠杆、强平价),再获取未成交挂单(hl_open_orders()),然后获取 OHLC 数据(hl_candles(coin=ASSET, interval="4h", lookback=336) 得到 14 天 4 小时 K 线,可按需调整),最后运行渲染脚本并展示 output/ 目录下的图表。

使用方式:运行 python skills/position-snapshot/scripts/render_position_chart.py,通过参数传入 --coin、--side、--entry、--size、--leverage、--pnl、--roe、--current-price 等必填项,可选 --liq-price、--candles、--orders、--zones、--output、--interval、--title。K 线 JSON 为 {t,o,h,l,c} 数组,订单 JSON 为 {price,size,side} 数组,zones 为 {"名称": [低, 高]} 格式。

主要能力:默认深色主题,绿红蜡烛、金色开仓价、青色现价、橙色限价单;命名区间渲染为带标签阴影区域;多空自适应(多头开仓价显示在现价下方,空头在上方);自动生成含持仓详情、挂单数量和区间标签的汇总信息框。

限制:脚本自包含,无网络调用,所有数据需通过参数或文件传入;可适配任意交易所数据,只需 K 线符合 {t,o,h,l,c} 格式,Hyperliquid 的 hl_candles() 原生支持,Orderly 等其他交易所需先转换;图表颜色、定价、平台与收费等更多细节暂未提供。