Hyperliquid Spot API

Hyperliquid SPOT 시장 데이터: 454개 토큰, 실시간 가격, 24시간 거래량, 지갑 잔액. 네이티브 L1 DEX 데이터, CoinGecko 불필요. 에이전트가 Hyperliquid 거래에 필요한 스팟 데이터 레이어. x402를 통한 호출당 결제 (Base L2의 USDC) -- API 키 없음, 가입 없음, 요금 제한 없음.

klymax402 마켓플레이스의 일부 -- AI 에이전트를 위한 100개의 x402 마이크로결제 API, 하나의 지갑, Base의 USDC.

빠른 시작 -- MCP

MCP 클라이언트 설정에 추가하세요 (Claude Desktop, Cursor, ElizaOS 등):

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

Related MCP server: boo-x402-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

Hyperliquid L1 DEX에서 사용 가능한 스팟 토큰을 나열하거나 검색해야 할 때 사용합니다. 모든 454개 스팟 토큰을 토큰 이름, 심볼, tokenId, index, decimals, wei 변환 계수를 포함한 전체 메타데이터와 함께 반환합니다.

매개변수

응답 예시:

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

사용하지 않는 경우: 선물/무기한 데이터 (hyperliquid_get_perp_markets 사용), CEX/CoinGecko 토큰 가격 (token_get_price 사용), 체인 간 지갑 포트폴리오 (wallet_get_portfolio 사용), Hyperliquid 볼트 데이터 (hyperliquid_get_vaults 사용).

hyperliquid_get_spot_markets

Hyperliquid DEX의 실시간 스팟 시장 데이터(가격, 24시간 거래량, 모든 스팟 페어의 거래 활동)가 필요할 때 사용합니다. 모든 활성 스팟 시장에 대해 병합된 토큰 메타데이터와 실시간 시장 컨텍스트를 반환합니다.

매개변수

응답 예시:

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

사용하지 않는 경우: 선물/무기한 시장 (hyperliquid_get_perp_markets 사용), CoinGecko 가격 (token_get_price 사용), 자금 조달 비율 (hyperliquid_get_funding_rates 사용), 과거 OHLCV 캔들 (token_get_ohlcv 사용).

hyperliquid_get_spot_balances

Hyperliquid L1 DEX에서 특정 지갑 주소의 스팟 토큰 잔액을 확인해야 할 때 사용합니다. 보유 및 주문 중(보유) 수량을 포함한 모든 0이 아닌 스팟 토큰 보유를 반환합니다.

매개변수

응답 예시:

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

사용하지 않는 경우: 무기한 포지션 (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 에이전트를 위한 100개의 x402 마이크로결제 API -- 하나의 지갑, Base의 USDC, 가입 제로.

• 카탈로그: https://klymax402.com/llms.txt

• 전체 API 참조: https://klymax402.com/llms-full.txt

• 실시간 통계: https://klymax402.com/stats

라이선스

MIT