하이퍼리퀴드 자동매매 봇과 파이썬 자동매매 가이드

1. 하이퍼리퀴드 자동매매 3가지 방법 비교

방법쓰는 것비용키는 누가 갖나맞는 용도
직접 만든 파이썬 봇공식 SDK(0.24.0) + API 지갑하이퍼리퀴드 수수료만나 (API 지갑은 거래만, 출금 불가)그리드, 적립식(DCA), 마켓메이킹 등 원하는 전략 전부
깃허브 오픈소스 봇내 서버에서 Hummingbot, Freqtrade, passivbot하이퍼리퀴드 수수료 (일부 라이브러리는 작은 빌더 수수료 추가)나거래소 연동 코드를 직접 짜지 않고 검증된 전략 사용
텔레그램·호스팅 봇PvP, Hypurr Fun, Dextrabot하이퍼리퀴드 수수료 + 봇 자체 수수료봇 운영사나 키 보관 서비스 (API 지갑을 연결하면 나)코딩 없이 휴대폰으로 거래

하이퍼리퀴드는 마지막 사이트 빌드 기준 무기한 선물 178개 종목을 상장하고 있고, 24시간 선물 거래량은 $4.58B입니다(2026년 10월 25일 기준). 호가창이 전부 온체인인데도 주문·취소에 가스비가 들지 않아 퍼프 DEX 가운데 봇이 가장 많이 몰리는 곳이고, 가장 싼 방법(직접 코딩)이 가장 흔한 방법이기도 합니다. 국내 원화 거래소는 API가 있어도 현물만 자동매매할 수 있습니다(업비트·빗썸의 공개 마켓 목록은 현물뿐이고 선물 시장이 없음, 2026년 10월 22일 확인). 하이퍼리퀴드에서는 같은 파이썬 코드로 무기한 선물과 현물을 모두 다룹니다.

엔드포인트, 서명 방식, 첫 주문 같은 API 자체는 하이퍼리퀴드 API 가이드 (영문)에 있고, 이 글은 그 위에서 봇을 돌리는 방법을 다룹니다. 거래소별 API를 먼저 비교하고 싶다면 퍼프 DEX 트레이딩 봇·API 비교 (영문)를 보세요. 다른 사람 지갑을 그대로 따라 하는 방식은 하이퍼리퀴드 카피트레이딩에 따로 정리했습니다.

2. 파이썬으로 시작하기: 하이퍼리퀴드 API 사용법과 예제 코드

  1. 메인 계정을 열고 입금합니다. HOLYGRAIL 링크로 하이퍼리퀴드에 가입하고 USDC를 5 USDC 이상 넣은 뒤(그보다 적으면 소실될 수 있음) 앱에서 한 번 거래해 봅니다. 선물 최소 주문은 명목 금액 $10입니다. 업비트·빗썸에서 보내는 방법은 하이퍼리퀴드 입금 방법에 있습니다. 테스트넷부터 하고 싶어도 파우셋은 같은 주소로 메인넷에 입금한 기록이 있어야 하므로 메인넷 계정이 먼저입니다(하이퍼리퀴드 테스트넷).
  2. (선택) 봇 전용 하위 계정(더보기 → 하위 계정). 거래량 $100,000 이후 열리고(처음엔 10개), 수수료 티어를 공유하며 요청 한도는 따로 계산됩니다. 단, 하위 계정에는 추천인 할인이 적용되지 않습니다(하위 계정 설명 (영문)).
  3. API 지갑 만들기(더보기 → API). 만드는 법과 권한은 3장에 있습니다.
  4. SDK 설치: pip install hyperliquid-python-sdk(버전 0.24.0, MIT 라이선스, 파이썬 3.9 이상). examples/ 폴더에 기능별 예제가 있습니다: basic_order.py, basic_agent.py, basic_schedule_cancel.py, basic_ws.py.

처음 만든 봇이 가장 많이 막히는 지점이 하나 있습니다. API 지갑은 서명만 합니다. 잔고와 주문을 읽을 때는 실제 계정(메인 또는 하위 계정) 주소로 조회해야 하고, API 지갑 주소로 조회하면 빈 계정이 나옵니다.

예제 1: 포스트 온리 그리드 + 데드맨 스위치

ETH에 0.5% 간격으로 매수 5개·매도 5개의 ALO(포스트 온리, 메이커로만 체결) 주문을 한 번의 묶음 액션으로 깔고, 60초 뒤 전부 취소되도록 예약합니다. ETH 수량은 소수 4자리, 가격은 유효숫자 최대 5자리라서 2026년 10월 22일 ETH 마크 가격 $2,442 근처에서는 가격이 $0.1 단위로 움직이고, 0.01 ETH(약 $24)면 최소 주문 금액을 넘습니다.

import os, time
import eth_account
from hyperliquid.exchange import Exchange
from hyperliquid.info import Info
from hyperliquid.utils import constants

ACCOUNT = os.environ["HL_ACCOUNT_ADDRESS"]   # 메인 계정 주소
SUB = os.environ.get("HL_SUB_ACCOUNT")        # 선택: 봇 전용 하위 계정
TRADER = SUB or ACCOUNT                       # 주문이 들어가는 계정 (조회용)
agent = eth_account.Account.from_key(os.environ["HL_API_WALLET_KEY"])  # 출금 불가

info = Info(constants.MAINNET_API_URL, skip_ws=True)
ex = Exchange(agent, constants.MAINNET_API_URL, account_address=ACCOUNT, vault_address=SUB)

COIN, LEVELS, STEP, SIZE = "ETH", 5, 0.005, 0.01
mid = float(info.all_mids()[COIN])

orders = []
for i in range(1, LEVELS + 1):
    for is_buy, sign in ((True, -1), (False, 1)):
        px = round(mid * (1 + sign * STEP * i), 1)
        orders.append(dict(coin=COIN, is_buy=is_buy, sz=SIZE, limit_px=px,
                           order_type=dict(limit=dict(tif="Alo")), reduce_only=False))

