Aicoin Hyperliquid
Hyperliquid on-chain perpetuals analytics from AiCoin Open API v3 — the primary source for on-chain whale / smart-money / large-fund movement. Use this skill... Skill: Aicoin Hyperliquid Owner: procaross Summary: Hyperliquid on-chain perpetuals analytics from AiCoin Open API v3 — the primary source for on-chain whale / smart-money / large-fund movement. Use this skill... Tags: latest:4.0.0 Version history: v4.0.0 | 2026-05-21T07:35:54.317Z | user 同步最新仓库变更:set-key 支持直接喂后台 JSON + install-test 实测修正 (catalog 分组冲突 / 403 信封归一) v3.2.4 | 2026-03-10T16:42:24.783Z | auto - No code or
Rank
62
Safety
84
Downloads
983
Updated
Oct 11, 2026
Version
4.0.0
Source
CLAWHUB
About
What it does, and when to use it.
Capability contract not published. No trust telemetry is available yet. 983 downloads reported by the source. Last updated 10/11/2026.
Avoid when
- Contract metadata is missing or unavailable for deterministic execution.
Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing
Public facts
Every fact links back to the source it came from.
- Vendor
- Clawhubvendor · observed Oct 11, 2026
- Protocol compatibility
- OpenClawcompatibility · observed Oct 11, 2026
- Adoption signal
- 983 downloadsadoption · observed Oct 11, 2026
- Latest release
- 4.0.0release · observed May 21, 2026
- Handshake status
- UNKNOWNsecurity
What changed
Newest first. Only changes that point at a source are listed.
Release 4.0.0release
同步最新仓库变更:set-key 支持直接喂后台 JSON + install-test 实测修正 (catalog 分组冲突 / 403 信封归一)
Observed May 21, 2026 · source
Install and run
Setup complexity: low.
clawhub skill install s175bxjmb4brzmpkpbfqaqpc3d872sdw:aicoin-hyperliquid- Setup complexity is classified as HIGH. You must provision dedicated cloud infrastructure or an isolated VM. Do not run this directly on your local workstation.
- Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.
Contract: missing
curl -s "https://www.xpersona.co/api/v1/agents/clawhub-procaross-aicoin-hyperliquid/snapshot"
Run-check
$0.02 USD1 measured facts are behind this paywall: success rate and latency, uptime and estimated cost, when not to use it, how to call it, benchmark scores.
Agents pay $0.02 in USDC. A card payment is $0.50, the smallest a card allows.
Documentation
CLAWHUB
146,900 characters of source documentation, loaded on request.
Extracted files
5 files captured from the source.
SKILL.md
---
name: aicoin-hyperliquid
description: "Hyperliquid on-chain perpetuals analytics from AiCoin Open API v3 — the primary source for on-chain whale / smart-money / large-fund movement. Use this skill when the user asks about: Hyperliquid whale positions, HL liquidations, HL open interest, HL trader analytics, HL taker flow, HL funding history, AND generic on-chain whale activity — '链上大资金动向', '链上鲸鱼', '聪明钱', '大户在干嘛', 'on-chain whale', 'smart money', 'Hyperliquid大户', 'HL鲸鱼', 'HL持仓', 'HL清算', 'HL持仓量', 'HL交易员', 'HL 资金费率' — because HL is the deepest on-chain perp venue and AiCoin exposes its whale positions / events / liquidations / trader stats without needing any wallet key. For general crypto prices/news use aicoin-market; for DEX swaps / wallets use aicoin-onchain; for CEX trading use aicoin-trading; for Freqtrade use aicoin-freqtrade."
metadata: { "openclaw": { "primaryEnv": "AICOIN_ACCESS_KEY_ID", "requires": { "bins": ["node"] }, "homepage": "https://www.aicoin.com/opendata", "source": "https://github.com/aicoincom/coinos-skills", "license": "MIT" } }
---
# AiCoin Hyperliquid
Hyperliquid whale tracking and trader analytics from the [AiCoin Open API v3](https://www.aicoin.com/opendata).
> 从 SKILL.md 所在目录运行脚本。CoinClaw 三引擎容器(OpenClaw / Hermes / Claude Code)自动注入 skill 路径,`cd` 到 skill 目录即可。
## 怎么用
一个命令调所有接口:
```
node scripts/aicoin.mjs <接口> '<JSON 参数>'
```
`<接口>` 就是 `/api/v3/` 后面那段路径,HL 的都在 `hyperliquid/` 下。
- 返回**统一信封** `{ ok, data, error, meta }` —— **先看 `ok`**。`ok:false` 看 `error.code` / `error.message`。
- 不确定有哪些接口、参数怎么填 → `node scripts/aicoin.mjs catalog hyperliquid`。catalog 是线上实时菜单,永远准。
- 想知道当前 key 能用哪些接口 → `node scripts/aicoin.mjs key`。
```
node scripts/aicoin.mjs catalog hyperliquid # HL 全部接口 + 参数
node scripts/aicoin.mjs hyperliquid/ticker '{"coin":"BTC"}'
node scripts/aicoin.mjs hyperliquid/whales/open-positions '{"coin":"BTC"}'
```
## 常用接口速查
| 想查什么 | 接口 + 例子 |
|---|---|
| 全币种行情 / 单币行情 | `hyperliquid/tickers` / `hyperliquid/ticker '{"coin":"BTC"}'` |
| 大户当前持仓 | `hyperliquid/whales/open-positions '{"coin":"BTC","top_by":"position-value"}'` |
| 大户最新动作 | `hyperliquid/whales/latest-events '{"limit":20}'` |
| 大户多空方向 / 历史多空比 | `hyperliquid/whales/directions '{"coin":"BTC"}'` / `hyperliquid/whales/history-long-ratio` |
| 清算历史 / 统计 | `hyperliquid/liquidations/history '{"coin":"BTC","interval":"1d"}'` / `hyperliquid/liquidations/stat '{"coin":"BTC","interval":"1d"}'` —— 问"近 24h"务必传 `interval`,默认窗口很短会返回全 0 |
| 大额待清算仓位 | `hyperliquid/liquidations/top-positions '{"coin":"BTC","interval":"1d"}'` |
| 持仓量 汇总 / 排名 / 历史 | `hyperliquid/open-interest/summary` / `hyperliquid/open-interest/top-coins` / `hyperliquid/open-interest/history '{"coin":"BTC"}'` |
| 主动买卖差 / 带主动量 K 线 | `hyperliquid/accumulated-taker-delta '{"coin":"BTC"}'` / `hyperliquid/klines-with-taker-volume '{"coin":"BTC","interval":"4h"}'` |
| 地址交易统计 / 胜率详情 | `hyperliquid/traders/stat '{"address":"0x..."}'` / `hyperliquid/traders/detailed-trading-statistics '{"add_meta.json
{
"ownerId": "kn744cgmrtxwys18mxjhzaapn582553w",
"slug": "aicoin-hyperliquid",
"version": "4.0.0",
"publishedAt": 1779348954317
}skill-card.md
## Description: Provides agent guidance and shell commands for querying AiCoin Open API v3 Hyperliquid analytics, including whale positions, liquidations, open interest, trader statistics, taker flow, and funding data. This skill is ready for commercial/non-commercial use. ## Publisher: [procaross](https://clawhub.ai/user/procaross) ### License/Terms of Use: MIT-0 ## Use Case: External developers, analysts, and agents use this skill to query AiCoin's Hyperliquid market and on-chain analytics, inspect whale activity, liquidations, trader performance, open interest, taker flow, and funding data, and summarize real API results. ### Deployment Geography for Use: Global ## Known Risks and Mitigations: Risk: The skill is a networked AiCoin API tool that broadly handles local API credentials. Mitigation: Use a dedicated low-privilege AiCoin key and keep unrelated secrets out of the working and OpenClaw .env files. Risk: The skill can save an AiCoin API secret in plaintext .env files. Mitigation: Store only the required AiCoin credential, restrict file access, and rotate the key if the workspace is shared or exposed. Risk: The skill may call non-Hyperliquid AiCoin endpoints despite its Hyperliquid framing. Mitigation: Review requested endpoint paths before execution and verify AICOIN_BASE_URL points only to the official AiCoin service. ## Reference(s): - [AiCoin OpenData](https://www.aicoin.com/opendata) - [ClawHub skill page](https://clawhub.ai/procaross/skills/aicoin-hyperliquid) - [OpenClaw metadata source](https://github.com/aicoincom/coinos-skills) ## Skill Output: **Output Type(s):** [text, markdown, shell commands, configuration, guidance] **Output Format:** [Markdown with JSON command examples and API response summaries] **Output Parameters:** [1D] **Other Properties Related to Output:** [May include AiCoin API envelopes with ok, data, error, and meta fields.] ## Skill Version(s): 4.0.0 (source: package.json and release metadata) ## Ethical Considerations: Users should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.
lib/defaults.json
{
"comment": "Public free-tier AiCoin API key. IP rate-limited. Users can replace with their own key via env vars.",
"accessKeyId": "ronJ8uI0Yj2soAfGVs5H1YALUIINbE22",
"accessSecret": "CWHZcH2us1CLSE7grroR1TpS0Z1JxTwU"
}lib/endpoints.json
{
"generated_at": "2026-05-19",
"count": 183,
"endpoints": [
{
"method": "GET",
"path": "/api/v3/_catalog",
"summary": "本接口:机器可读的全部 v3 接口清单(含参数)",
"auth": true
},
{
"method": "GET",
"path": "/api/v3/airdrops",
"summary": "空投列表(多数据源)",
"params": [
{
"name": "source",
"in": "query",
"required": false,
"type": "string",
"enum": [
"all",
"hodler",
"xlaunch",
"earncoin",
"alpha",
"bitget_launchpool",
"bitget_poolx"
],
"desc": "数据源,默认 all"
},
{
"name": "status",
"in": "query",
"required": false,
"type": "string",
"enum": [
"ongoing",
"finished"
],
"desc": "状态,默认 ongoing"
},
{
"name": "limit",
"in": "query",
"required": false,
"type": "int",
"desc": "返回条数,默认 20"
},
{
"name": "offset",
"in": "query",
"required": false,
"type": "int",
"desc": "结果偏移量,从 0 开始"
},
{
"name": "exchange",
"in": "query",
"required": false,
"type": "string",
"desc": "交易所筛选"
},
{
"name": "activity_type",
"in": "query",
"required": false,
"type": "string",
"desc": "活动类型筛选"
},
{
"name": "locale",
"in": "query",
"required": false,
"type": "string",
"enum": [
"cn",
"en",
"tc"
],
"desc": "语言"
}
],
"auth": true
},
{
"method": "GET",
"path": "/api/v3/airdrops/banners",
"summary": "空投热门 Banner",
"params": [
{
"name": "limit",
"in": "query",
"required": false,
"type": "int",
"desc": "数量限制,默认 5"
},
{
"name": "locale",
"in": "query",
"required": false,
"type": "string",
"enum": [
"cn",
"en",
"tc"
],
"desc": "语言"
}
],
"auth": true
},
{
"method": "GET",
"path": "/api/v3/airdrops/calendar",
"summary": "空投日历",
"params": [
{
"name": "year",
"in": "query",
"required": true,
"type": "int",
"desc": "年份"
},
{
"name": "month",
"in": "query",
"required": true,
"type": "int",
"desc": "月份"
},
{
"name": "locale",
"in": "query",
"required": false,
"type": "string",
"enum": [
"cn",
"en",
"tc"
],
"desc": "语言"
}
],
"auth": true
},
{
"method": "GET",
"path": "/api/v3/airdrops/detail",
"summary": "空投详情",
"params": [
{
"name": "type",
"in": "query",
"required": true,
"type": "string",
"enum": [
"hodler",
"xlaunch"
],
"desc": "详情类型"
},
{
"name": "project_id",
"in": "query",
"required": true,
"type": "string",
"desc": "项目标识(别名 token / airdrop_id)"
},
{
"name": "locale",
"in": "query",
"required": false,
"type": "string",
"enum": [
"cn",
"en",
AionUi
Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!
activepieces
AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents
cherry-studio
AI productivity studio with smart chat, autonomous agents, and 300+ assistants.
CopilotKit
The Frontend for Agents & Generative UI. React + Angular
Machine-readable data
The same record, as JSON, for agents and crawlers.
- Card JSON
- Facts JSON
- Snapshot JSON
- Contract JSON
- Trust JSON
- Changes JSON
- Warnings JSON
- Seen by JSON
- Disagreements JSON
{
"facts": [
{
"factKey": "vendor",
"category": "vendor",
"label": "Vendor",
"value": "Clawhub",
"href": "https://clawhub.ai/procaross/skills/aicoin-hyperliquid",
"sourceUrl": "https://clawhub.ai/procaross/skills/aicoin-hyperliquid",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-11T22:39:54.054Z",
"isPublic": true
},
{
"factKey": "protocols",
"category": "compatibility",
"label": "Protocol compatibility",
"value": "OpenClaw",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-procaross-aicoin-hyperliquid/contract",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-procaross-aicoin-hyperliquid/contract",
"sourceType": "contract",
"confidence": "medium",
"observedAt": "2026-10-11T22:39:54.054Z",
"isPublic": true
},
{
"factKey": "traction",
"category": "adoption",
"label": "Adoption signal",
"value": "983 downloads",
"href": "https://clawhub.ai/procaross/aicoin-hyperliquid",
"sourceUrl": "https://clawhub.ai/procaross/aicoin-hyperliquid",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-11T22:39:54.054Z",
"isPublic": true
},
{
"factKey": "latest_release",
"category": "release",
"label": "Latest release",
"value": "4.0.0",
"href": "https://clawhub.ai/procaross/aicoin-hyperliquid",
"sourceUrl": "https://clawhub.ai/procaross/aicoin-hyperliquid",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-05-21T07:35:54.317Z",
"isPublic": true
},
{
"factKey": "handshake_status",
"category": "security",
"label": "Handshake status",
"value": "UNKNOWN",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-procaross-aicoin-hyperliquid/trust",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-procaross-aicoin-hyperliquid/trust",
"sourceType": "trust",
"confidence": "medium",
"observedAt": null,
"isPublic": true
}
],
"events": [
{
"eventType": "release",
"title": "Release 4.0.0",
"description": "同步最新仓库变更:set-key 支持直接喂后台 JSON + install-test 实测修正 (catalog 分组冲突 / 403 信封归一)",
"href": "https://clawhub.ai/procaross/aicoin-hyperliquid",
"sourceUrl": "https://clawhub.ai/procaross/aicoin-hyperliquid",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-05-21T07:35:54.317Z",
"isPublic": true
}
]
}Record generated Oct 12, 2026.
For crawlers
This page is free to read. The run-check above is the only paid part, and it answers HTTP 402 until it is paid. Everything else here is public.
- One record, as JSON: card, facts, snapshot, contract, trust, changes, warnings, seen by, disagreements.
- Every agent, one feed: /.well-known/ai-catalog.json
- What this site sells, and the price: /.well-known/x402
- Paid run-check: /api/v1/agents/clawhub-procaross-aicoin-hyperliquid/run-check
