order는 트레이딩 잔액으로 거래하며, 잔액이 부족하면 먼저 지갑에서 필요한 USDT0를 브리지합니다. 현물(spot)에 대한 order는 지갑에서 USDT0와 자산 간에 스왑합니다. close는 한 시장의 전체 포지션을 청산하며, 그 결과 계정에 포지션이 없으면 withdraw 거래가 트레이딩 잔액을 지갑으로 되돌려 보냅니다. deposit 또는 withdraw는 지갑과 트레이딩 잔액 간에 자금을 이동합니다. 무기한 선물은 Hyperliquid에서 거래됩니다.
Trades API를 사용하면 거래 가능한 시장 목록을 조회하고, 주문을 넣고, 포지션을 청산하고, 자금을 이동하고, 각 거래가 끝날 때까지 추적할 수 있습니다. 거래는 백그라운드에서 실행됩니다. 자금을 브리지해 들여왔지만 체결되지 않은 주문은 해당 자금을 지갑으로 되돌려 보내며, funds_location은 자금이 어디에 있는지 알려 줍니다.
계정과 사용자의 include_trading을 포함한 트레이딩 API는 베타 단계입니다. 새 API 버전 날짜 없이 변경될 수 있습니다.
엔드포인트
시장
시장 목록 조회는 Whop에서 거래할 수 있는 모든 시장을 반환합니다.- 현물: 심볼별로 나열됩니다:
BTC,SOL,XAUT(금). - 무기한 선물:
BTC등이 있으며, Hyperliquid의xyz거래소에서 제공하는 주식 및 원자재 무기한 선물(예:xyz:TSLA)도 포함됩니다. 거래를 생성할 때id를market으로 전송하세요.
id와 instrument_type을 함께 사용하여 구분하세요. 결과는 id, 그다음 instrument_type 순으로 정렬됩니다.
이 엔드포인트는 공개되어 있습니다. API 키가 필요 없으며, 각 IP 주소는 분당 최대 60건의 요청을 보낼 수 있습니다.
무기한 선물 주문의 size는 소수점 이하 최대 size_decimals자리까지 가능하며, leverage는 최대 max_leverage까지 가능합니다. 현물 시장의 경우 max_leverage는 null입니다.
속성
입금, 현물 매수 또는 트레이딩 잔액이 부족한 무기한 선물 주문이 지갑에서 보내는
USDT0, 또는 출금이 되돌려 보내는 USDC로, 기본 단위의 십진수 문자열입니다.
all 출금은 완료되면 실제로 보낸 금액을 표시합니다. 그 외에는 null입니다.Whop이 이 거래의 주문과 함께 거래소에 보내는 ID로, 거래소의 주문 업데이트를
거래와 대응시킬 수 있게 합니다. Hyperliquid에서는
orderUpdates에 보고되는 주문의
cloid이며, 0x 접두사가 붙은 32자 16진수 문자열입니다. 호출자의
client_order_id가 아닙니다. 입금 또는 출금의 경우 null입니다.거래가 실패한 이유이며, 없으면
null입니다.사용 가능한 옵션: market_unavailable, leverage_too_high, amount_too_small, isolated_position_open, trading_paused, funding_failed, margin_unavailable, builder_fee_unapproved, leverage_rejected, leverage_unconfirmed, order_rejected, close_rejected, return_failed, withdraw_failed거래가 요청대로 완료되지 않았을 때 자금이 있는 위치입니다.
wallet, trading_account, 또는 담당자가 확인하는 동안은 unknown입니다. 그 외에는 null입니다.사용 가능한 옵션: wallet, trading_account, unknown주문의 경우
perpetual 또는 spot, 청산의 경우 perpetual입니다. 입금 또는 출금의 경우 null입니다.사용 가능한 옵션: perpetual, spot포지션을 여는 무기한 선물 주문 전에 설정된 교차 레버리지입니다. 현물 주문,
청산, 입금, 출금 또는 reduce-only 주문의 경우
null입니다.주문의 경우
market, limit, take_profit 또는 stop_loss입니다. 그 외에는 null입니다.사용 가능한 옵션: market, limit, take_profit, stop_loss주문과 함께 전송된 익절(take-profit) 또는 손절(stop-loss)의 경우, 해당 주문의 거래로
tint_ 접두사가 붙습니다. 그 외에는 null입니다.USD 기준 주문의 지정가입니다. 시장가 주문의 가격은
slippage_bps만큼 조정된 중간 가격이며, 익절 또는 손절의 가격은 트리거된 후 시장가 주문이 체결될 수 있는 최악의 가격입니다. 다른 유형의 경우 null입니다.속성
속성
거래가 시작될 때까지는
pending입니다. 실행 중에는 processing이며, 체결되지 않은 주문이 브리지해 들여온 자금을 지갑으로 되돌려 보내는 동안에도 마찬가지입니다. 요청한 작업을 수행하면 completed입니다. 그렇지 못하면 failed이며, funds_location이 자금 위치를 알려 줍니다. 결과를 알 수 없어 담당자가 확인하는 경우 in_review입니다.사용 가능한 옵션: pending, processing, in_review, completed, failed진행 중인 거래가 현재 수행 중인 작업입니다.
depositing은 지갑의 USDT0를 브리지로 보내는 중, landing은 전송 후 트레이딩 잔액에 도달할 때까지, placing은 주문 또는 청산이 거래소에 있는 동안, withdrawing은 USDC가 지갑으로 돌아가는 중, returning은 체결되지 않은 주문이 브리지해 들여온 자금이 돌아가는 중입니다. 현물 주문은 스왑 가격을 산정하는 동안 quoting, 온체인에서 실행되는 동안 swapping, 새 잔액이 지갑에 표시될 때까지 crediting입니다. 거래가 더 이상 pending 또는 processing 상태가 아니면 null입니다.사용 가능한 옵션: depositing, landing, placing, withdrawing, returning, quoting, swapping, crediting익절 또는 손절이 시장가 주문을 보내는 USD 기준 가격입니다. 다른 주문 및 유형의 경우
null입니다.속성
속성
order는 하나의 주문을 넣습니다. 무기한 선물 주문은 트레이딩 잔액으로 거래하고, 현물 주문은 지갑에서 USDT0와 자산 간에 스왑합니다. deposit은 지갑의 USDT0를 트레이딩 잔액으로 브리지합니다. withdraw는 트레이딩 잔액의 USDC를 지갑으로 되돌려 보냅니다. close는 시장가 reduce-only 주문으로 한 시장의 전체 포지션을 청산하며, 그 결과 계정에 포지션이 없으면 withdraw 거래가 트레이딩 잔액을 지갑으로 되돌려 보냅니다.사용 가능한 옵션: close, order, deposit, withdrawTrade