print(ex.bulk_orders(orders))                            # 액션 1번에 주문 10개
ex.schedule_cancel(int(time.time() * 1000) + 60_000)  # 다시 걸지 않으면 60초 뒤 전부 취소

예제 2: 체결되면 반대 주문을 거는 루프

봇다운 부분은 체결에 반응하는 루프입니다. 아래 코드는 SDK의 WebSocket으로 내 체결을 받아, 매수가 체결되면 한 칸 위에 매도를, 매도가 체결되면 한 칸 아래에 매수를 겁니다.

STATE = dict(seen=set())

def on_fills(msg):
    data = msg["data"]
    if data.get("isSnapshot"):          # 첫 메시지는 최근 체결을 다시 보내 줌
        return
    for fill in data["fills"]:
        if fill["coin"] != COIN or fill["tid"] in STATE["seen"]:
            continue
        STATE["seen"].add(fill["tid"])
        px, sz = float(fill["px"]), float(fill["sz"])
        bought = fill["side"] == "B"
        new_px = round(px * (1 + STEP) if bought else px * (1 - STEP), 1)
        ex.order(COIN, not bought, sz, new_px, dict(limit=dict(tif="Alo")))

ws_info = Info(constants.MAINNET_API_URL)            # WebSocket 연결
ws_info.subscribe(dict(type="userFills", user=TRADER), on_fills)

while True:                    # 데드맨 스위치 유지: 다시 걸 때마다 액션 1회
    ex.schedule_cancel(int(time.time() * 1000) + 300_000)   # 5분 안에 다시 걸지 않으면 전부 취소
    time.sleep(240)

실제 돈을 넣기 전에 더 필요한 것: 최대 포지션 한도, 범위 밖에서 감소만(reduce-only) 주문으로 포지션을 정리하는 손절선, 재연결 처리, 그리고 "Post only order would have immediately matched" 오류(한 틱 떨어뜨려 다시 주문) 처리입니다. schedule_cancel은 최소 5초 뒤로 걸어야 하고, 하루 최대 10번까지만 실제로 발동합니다(UTC 00:00, 한국 시간 오전 9시에 초기화). 다시 걸 때마다 주소당 액션 한도를 쓰므로, 루프가 몇 초가 아니라 4분마다 다시 겁니다. SDK(0.24.0, 2026년 10월 22일 확인)에는 TWAP와 추적 손절 함수가 없어 직접 만들어야 합니다(TWAP API 예제 (영문)). 코드는 설명용이며 그대로 운영용으로 쓰는 소프트웨어가 아닙니다.

3. API 지갑 만들기와 권한

하이퍼리퀴드 문서의 정의는 "API 지갑(에이전트 지갑)은 출금 권한 없이 계정을 대신해 행동할 수 있다"입니다. app.hyperliquid.xyz 오른쪽 위 더보기 → API에서 이름을 넣고 주소를 생성한 뒤, 메인 지갑으로 승인 서명을 하면 됩니다.

app.hyperliquid.xyz/API의 API 지갑 화면: 이름 입력, Generate 버튼, Valid Until 열
API 지갑 화면(2026년 9월 촬영). 봇 이름으로 키 이름을 정하고 만료일(Valid Until)을 정해 두세요.
  • 할 수 있는 것: 주문, 취소, 주문 수정, 레버리지 변경 같은 거래 액션.
  • 할 수 없는 것: 출금, 다른 주소로 USDC 이체, 빌더 수수료 승인(메인 지갑만 서명 가능).
  • 개수: 계정당 이름 없는 API 지갑 1개와 이름 있는 API 지갑 3개, 하위 계정마다 이름 있는 것 2개. 각각 최대 180일 동안 유효합니다.
  • 다시 쓰지 않기: 등록 해제한 API 지갑 주소는 논스 기록이 지워질 수 있어, 예전에 서명한 액션이 다시 실행될 위험이 있습니다. 새 봇에는 새 주소를 만드세요.

키를 어디에 두고 언제 바꿀지는 API 지갑 보안 가이드 (영문)에 자세히 있습니다. 카피 앱이 같은 API 지갑 구조로 내 계정에 주문하는 방식은 카피트레이딩 가이드에서 볼 수 있습니다.

4. 깃허브 오픈소스 자동매매 봇

코드를 직접 짜기보다 검증된 코드를 돌리고 싶다면, "하이퍼리퀴드 자동매매 깃허브"를 찾는 사람들이 보통 도착하는 오픈소스는 아래와 같습니다. 각 저장소와 문서를 2026년 10월 22일에 읽었습니다. 추천이 아니며, 저희가 실제 돈으로 돌려 본 것은 없습니다.

프로젝트라이선스하이퍼리퀴드에서 하는 일주의할 점
HummingbotApache-2.0하이퍼리퀴드 현물·선물 커넥터와 그리드 컨트롤러(grid_strike)가 있는 마켓메이킹 프레임워크문서상 주문에 수수료 없는 빌더 코드를 붙여 출처만 표시합니다. 문서가 Hummingbot 자체 하이퍼리퀴드 추천 링크로 가입하라고 안내합니다
FreqtradeGPL-3.0전략·백테스트 봇. README에 하이퍼리퀴드 현물·선물 지원이 적혀 있고 CCXT를 씁니다CCXT 기본값(아래)을 그대로 따릅니다. 문서는 API 지갑 키를 메인 walletAddress와 함께 쓰라고 하고 공급망 공격을 경고합니다
CCXTMIT많은 봇이 쓰는 라이브러리(파이썬·JS·PHP), 하이퍼리퀴드 지원인증 정보를 넣으면 추천인 코드 CCXT1 설정과 0.01% 빌더 수수료 승인·부과를 시도합니다. 옵션으로 둘 다 끌 수 있습니다
passivbotUnlicense하이퍼리퀴드 등 여러 거래소에서 도는 선물 그리드·추적형 "역추세 마켓메이커"README에 자체 하이퍼리퀴드 추천 링크가 있습니다
chainstacklabs/hyperliquid-trading-botApache-2.0hyperliquid-python-sdk 0.24.0 기반의 작은 파이썬 그리드 봇, 기본값은 테스트넷직접 만들기 전에 읽어 보기 좋은 코드
OctoBotGPL-3.0그리드·DCA·트레이딩뷰 연동 봇하이퍼리퀴드는 현물만 지원

