HyperX 数据 API

基础 URL：https://data-api.hyperx.trade

Hyperliquid 链上分析 API — 钱包盈亏、市场持仓、加密货币推特、新闻推送。

身份验证

方法	请求头/字段	获取方式
API 令牌	X-API-Key: <token>	登录 hyperx.trade → 设置 → API 令牌
Cookie

HyperX 会话 Cookie | 登录 hyperx.trade |

获取 API 密钥：访问 hyperx.trade/hyperliquid/settings，使用您的账户登录，并在 API 令牌 部分生成一个令牌。提供免费套餐。

推特和新闻接口 免费，无需身份验证。

速率限制

套餐	每分钟预算	每月	价格
免费	30	10,000	$0
专业

300 | 500,000 | $99/月 | | 超级 | 1,200 | 5,000,000 | $399/月 |

每个接口都有 权重（1–5）。每次调用从您的预算中消耗 权重 额度。

接口

钱包分析

方法	路径	权重	身份验证	描述
POST	/walletanalysis/{address}	5	可选	包含持仓、交易、风险指标的完整钱包盈亏分析
GET

/walletmetrics/{address} | 2 | 无 | 预计算的钱包表现指标（胜率、投资回报率、盈亏） | | POST | /walletmetricsquery | 2 | 可选 | 带筛选和排序的批量钱包指标查询 | | GET | /fills/{address} | 5 | 可选 | 钱包地址的交易历史（成交记录） | | WS | /fills/ws | 5/条 | 可选 | 实时成交流。地址限制：免费=1，专业=50，超级=300 |

市场分析

所有 权重 1，无需身份验证。

方法	路径	描述
GET	/market/coins	所有可交易币种及元数据
GET

/market/snapshots | 市场概览快照 |
| GET | /market/overview | 聚合市场概览 |
| GET | /market/aggregate-positions | 跨资产聚合持仓数据 |
| GET | /market/top-positions/{asset} | 特定资产的顶级持仓 |
| GET | /market/leverage-distribution/{asset} | 杠杆分布 |
| GET | /market/pnl-distribution/{asset} | 盈亏分布 |
| GET | /market/concentration/{asset} | 持仓集中度分析 |
| GET | /market/whale-changes/{asset} | 大户持仓变动追踪 |
| GET | /market/entry-price/{asset} | 入场价格分布 |
| GET | /market/high-leverage-whales/{asset} | 高杠杆大户持仓 |
| GET | /market/top-losers/{asset} | 亏损最多的持仓 |
| GET | /market/top-winners/{asset} | 盈利最多的持仓 |
| GET | /market/liquidation-heatmap/{asset} | 清算价格热力图 |
| GET | /market/liquidation-positions/{asset} | 接近清算的持仓 |

时间分布

所有 权重 1，身份验证可选。

方法	路径	描述
GET	/wallet/time-distribution/{address}/hourly	每小时交易活动
GET

/wallet/time-distribution/{address}/day-of-week | 星期几模式 |
| GET | /wallet/time-distribution/{address}/heatmap | 完整活动热力图（小时 × 天） |
| GET | /wallet/time-distribution/{address}/daily | 每日交易量 |

推特（免费）

所有 权重 1，无需身份验证。

方法	路径	描述
GET	/twitter	带筛选功能的推特推送
GET

/twitter/authors | 按推文数量排名的活跃作者 |
| WS | /twitter/ws | 实时推特推送流 |

GET /twitter 参数：

参数	类型	描述
screenname	字符串	按作者筛选，逗号分隔
minfollowers

整数 | 最低粉丝数 |
| user_tags | 字符串 | 按标签筛选：trader、kol、founder、featured |
| tweet_type | 字符串 | reply、quote、retweet |
| keyword | 字符串 | 内容关键词搜索 |
| hours | 整数 | 时间范围（小时，1–168，默认 24） |
| page / page_size | 整数 | 分页（每页最多 100 条） |

响应字段：

json
{
id: 12345,
sfe_id: a2552b68aad7c9fa,
tweet_type: reply,
tweet_id: 2032041519130296698,
tweet_time: 2026-03-12T10:30:26,
content: 推文内容...,
screen_name: elonmusk,
display_name: 埃隆·马斯克,
avatar_url: https://pbs.twimg.com/...,
follower_count: 694593,
user_tags: [founder, featured],
tweetinteractiontype: reply,
media: [{t: image, u: https://...}],
source_tweet: {
tweet_id: ...,
content: 原始推文...,
screen_name: ...,
follower_count: 24977,
media: []
}
}

WS /twitter/ws 参数： screennames、minfollowers、user_tags（与 REST 相同的筛选条件）。消息为 JSON 对象，字段与 REST 响应项相同。

新闻（免费）

所有 权重 1，无需身份验证。

方法	路径	描述
GET	/news	来自多个来源的交易新闻
GET

/news/channels | 可用的新闻频道分类 |

比特币挖矿

方法	路径	权重	身份验证	描述
GET	/btc-mining/shutdown-prices	1	无	按矿机型号划分的比特币挖矿关机价格

快速开始

python
import requests

BASE = https://data-api.hyperx.trade

推特无需身份验证

tweets = requests.get(f{BASE}/twitter, params={hours: 1, min_followers: 10000}).json() for t in tweets[items]: print(f@{t[screen_name]}: {t[content]})

钱包分析需要 API 密钥（在 hyperx.trade/hyperliquid/settings 获取）

headers = {X-API-Key: your-api-key} pnl = requests.post(f{BASE}/wallet_analysis/0x1234..., headers=headers).json()

python

WebSocket — 实时推特流

import asyncio, websockets, json

async def stream():
async with websockets.connect(fwss://data-api.hyperx.trade/twitter/ws?min_followers=5000) as ws:
async for msg in ws:
tweet = json.loads(msg)
print(f@{tweet[screen_name]}: {tweet.get(content, )})

asyncio.run(stream())

API 目录接口

GET /api-catalog — 返回包含动态权重的完整结构化目录（JSON 格式）。