Hl Spot X402

Hyperliquid Spot API

Hyperliquid の SPOT 市場データ：454 種類のトークン、リアルタイム価格、24 時間取引量、ウォレット残高。ネイティブな L1 DEX データで、CoinGecko は使用しません。Hyperliquid での取引にエージェントが必要とするスポットデータレイヤーです。x402 による従量課金（Base L2 上の USDC）で、API キーも登録も不要、レート制限の壁もありません。

klymax402 マーケットプレイスの一部です。AI エージェント向けの x402 マイクロペイメント API 100 種類を、1 つのウォレットと Base 上の USDC で利用できます。

クイックスタート -- MCP

MCP クライアントの設定（Claude Desktop、Cursor、ElizaOS など）に追加します。

{
  "mcpServers": {
    "hl-spot": {
      "url": "https://hl-spot.api.klymax402.com/mcp"
    }
  }
}

クイックスタート -- HTTP（x402）

curl -X POST "https://hl-spot.api.klymax402.com/api/tokens" \
  -H "Content-Type: application/json" \
  -d '{}'
# -> 402 Payment Required, with an x402 payment challenge in the response body

x402 対応クライアント（@x402/fetch、x402-agent-tools、ATXP）は、402 → 署名 → 再試行のサイクルを自動的に処理します。

ツール

ツール	メソッド	パス	価格	説明
hyperliquid_list_spot_tokens	POST	/api/tokens	$0.005	Hyperliquid 上のスポットトークン 454 種類をすべて、名前、tokenId、index、decimals、wei decimals などのメタデータとともに一覧表示します。
hyperliquid_get_spot_markets	POST	/api/markets	$0.005	Hyperliquid のすべてのスポットペアについて、スポット市場価格、24 時間取引量、ミッド価格、取引ペア情報を取得します。
hyperliquid_get_spot_balances	POST	/api/balance	$0.005	Hyperliquid 上の任意のウォレットアドレスについて、保有額と利用可能額を含むスポットトークン残高を取得します。

hyperliquid_list_spot_tokens

Hyperliquid L1 DEX で利用可能なスポットトークンを一覧表示または検索する場合に使用します。トークン名、シンボル、tokenId、index、decimals、wei 換算係数など、完全なメタデータを含むスポットトークン 454 種類すべてを返します。

パラメーター

名前	型	必須	説明
search	string	いいえ	任意のフィルターです。名前またはシンボルでトークンを検索します（大文字と小文字を区別しない部分一致）。省略すると、454 種類すべてのトークンを返します。

レスポンスの例：

{ tokens: [{ name: "PURR", tokenId: "0xc4bf3f...", index: 1, decimals: 0, weiDecimals: 8 }], count: 454 }

対象外：perps／先物データ（hyperliquid_get_perp_markets を使用）、CEX／CoinGecko のトークン価格（token_get_price を使用）、複数チェーンにわたるウォレットポートフォリオ（wallet_get_portfolio を使用）、Hyperliquid のボルトデータ（hyperliquid_get_vaults を使用）。

hyperliquid_get_spot_markets

Hyperliquid DEX のリアルタイムのスポット市場データ（価格、24 時間取引量、すべてのスポットペアの取引活動）が必要な場合に使用します。すべてのアクティブなスポット市場について、トークンメタデータとリアルタイムの市場情報を統合して返します。

パラメーター

名前	型	必須	説明
sort	string	いいえ	結果の並べ替え順です。'volume' = 24 時間取引量の多い順（デフォルト）、'change' = 価格変動の大きい順、'name' = アルファベット順。

レスポンスの例：

{ markets: [{ name: "PURR/USDC", markPx: "0.0234", dayNtlVlm: "1250000", change24h: 5.32 }], count: 120 }

対象外：perps／先物市場（hyperliquid_get_perp_markets を使用）、CoinGecko の価格（token_get_price を使用）、資金調達率（hyperliquid_get_funding_rates を使用）、過去の OHLCV ローソク足（token_get_ohlcv を使用）。

hyperliquid_get_spot_balances

Hyperliquid L1 DEX 上の特定のウォレットアドレスについて、スポットトークン残高を確認する場合に使用します。残高がゼロでないスポットトークンの保有額をすべて、利用可能額と保有額（注文中）とともに返します。

パラメーター

名前	型	必須	説明
address	string	はい	0x 形式のウォレットアドレス（42 文字）。例：0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045

レスポンスの例：

{ address: "0xabc...", balances: [{ coin: "PURR", total: "15000", hold: "5000", available: "10000", entryNtl: "350.50" }], count: 3 }

対象外：perps のポジション（hyperliquid_get_perp_positions を使用）、Hyperliquid のボルト残高（hyperliquid_get_vaults を使用）、EVM トークン残高（token_get_balance を使用）。

エージェント向けプロンプトの例

• "Hyperliquid L1 DEXで利用可能なスポットトークンを一覧表示または検索する"
• "Hyperliquid DEXのリアルタイムスポット市場データ：すべてのスポットペアの価格、24時間取引高、取引状況"
• "Hyperliquid L1 DEX上の特定のウォレットアドレスについて、スポットトークンの残高を確認する"

支払い

• プロトコル：x402 -- HTTPネイティブの呼び出しごとの従量課金。登録不要、APIキー不要
• ネットワーク：Base L2（eip155:8453）
• 資産：USDC
• ファシリテーター：Coinbase CDP（プライマリ）、PayAI（フォールバック）
• ATXP 経由でも利用できます（OAuthでラップされたx402、RFC 9728で保護されたリソースメタデータ）

klymax402の一部

AIエージェント向けのx402マイクロペイメントAPIが100個。1つのウォレット、Base上のUSDC、登録不要。

• カタログ：https://klymax402.com/llms.txt
• APIリファレンス全文：https://klymax402.com/llms-full.txt
• リアルタイム統計：https://klymax402.com/stats

ライセンス

MIT