봇 코드 속의 빌더 수수료와 추천인 코드. 오픈소스 봇은 무료지만, 일부는 앱처럼 내 거래량에서 수익을 얻습니다. Freqtrade와 많은 자작 봇이 쓰는 CCXT는 인증 정보를 받는 즉시(마켓을 불러오거나 첫 주문을 낼 때) 추천인 코드 CCXT1로 setReferrer를 보내고(오류는 무시하므로 이미 코드가 있는 계정은 그대로), 자기 빌더 주소에 0.01% 빌더 수수료를 승인해 모든 주문에 붙입니다. 빌더 수수료 승인은 메인 지갑 서명이 필요해서 API 지갑 키로는 승인이 실패하고, 그때 CCXT는 빌더 없이 주문합니다. refSet: true는 추천인 호출을 건너뛰고, builderFee: false는 수수료를 없앱니다(다만 0%로 빌더를 승인해 주문에 표시는 남깁니다). Hummingbot 문서는 출처 표시용 태그만 붙인다고 적고 있습니다. 추천인 코드는 계정마다 한 번만 붙으므로, 어떤 봇이든 연결하기 전에 HOLYGRAIL로 먼저 가입해 두세요. 팬텀(Phantom) 같은 앱은 추천인 코드가 없는 계정에 자체 하이퍼리퀴드 추천인 코드를 붙이는 경우가 많습니다.

가짜 봇 저장소 주의. 2026년 10월 22일 깃허브에서 "hyperliquid grid"를 검색하자, 키워드를 잔뜩 넣은 설명을 단 저장소 두 개가 나왔고 둘 다 VS Code에서 폴더를 여는 순간 숨겨진 코드를 실행하는 구조였습니다. 깃허브 API로 내용만 읽었고 실행하지 않았으며, 이름과 링크는 싣지 않습니다. 봇 저장소를 열기 전에 .vscode/tasks.json에 "runOn": "folderOpen"이 있는지, package.json에 설치 스크립트가 있는지, 설정 파일에 base64 문자열이 있는지 확인하세요. 읽어 보지 않은 봇에는 메인 지갑 키를 절대 넣지 마세요.

5. 그리드 매매 봇: 원리·수익률·청산 위험

그리드 매매법은 현재가 아래에 매수 지정가를, 위에 매도 지정가를 한 칸씩 깔아 두는 방식입니다. 매수가 체결되면 한 칸 위에 매도를 다시 걸고, 매도가 체결되면 반대로 합니다. 매수→매도 한 번이 한 사이클이고, 칸 간격 × 칸당 금액만큼을 법니다. 즉 "가격이 범위 안에서 오르내린다"에 거는 전략입니다. 하이퍼리퀴드에는 내장 그리드 화면이 없어서 API(위 예제), 오픈소스 봇, 호스팅 그리드 봇 중 하나로 돌립니다. 비용은 가스비가 아니라 수수료, 들고 있는 포지션의 펀딩비, 주소당 요청 한도입니다.

한 사이클의 두 주문이 체결되는 방식사이클당 비용 (칸 금액 대비)
양쪽 다 포스트 온리(ALO), 기본 티어0.03%
양쪽 ALO + 추천인 코드(4% 할인)0.0288%
양쪽 ALO + 추천인 코드 + HYPE 스테이킹 브론즈(10% 할인)0.0259%
한쪽이 테이커(재주문이 엉성할 때)0.06%
양쪽 다 테이커(시장가 주문)0.09%
그리드 간격메이커 수수료 뺀 사이클당 순수익총수익 중 남는 비율
0.1%0.07%70%
0.2%0.17%85%
0.5%0.47%94%
1%0.97%97%

하이퍼리퀴드 수수료표의 기본 티어 기준. 추천인 코드와 HYPE 스테이킹으로 내려가고, 거래량 티어가 오르면 더 내려갑니다. 그리드 주문은 모두 Alo로 내세요. 바로 체결될 주문이면 테이커 수수료를 내는 대신 거절됩니다.

