= 거래소
Liquid (HIP-3 venue on Hyperliquid 메인넷)
API: https://api.hyperliquid.xyz
마켓 표기: liquid:<SYMBOL>
= 환경
pip install hyperliquid-python-sdk eth-account
= 1회 빌더 fee 승인 (지갑 sign 필요, 영구 적용)
from hyperliquid.exchange import Exchange
from hyperliquid.utils.constants import MAINNET_API_URL
from eth_account import Account
BUILDER = "0x6D4E7F472e6A491B98CBEeD327417e310Ae8ce48"
BUILDER_F = 50 # tenths of bps (50 = 0.05% = 5bp)
account = Account.from_key("<USER_PRIVATE_KEY>")
exchange = Exchange(account, MAINNET_API_URL)
exchange.approve_builder_fee(
builder=BUILDER,
max_fee_rate="0.05%",
)
wallet sign 한 번 → 모든 미래 주문에 적용
= 주문 함수 (필수 — builder 필드 매번 attach)
def place_order(coin, is_buy, size, price, reduce_only=False):
return exchange.order(
name=coin, # 예: "liquid:BTC"
is_buy=is_buy,
sz=size,
limit_px=price,
order_type={"limit": {"tif": "Gtc"}},
reduce_only=reduce_only,
builder={"b": BUILDER, "f": BUILDER_F},
)
= 현재 가격 조회
px = exchange.info.all_mids()["liquid:BTC"]
= 사용 예 (어떤 거래 로직이든)
place_order("liquid:BTC", True, 0.001, px) # 매수
place_order("liquid:BTC", False, 0.001, px, True) # 청산
거래 전략은 본인 자유. place_order() 만 그대로 쓰면 빌더 자동 부착.
= 단위
- builder.f = tenths of bps (50 → 5bp = 0.05%)
- $150 거래 × 5bp → $0.075 builder fee
- max_fee_rate(approve 시) = 일반 % 표기 ("0.05%")
= 검증
1) 첫 주문 후 거래소 Trade History → fee = size × 0.05% 와 일치
2) Liquid 대시보드 → BUILDER 주소 활동 증가 확인
3) fee 0 으로 찍히면 approve_builder_fee 다시 실행
= 안전
- approve_builder_fee 안 되어있으면 builder 필드 무시됨 (조용히)
- private_key는 .env / 환경변수, 코드 하드코딩 X
- 일일 거래 비용 캡 본인 책임 (max_daily_cost 같은 가드)
= 변수 치환
<USER_PRIVATE_KEY> 본인 지갑 PK
<SYMBOL> 거래 코인 ("BTC", "ETH" 등)
하리쪽 빌더코드랑 피 설정 하나라도 틀리면 포인트 0이니까 꼭 확인하세요