HL Portfolio API

Hyperliquid 계정을 분석하세요: 포지션, PnL, 체결, 미체결 주문, 펀딩. 어떤 지갑이든 전체 클리어링하우스 상태를 확인할 수 있습니다. 에이전트가 하이퍼리퀴드 트레이딩 인텔리전스를 위해 필요한 포트폴리오 레이어입니다.

x402(Base L2의 USDC) 기반으로 호출할 때마다 결제하는 방식입니다 -- API 키도, 가입도, rate limit(요청률 제한) 벽도 없습니다.

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

빠른 시작 -- MCP

MCP 클라이언트 설정(Claude Desktop, Cursor, ElizaOS 등)에 추가합니다:

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

Related MCP server: polskidegen-hl-tracker

빠른 시작 -- HTTP(x402)

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

x402를 지원하는 클라이언트(@x402/fetch, x402-agent-tools, ATXP)는 402 -> sign -> retry 주기를 자동으로 처리합니다.

도구

hyperliquid_get_account_info

Hyperliquid 퍼페추얼 계정의 전체 포트폴리오 상태를 조회해야 할 때 사용합니다. 계정 수준 지표와 포지션별 세부 정보를 포함하여 모든 wallet 지갑? 어느 지갑이든지 전체 클리어링하우스 상태를 반환합니다.

매개변수

응답 예시:

{ accountValue: "125430.50", totalNtlPos: "89200.00", withdrawable: "36230.50", positions: [{ coin: "BTC", size: "1.5", entryPrice: "67500.00", unrealizedPnl: "2340.00", leverage: 5, liquidationPrice: "54200.00", marginType: "cross" }] }

적합한 경우: 트레이더의 위험 노출 분석, 마진 건전성 확인, 또는 Hyperliquid 포트폴리오 자산 배분에 적합합니다. 카피트레이딩 평가와 리스크 모니터링에 필수적입니다.

적합하지 않은 경우: 거래 내역(hyperliquid_get_trade_fills), 미결제 주문(hyperliquid_get_open_orders), 펀딩 지불(hyperliquid_get_user_balance), 볼트 성과(hyperliquid_get_vault_details), 고래 거래(hyperliquid_detect_ignore).

hyperliquid_get_trade_fills

Hyper 퍼 Hyperliquid 계정의 최근 체결(거래 실행) 내역을 조회해야 할 때 사용합니다. 체결된 최신 거래와 함께 종료 포지션의 실현 손익(realized PnL) 등 상세 정보를 반환합니다.

매개변수

| 이름 | 타입 | 필수 | 설명 | | ---------– | ------ | ------ | ------------------------------------------------------------------------ | | address | string | 예 | 체결 내역을 조회할 하이퍼리퀴드 지갑 주소 (0x...) | | limit | number | 선택 | 반환할 최대 체결 수 (기본: 20, 최대: 100) |

응답 예시:

{ fills: [{ coin: "ETH", side: "buy", size: "10.0", price: "3450.50", fee: "0.69", closedPnl: "0.00", timestamp: 1712000000000 }], count: 20 }

적합하지 않은 경우: 현재 포지션(hyperliquid_get_account_state), 미결제 주문(hyperliquid_get_open_orders), 펀딩 지급(hyperliquid_get_user_funding).

hyperliquid_get_open_orders

Hyperliquid 계정의 모든 미결제/대기 주문을 확인해야 할 때 사용합니다. 주문서에 남아 있는 모든 대기 주문과 주문 파라미터를 반환합니다.

매개변수

응답 예시:

{ orders: [{ coin: "BTC", side: "buy", limitPx: "65000.00", sz: "0.5", orderType: "limit", reduceOnly: false, oid: 123456 }], count: 3 }

적합하지 않은 경우: 체결된 매매(→ hyperliquid_get_trade_fills), – 현재 포지션(hyperliquid_get_account_state).

hyperliquid_get_user_funding

Hyperliquid 계정의 펀딩 지급 이력을 조회해야 할 때 사용합니다. 펀딩 지급/수령 금액과 요율/시각을 통해 펀딩 수익/비용 및 캐리 트레이드 수익성 평가에 유용합니다.

매개변수

응답 예시:

{ funding: [{ coin: "BTC", fundingRate: "0.0001", payment: "-1.35", timestamp: 1712000000000, positionSize: "1.5" }], totalReceived: "45.20", totalPaid: "-12.30", netFunding: "32.90" }

적합하지 않은 경우: 현재 포지션(hyperliquid_get_account_state), 펀딩 차익 거래 기회(funding_arb_find_opportunities), 매매 실행 이력(hyperliquid_get_order_fills).

예시 에이전트 프롬프트

• "Hyperliquid 퍼퍼추얼 계정의 전체 포트폴리오 상태 조회"

• "Hyperliquid 퍼퍼추얼 계정의 최근 매매 실행(fill) 조회"

• "Hyperliquid 퍼퍼추얼 계정의 모든 미결제/대기 주문 조회"

결제

• 프로토콜: x402 — HTTP 원픛 호출 결제, 가입 없음, API 키 없음

• 네트워크: Base L2 (eip155:8453)

• 자산: USDC

• 펀딩자: Coinbase CDP(primary), PayAI(fallback)

• ATXP를 통해서도 접근 가능: ATXP (OAuth 래핑 x402, RFC 9728 protected-resource 메타데이터)

klymax402 소속

AI 에이전트를 위한 100개의 x402 마이크로결제 API — 하나의 지갑, Base의 USDC, 가입 없이.

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

• 전체 API 레퍼런스: https://klymax402.com/llms-full.txt

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

License

MIT