원화로 계산해 보기. 1,000만원(업비트 USDC 1,334원 기준 약 7,496 USDC, 2026년 10월 22일)으로 ETH 중립 그리드를 ±5% 범위, 20칸으로 짜면 간격은 약 0.5%, 칸당 약 374.8 USDC(50만원)입니다. 한 사이클은 총 1.87 USDC(약 2,500원)를 벌고 메이커 수수료 0.11 USDC(약 150원)를 내서 1.76 USDC, 약 2,350원이 남습니다. 하루 10사이클이면 약 24,000원, 자본의 0.24%이고 펀딩비는 빼기 전입니다. 가격이 범위를 벗어나 사이클이 0번이면 수익도 0이고 재고만 남습니다. 칸마다 최소 주문 $10를 넘어야 해서, 100만원을 100칸으로 나누면 칸당 약 7.50 USDC로 최소 주문 금액에 못 미칩니다.

  • 범위 이탈과 재고. 중립 그리드에서 가격이 범위 아래로 뚫고 내려가면 매수는 전부 체결되고 매도는 하나도 체결되지 않습니다. 위 예시라면 내려오는 길에 약 3,748 USDC(500만원)어치 ETH를 산 채 손실 상태입니다. 범위 바로 바깥에 사다리를 취소하고 포지션을 정리하는 손절선을 두세요.
  • 레버리지와 청산. 칸당 증거금이 아니라 "매수 쪽이 전부 체결된 상태"로 크기를 정하세요. 칸마다 5배를 쓰면 매수 쪽 전체가 약 18,741 USDC어치 ETH가 되고(자기자본 1,000만원 대비), 하이퍼리퀴드 청산 공식(ETH 유지증거금 2%)으로 청산 가격은 평균 진입가보다 약 39% 아래입니다. 10배이면 약 37,481 USDC에 약 18%로, ETH가 일주일 안에 여러 번 움직인 폭입니다. 레버리지별 청산 가격은 하이퍼리퀴드 청산 계산기로 확인하세요.
  • 펀딩비 출혈. 롱 재고 약 500만원은 기본 펀딩비(0.01%/8시간)에서 하루 약 1.12 USDC(약 1,500원)를 냅니다. 사이클 수수료 하루치와 비슷한 수준이고, 롱이 몰리면 몇 배가 됩니다(펀딩비란).
  • 봇은 죽었는데 주문은 살아 있을 때. 루프마다 schedule_cancel을 다시 걸어, 봇이 멈추면 사다리도 취소되게 하세요.
  • 희망으로 정한 범위. 범위는 깔끔한 숫자가 아니라 최근 실현 변동성에 여유를 더해 정하세요.

코딩이 싫다면? 호스팅 그리드 봇은 내가 승인한 API 지갑으로 연결하고 하이퍼리퀴드 수수료 위에 빌더 수수료를 더 받습니다. Dextrabot은 하이퍼리퀴드 그리드 봇에 거래당 0.01%를 받고, 그리드 수는 2~36개(짝수), 교차 마진만 지원합니다. 아스터의 호가창 선물에는 내장 선물 그리드가 있고(메이커 0%), 라이터 Standard 계정은 메이커 0%·테이커 0%이지만 그리드 기능이 없어 역시 봇이 필요합니다(라이터 그리드 봇 (영문)).

봇을 돌리기 전에 한 가지: 그리드 봇은 사이클마다 수수료를 냅니다. 봇이 쓸 메인 계정을 HOLYGRAIL 링크로 먼저 만들면 처음 거래량 $25M까지 수수료가 4% 내려가고, 위 표의 "추천인 코드" 줄이 바로 그 경우입니다. 거래량이 $10,000를 넘은 계정에는 코드를 붙일 수 없습니다.

HOLYGRAIL로 봇 계정 만들기 →

6. 텔레그램 봇·호스팅 봇: 키는 누가 갖나

텔레그램 봇은 채팅창에서 하이퍼리퀴드를 거래하게 해 줍니다. 서비스마다 가장 크게 다른 점은 거래 키가 어디에 있느냐입니다. 각 서비스 문서를 2026년 10월 22일에 읽은 내용입니다.

  • PvP(pvp.trade). 이용자마다 지갑을 만들고 개인키는 "Turnkey가 저장·암호화"하며 내보낼 수 있다고 밝힙니다. 이미 가진 하이퍼리퀴드 계정을 API 키로 연결할 수도 있습니다. 수수료는 레벨 1 선물 0.025%~0.04%부터이고, 첫 입금은 최소 10 USDC입니다. PvP는 Hyperdash 터미널도 운영합니다(Hyperdash 사용법).
  • Hypurr Fun. 봇이 개인키를 내보낼 수 있는 개인 지갑을 만들거나, 키를 가져오거나 API 지갑을 연결하게 합니다. 문서상 자체 런치패드 Hpump 시장 거래에는 1% 수수료가 있고, 일반 HyperCore 거래에는 수수료가 없습니다.
  • 카피·그리드 플랫폼(Dextrabot, 카피 앱): 내가 승인한 API 지갑 + 빌더 수수료 구조입니다. Dextrabot 카피트레이딩은 거래당 0.055%입니다.

쓰기 전에 알아 둘 두 가지. 첫째, 봇이 만든 지갑은 새 하이퍼리퀴드 계정입니다. 내 추천인 코드 없이 시작하고 봇이 정한 코드가 붙으며, 키는 아무리 잘 지켜도 운영사의 키 보관 서비스에 있습니다. 둘째, 내가 가진 계정에 API 지갑을 연결하는 방식이면 출금 권한은 내 지갑에 남습니다. 두 봇 모두 주문에 어떤 빌더·추천인 코드가 붙는지 문서에 적지 않았으니, 체결 내역의 수수료 줄을 확인하세요.

7. 코딩 없이 쓰는 내장 자동 주문: TWAP·스케일·체이스·추적 손절

하이퍼리퀴드 한국어 화면의 주문창에는 시장 · 지정가 · 프로 탭이 있고, 선물 종목의 프로 메뉴에는 체이스, 스케일, 스톱 지정가, 스톱 시장가, 테이크 지정가, 테이크 시장가, 추적 손절, TWAP가 있습니다(2026년 10월 22일 로그인 전 화면 확인). "봇"을 찾는 사람 상당수에게는 이것으로 충분합니다.

