SuperAPI AI 工具集

portal-query-hyperliquid-fills

通用与其它

查看项目

更新于 10-16 06:15

技能介绍

用途:该技能用于构造 SQD Portal Stream API 查询,获取 Hyperliquid 永续合约交易所的成交(fills)数据,支持追踪交易活动、分析盈亏、监控特定交易者,以及按币种、方向或用户地址过滤。

主要能力:查询 Hyperliquid 已完成交易,每条 fill 包含价格、数量、方向、盈亏与手续费数据。可过滤 coin(如 BTC、ETH)、user 地址、side("B" 买入/"A" 卖出)。可获取 closedPnl、fee、feeToken、dir、startPosition、hash、oid、tid、crossed、cloid、builderFee 等字段。

使用方式:向 /datasets/hyperliquid-fills/stream 发送 POST 请求。查询结构需使用 "type": "hyperliquidFills",指定 fromBlock/toBlock(数据集起始于区块 750000000),fills 为过滤对象数组({} 匹配全部),fields 必须使用 "fill" 键。若环境提供 Portal MCP 工具,可优先使用 portal_query_hyperliquid_fills 进行标准查询,原始 Stream API 适合自定义字段选择、builder fee 分析或大规模流式导出。

关键概念:时间戳为毫秒(与 EVM 的秒不同);side 仅用单字符 "B"/"A";dir 有 9 种取值,如 Open Long、Close Short、Long > Short、Buy、Sell、Net Child Vaults 等;closedPnl 仅在平仓交易时非零;fee 可为负(做市返佣);净盈亏 = sum(closedPnl) - sum(fee)。

常见错误:误用 "type": "evm";用秒而非毫秒;使用完整 side 名称;fields 下用 "log" 而非 "fill";查询早于 750000000 的区块;混淆 hyperliquid-fills 与 hyperliquid-mainnet/testnet 数据集。

响应格式:Portal 返回 JSON Lines,每行一个 JSON 对象,首行为区块头,按换行拆分逐行解析。

限制:数据集起始区块为 750000000;时间戳为毫秒;side 与 dir 取值固定;具体收费、价格与平台信息暂未提供。