하이퍼리퀴드 한국어 화면 프로 메뉴: 체이스, 스케일, 스톱 지정가, 스톱 시장가, 테이크 지정가, 테이크 시장가, 추적 손절, TWAP, 2026년 10월 22일
선물 종목(ETH-USDC)의 프로 메뉴(2026년 10월 22일 촬영). TWAP와 체이스, 스케일, 추적 손절이 코딩 없이 쓰는 자동 주문입니다.
주문 유형자동으로 해 주는 일맞는 용도API로?
TWAP큰 주문을 30초 이상 간격의 작은 주문으로 나눠 5분~7일 동안 체결합니다. 무작위화, 트리거 가격, 최고·최저 가격을 선택할 수 있습니다호가를 크게 움직이지 않고 진입·청산API 가능(twapOrder). 트리거·최고·최저 가격은 앱 전용, 파이썬 SDK 함수 없음
스케일시작 가격과 끝 가격 사이에 지정가 주문을 사다리처럼 깔고, 주문 개수와 크기 비율을 정합니다분할 진입, 분할 익절묶음 주문으로 직접 구현
체이스최우선 매수·매도 호가보다 한 틱 안쪽으로 가격을 계속 고치는 포스트 온리(ALO) 지정가. 정해 둔 최대 추격 거리까지만 따라갑니다화면을 보지 않고 메이커로 체결불가: 내 브라우저 탭에서 실행(동시에 최대 5개)
추적 손절가장 유리한 마크 가격을 정해 둔 가격 차나 %만큼 따라가는 스톱. 활성화 가격을 따로 둘 수 있습니다선물에서 수익 구간 길게 가져가기API 가능(trailingStop 액션, 선물만, 파이썬 SDK 함수 없음)
이익 실현 / 손실 방지 (TP/SL)마크 가격 기준 익절·손절 트리거. 주문 하나나 포지션 전체에 붙입니다모든 포지션 보호API 가능(트리거 주문, tpsl)

공식 문서(주문 유형, exchange 엔드포인트)와 앱 주문창 기준, 2026년 10월 22일 확인. TP/SL은 마크 가격으로 발동합니다. TWAP 최소 금액은 $100입니다. 내장 빙산 주문과 내장 그리드·적립식 봇은 없습니다. TWAP는 거래소에서 돌아가므로 브라우저를 닫아도 계속되지만, 체이스는 탭을 닫으면 멈춥니다.

손절가 설정, 이익 실현 / 손실 방지 체크박스, 감소만 옵션 사용법은 하이퍼리퀴드 손절·익절(TP/SL) 설정 방법에 한국어 화면으로 정리했습니다. 추적 손절만 따로 보려면 추적 손절 튜토리얼 (영문), TWAP는 TWAP 주문 가이드 (영문)를 보세요.

8. 봇이 지켜야 할 API 요청 한도

주문에 가스비가 없으니 봇이 할 수 있는 양의 상한은 수수료가 아니라 요청 한도입니다. 한도는 두 종류입니다. IP당(API 서버와 얼마나 빨리 대화하나)과 주소당(내 계정이 거래로 얼마나 많은 액션을 벌었나)입니다.

한도값설명
IP당 REST 가중치분당 1,200그 IP에서 보내는 주문(exchange)·조회(info)·탐색기 요청을 모두 합산
주문 액션 가중치1 + floor(묶음 개수 ÷ 40)주문·취소 1건은 1, 79건 묶음은 2
info 가중치 2l2Book, allMids, clearinghouseState, orderStatus 등반복 조회에 쓰는 가벼운 요청
info 가중치 20그 밖의 info 요청userFills 같은 페이지형 요청은 20건마다 가중치 추가(candleSnapshot은 60건마다)
WebSocket (IP당)연결 10개, 분당 신규 30개, 구독 1,000개사용자별 구독은 최대 10명, 메시지는 분당 2,000개
주소당 액션계정 생성 후 거래한 1 USDC마다 1회 + 처음 10,000회조회가 아니라 주문·취소 같은 액션만 계산. 다 쓰면 10초에 1회로 제한
주소당 취소min(한도 + 100,000, 한도 × 2)한도에 걸린 봇도 주문은 거둘 수 있게
미체결 주문 수1,000개 + 거래량 $5M마다 1개, 최대 5,000개1,000개 이상 열려 있으면 새 감소만·트리거 주문이 거절됨
논스(nonce)서명자당 최근 100개 보관중복 없이, (현재 − 2일, 현재 + 1일) 범위 안이어야 함

출처: 하이퍼리퀴드 문서 "Rate limits and user limits", "Nonces and API wallets", 2026년 10월 22일 확인. 하위 계정은 주소당 한도에서 별도 사용자로 계산됩니다. 주문 n개 묶음은 IP 한도에서는 1요청, 주소 한도에서는 n요청입니다.

주소당 예산. 모든 주소는 10,000회로 시작해 거래량 1 USDC마다 1회씩 늘어납니다. userRateLimit info 요청(info.user_rate_limit(address))으로 cumVlm, nRequestsUsed, nRequestsCap, nRequestsSurplus를 확인하세요. 1분마다 주문 20개를 취소하고 다시 까는 그리드 봇은 하루 28,800회를 쓰므로, 그만큼 거래량을 만들지 못하면 새 주소는 약 8시간 만에 한도를 다 쓰고 10초에 1회로 묶입니다. 해결책은 조용한 봇입니다. 가격이 한 칸 다 움직였을 때만 주문을 고치고, 간격을 넓히고, 타이머가 아니라 체결이 주문 변경을 이끌게 하세요. 계정은 reserveRequestWeight로 요청 1회당 0.0005 USDC에 여유를 살 수도 있습니다(1만 회에 5 USDC). 한도를 늘리려고 다른 사람 명의 계정을 끌어오는 것은 아래 11장의 금융위원회 고발 사건에 등장한 행위입니다.

IP당 예산. clearinghouseState(가중치 2)를 0.1초마다 조회하면 분당 600회, 가중치 1,200로 예산 전체를 씁니다. 같은 계정 데이터를 WebSocket으로 받으면 REST 비용이 없습니다. 주문을 최대 79개씩 묶으면 묶음당 가중치가 2 이하입니다.

  • 데이터는 WebSocket, 액션은 REST. l2Book, userFills, orderUpdates를 구독하고 주문·포지션 상태는 로컬에 보관하세요.
  • 100 ms마다 묶어서 보내기. ALO(포스트 온리) 묶음은 검증인이 우선 처리하므로 IOC·GTC와 섞지 말고 따로 보내세요. 취소는 빠른 처리 옵션으로 보냅니다.
  • 취소 후 재주문보다 주문 수정. 거절되면 무작위 간격을 두고 물러나고, 로컬 한도가 바닥나도 감소만·포지션 정리 명령은 버리지 마세요.
  • 프로세스 하나, API 지갑 하나, 하위 계정 하나. 논스는 서명자별로 관리되므로 나눠 두면 충돌이 없습니다.

9. 적립식(DCA)·펀딩비 캐리·마켓메이킹

적립식 매수(DCA)

정해진 금액을 정해진 주기로 삽니다. 예를 들어 매일 5만원(약 37.48 USDC)어치 현물 HYPE나 BTC를 산다면, 현물 주문은 견적 토큰 10단위 이상이어야 하고, 시장가 매수 수수료는 현물 테이커 0.070% 기준 약 0.026 USDC(약 35원)입니다. 체결이 안 되는 날이 있어도 된다면 현재가보다 조금 아래 지정가(메이커 0.040%)가 더 쌉니다. 내장 TWAP는 적립식 도구가 아닙니다. 주문 하나를 최대 7일에 걸쳐 나눌 뿐 반복하지 않습니다.

펀딩비 캐리(델타 중립)

하이퍼리퀴드 펀딩비는 매시간 정산되고 시간당 4%가 상한입니다. 이자 부분은 8시간당 0.01%, 프리미엄이 0일 때 연 약 11.6%를 롱이 숏에게 냅니다. 캐리 봇은 현물을 들고 선물을 숏해서 이를 받습니다. BTC 펀딩비는 2026년 10월 15일까지 30일 동안 합계 0.7305%였습니다. 1,000만원 규모라면 진입·청산에 기본 테이커 수수료로 약 23,000원이 들어서 몇 주는 지나야 본전이고, 펀딩비가 마이너스로 돌아설 수도 있습니다. 방법과 계산은 펀딩비 차익거래 가이드 (영문)에 있습니다.

마켓메이킹: 메이커 수수료, 리베이트, 진짜 위험

하이퍼리퀴드 마켓메이킹은 허가가 필요 없습니다. 계정에 입금하고 API 지갑을 만들어 포스트 온리 주문으로 양쪽 호가를 내면 됩니다. 문서에 따르면 지정 마켓메이커 프로그램도, 특별 리베이트나 수수료도, 지연 시간 혜택도 없고 모두 같은 수수료표를 씁니다.

메이커 리베이트14일 전체 메이커 거래량 중 내 비중요율 (체결마다 받음)
리베이트 1단계0.5% 초과-0.001%
리베이트 2단계1.5% 초과-0.002%
리베이트 3단계3% 초과-0.003%

메이저 코인에서 개인 마켓메이킹이 손해인 이유. 2026년 9월 25일 공개 호가창의 스프레드는 BTC 0.12bp($1), ETH 0.37bp($0.10), HYPE 0.11bp, NEAR 2.43bp였고, 기본 메이커 수수료는 한쪽당 1.5bp입니다. BTC 스프레드를 통째로 먹어도 버는 것보다 수수료가 더 큽니다. 살아남는 개인 메이커는 덜 붐비는 종목에서 더 넓게 호가를 내고, 재고를 작게 유지하며, 들고 있는 재고에 매시간 펀딩비가 붙는다는 것을 기억합니다. scheduleCancel과 별도 감시 프로세스는 선택이 아닙니다. 봇 없이 하려면: 프로토콜 볼트 HLP가 하이퍼리퀴드 전체에서 마켓메이킹을 합니다(마지막 빌드 기준 연 수익률 3.78%, 예치마다 4일 잠금, 손실이 날 수 있음). 볼트·HLP는 카피트레이딩·볼트 가이드에 있습니다.

10. 봇이 내는 수수료 (원화 예시)

티어14일 거래량선물 테이커선물 메이커추천인 코드 적용 메이커
0$5M 미만0.045%0.015%0.0144%
1$5M 초과0.040%0.012%—
2$25M 초과0.035%0.008%—
3$100M 초과0.030%0.004%—
4~6$500M 초과0.028%0.000%—

하이퍼리퀴드 수수료표(facts 레지스트리). 현물 거래량은 티어 계산에서 2배로 칩니다. 현물 기본 수수료는 0.070% / 0.040%. HYPE 스테이킹으로 5~40% 할인되고, 추천인 할인(처음 $25M까지 4%)은 그 위에 더해집니다. 주문·취소 가스비는 없고, USDC 출금 비용은 0.2 USDC + HYPE로 내는 극소량의 HyperEVM 가스비입니다.

한 달 테이커 거래량이 10억원(약 749,625 USDC)인 봇은 기본 요율로 약 450,000원, 추천인 할인 4%를 받으면 약 432,000원을 냅니다. 같은 거래량을 메이커로만 체결하는 봇은 약 150,000원입니다(2026년 10월 22일 업비트 USDC 1,334원 기준). 제3자 봇은 그 위에 빌더 수수료를 더 받습니다(상한: 선물 0.1%, 현물 1%. 승인은 더보기 → 빌더 코드에서 취소). 자세한 내용은 하이퍼리퀴드 수수료에 있고, 앱·봇 주문에서 추천 할인이 실제로 남는지는 추천인·빌더 코드 조사에서 확인했습니다.

11. 코인 자동매매의 현실과 사기 주의

"코인 자동매매 현실"이나 "자동매매 후기"를 찾는 분께 솔직하게 말하면, 봇은 규칙을 지치지 않고 실행하는 도구일 뿐 돈을 버는 규칙을 대신 찾아 주지 않습니다. 저희는 이 글의 어떤 전략도 수익을 약속하지 않습니다.

  • 백테스트와 실전은 다릅니다. 과거 차트에서 잘 되던 그리드도 실전에서는 수수료, 체결 안 되는 주문, 펀딩비, 끊긴 연결 때문에 결과가 달라집니다. 작은 금액으로 몇 주 돌려 보고 키우세요.
  • 가장 흔한 손실은 버그와 방치입니다. 같은 주문을 반복해서 내는 루프, 범위 이탈 후 계속 사는 그리드, 꺼진 줄 모르는 봇. 손실 한도와 강제 종료 스위치는 전략보다 먼저 만드세요.
  • "수익 보장" 유료 프로그램은 피하세요. "월 몇 % 확정 수익", "AI 자동매매로 원금 보장"을 내세워 프로그램이나 이용권을 파는 곳, 오픈채팅·리딩방에서 봇을 파는 곳, 메인 지갑 개인키나 시드 문구를 요구하는 곳은 쓰지 마세요. 하이퍼리퀴드 API 지갑은 출금 권한이 없으므로, 출금 권한이나 메인 키가 "필요하다"는 프로그램은 그 자체로 위험 신호입니다. 공식 SDK와 위의 주요 오픈소스 봇은 무료입니다.
  • 가짜 저장소와 가짜 패키지. 4장의 확인 목록을 지키고, 의존성 버전을 고정하고, 메인 지갑 키가 없는 컴퓨터에서 봇을 돌리세요.
  • 자동매매로 한 시세조종도 고발됩니다. 금융위원회는 2026년 9월 23일 API 자동매매 프로그램 등을 이용한 초단기 시세조종 3건을 포함한 가상자산 불공정거래 사건 4건을 수사기관에 고발·통보했다고 밝혔습니다(금융위원회 보도자료). 그중 한 사건은 거래소의 API 주문 횟수 제한을 피하려고 타인 명의 계정까지 동원한 경우였습니다. 국내 거래소에서 있었던 사건이지만, 거래량을 부풀리거나 한도를 피하려는 봇은 어디서든 만들지 마세요.

그래도 직접 해 보고 싶다면 순서는 이렇습니다. 테스트넷이나 아주 작은 금액으로 시작하고, 레버리지는 낮게, 손실 한도는 코드에 넣고, 사람이 매일 결과를 확인합니다.

12. 보안과 위험 관리, 세금

  • API 지갑은 출금은 못 하지만 잔고를 엉망으로 거래할 수는 있습니다. 봇마다, 하위 계정마다 하나씩 쓰고 주소는 다시 쓰지 마세요.
  • 만료일: API 지갑은 최대 180일 동안 유효합니다. 만료일을 달력에 적어 두면 봇이 조용히 멈추는 일을 막을 수 있습니다.
  • 데드맨 스위치: schedule_cancel은 정해 둔 시각에 모든 미체결 주문을 취소합니다. 감소만 청산과 함께 쓰세요.
  • 코드 안의 한도: 최대 포지션, 분당 최대 주문 수, 일일 손실 한도, 수동 강제 종료.
  • 청산 거리: 봇에는 낮은 레버리지를 쓰세요. 교차 마진에서는 다른 포지션이 청산 가격을 함께 움직입니다(교차 vs 격리 마진).
  • 한국에서 이용할 때: 하이퍼리퀴드 이용약관(2026년 6월 15일 개정)상 한국은 이용 제한 국가가 아님(2026년 10월 19일 확인). 봇을 쓴다고 이 조건이 바뀌지는 않습니다. FIU 관련 내용은 하이퍼리퀴드 리뷰의 한국 이용 항목에 날짜와 함께 정리했습니다.

세금. 가상자산 소득 과세 시작일은 현행법상 2027년 1월 1일 (세 차례 유예, 추가 유예 논의 중)입니다(2026년 10월 4일 확인). 봇은 체결 건수가 많아 나중에 손익을 계산하기 어려우니 지금부터 체결 기록을 내려받아 두세요(거래 내역 CSV 내보내기 (영문)). 과세 방식과 해외 거래소·DEX 손익 정리는 코인 세금: DEX·해외 거래소 정리에 있습니다.

자주 묻는 질문

하이퍼리퀴드에서 자동매매 봇을 돌릴 수 있나요?

네. 하이퍼리퀴드는 공개 REST·WebSocket API와 공식 파이썬 SDK(hyperliquid-python-sdk 0.24.0, MIT 라이선스, 2026년 6월 4일 배포, 2026년 10월 22일 기준 최신)를 제공하고, 타입스크립트·러스트용 커뮤니티 SDK도 있습니다. 봇은 내 계정 대신 주문할 수 있지만 출금은 못 하는 API 지갑(에이전트 지갑)으로 서명합니다. 주문·취소에는 가스비가 없고, 체결될 때 기본 티어 기준 테이커 0.045%, 메이커 0.015% 수수료만 냅니다.

파이썬으로 하이퍼리퀴드 자동매매를 하려면 무엇이 필요한가요?

세 가지입니다. ① 입금된 하이퍼리퀴드 메인 계정(최소 입금 5 USDC), ② 더보기 → API에서 만든 API 지갑의 개인키, ③ pip install hyperliquid-python-sdk(파이썬 3.9 이상). 코드에서는 API 지갑 키로 서명하고, 잔고·주문 조회는 메인 계정 주소로 합니다. API 지갑 주소로 조회하면 빈 계정이 나옵니다. 이 글의 예제는 ETH에 포스트 온리 주문 10개를 한 번에 깔고 데드맨 스위치(schedule_cancel)를 거는 코드입니다.

깃허브에 있는 하이퍼리퀴드 자동매매 봇을 써도 되나요?

쓸 수는 있지만 먼저 읽어 보세요. Hummingbot(Apache-2.0), Freqtrade(GPL-3.0), passivbot(Unlicense), Chainstack의 작은 파이썬 그리드 봇이 하이퍼리퀴드를 지원합니다. 라이선스, 마지막 커밋, 처음 실행할 때 무엇을 하는지 확인하세요. 예를 들어 CCXT는 옵션을 바꾸지 않으면 자체 추천인 코드(CCXT1)와 0.01% 빌더 수수료를 설정하려고 합니다. 폴더를 여는 순간 코드를 실행하는 저장소는 절대 실행하지 마세요.

그리드 매매 봇은 수익이 나나요?

가격이 범위 안에서 오르내릴 때만 납니다. 1,000만원(약 7,496 USDC)을 20칸, 간격 0.5%로 나누면 한 번 왕복할 때 칸당 약 2,350원(수수료 150원 차감)을 남깁니다. 반대로 가격이 범위 아래로 빠지면 매수만 체결된 채 손실 포지션을 들고 있게 되고, 레버리지를 쓰면 청산될 수 있으며, 들고 있는 포지션에는 펀딩비가 붙습니다. 수익을 보장하는 그리드 설정은 없습니다.

하이퍼리퀴드 텔레그램 봇은 안전한가요?

봇 서비스가 만든 지갑으로 거래하거나, 내가 가진 계정에 API 지갑을 연결해 거래합니다. PvP는 키를 Turnkey 보안 영역에 보관하고 내보낼 수 있다고 밝히고, Hypurr Fun은 키를 내보낼 수 있는 개인 지갑을 만들거나 API 지갑을 연결하게 합니다. 어느 쪽이든 운영사의 인프라를 믿어야 하고, 봇이 만든 지갑은 내 추천인 코드가 없는 새 하이퍼리퀴드 계정입니다. 내 계정에 API 지갑을 연결하는 방식이면 출금 권한은 내게 남습니다.

봇에 하이퍼리퀴드 API 키를 줘도 출금당하지 않나요?

API 지갑은 주문을 넣고 취소할 수 있지만 출금 권한이 없어서, 키가 새도 누군가 엉망으로 거래할 수는 있어도 자금을 다른 주소로 보낼 수는 없습니다. 키는 환경 변수나 비밀 관리 도구에 두고, 봇마다 API 지갑과 하위 계정을 따로 쓰세요. 메인 지갑의 시드 문구나 개인키를 달라는 프로그램은 쓰지 마세요. API 지갑은 최대 180일 동안 유효하고, 한 번 쓴 주소는 다시 쓰지 않습니다.

봇으로 거래해도 추천인 할인이 적용되나요?

메인 계정에서 봇이 낸 주문에는 적용됩니다. 추천인 코드는 처음 $25M 거래량까지 수수료를 4% 깎아 주고, 하위 계정과 볼트에는 적용되지 않습니다. 빌더 코드가 붙어도 할인은 남지만 빌더 수수료는 그대로 냅니다. 코드는 거래량 $10,000를 넘기 전에 계정에 붙어 있어야 하고, CCXT 같은 라이브러리는 코드가 없는 계정에 자체 코드를 붙이려 하니 봇을 연결하기 전에 코드로 가입하세요.

하이퍼리퀴드 API 요청 한도는 얼마인가요?

IP당 REST 가중치는 분당 1,200(주문 1건은 가중치 1), WebSocket은 연결 10개와 구독 1,000개입니다. 주소당 액션은 계정 생성 후 거래한 1 USDC마다 1회에 처음 10,000회가 더해지고, 다 쓰면 10초에 1회로 줄어듭니다. 미체결 주문은 1,000개에 거래량 $5M마다 1개씩 늘어 최대 5,000개입니다.

코인 자동매매 프로그램을 사면 돈을 벌 수 있나요?

봇은 정해 둔 규칙을 지치지 않고 실행할 뿐, 돈을 버는 규칙을 대신 찾아 주지 않습니다. "월 몇 % 수익 보장" 같은 유료 자동매매 프로그램, 리딩방에서 파는 봇, 메인 지갑 키나 시드 문구를 요구하는 서비스는 피하세요. 하이퍼리퀴드의 공식 SDK와 주요 오픈소스 봇은 무료입니다. 금융위원회는 2026년 9월 23일 API 자동매매 프로그램 등을 이용한 초단기 시세조종 3건을 포함한 가상자산 불공정거래 사건 4건을 수사기관에 고발·통보했다고 밝혔습니다. 봇으로 낸 주문도 시세조종으로 고발될 수 있다는 뜻입니다.

봇이 거래할 계정부터 만드세요

첫 입금 전에 HOLYGRAIL로 하이퍼리퀴드에 가입하면, 봇이 메인 계정에서 낸 주문까지 처음 $25M 거래량의 수수료가 4% 할인됩니다. 그다음 API 지갑을 만드세요. 거래량이 $10,000를 넘은 계정에는 코드를 붙일 수 없습니다.

HOLYGRAIL로 하이퍼리퀴드 시작 →

느린 봇을 수수료 없이 돌릴 곳을 찾는다면 라이터 Standard 계정은 수수료 0%입니다(코드 718610TD, 라이터 API 가이드 (영문)).

고지: HOLYGRAIL과 718610TD는 이 사이트의 추천인 코드로, 추천한 계정 수수료의 일부를 받습니다(이용자 부담은 늘지 않음). 위에 나온 봇·라이브러리·텔레그램 서비스와는 관계가 없습니다. 코드는 설명용이며 운영용 소프트웨어나 투자 조언이 아닙니다. 요청 한도, 수수료, SDK, 깃허브 저장소, 봇 문서는 2026년 10월 22일, 한국어 주문 화면은 2026년 10월 22일에 확인했고, 원화 금액은 2026년 10월 22일 업비트 USDC 1,334원 기준입니다. 하이퍼리퀴드 이용약관상 한국은 이용 제한 국가가 아닙니다(2026년 10월 19일 확인). 국내 규정과 세금은 이용자가 확인해야 하며, 이 글은 법률 자문이 아닙니다.