할 수 있습니다. 공개 API로
할 수 있습니다. Hyperliquid는 거래 인터페이스 전체를 공개 HTTP API로 내놓았고, 웹 화면이 쓰는 것과 같은 것입니다. 읽기에는 키가 필요 없고, 쓰기에는 서명된 액션이 필요하며, 계좌는 API 지갑을 승인해 자기 키 대신 그것들에 서명하게 할 수 있습니다.
| 무엇을 위한 것인가 | 어디인가 |
|---|---|
| 읽기: 중간 가격, L2 호가창, 캔들, 펀딩비 이력, 계좌의 상태. 키도 서명도 없습니다. | POST https://api.hyperliquid.xyz/info |
쓰기: order, cancel, modify, updateLeverage, approveAgent, withdraw3과 그 밖의 것들, 모두 서명합니다. | POST https://api.hyperliquid.xyz/exchange |
실시간 스트림(allMids, l2Book, trades, candle, userFills), 그리고 HTTP로 보내는 것의 대안. | wss://api.hyperliquid.xyz/ws |
| 테스트 거래소의 같은 세 경로. | api.hyperliquid-testnet.xyz |
중요한 주소는 셋이고 아래에 있습니다. 그리고 이 페이지의 모든 수치는 2026년 10월 5일 문서의 것입니다.
문서가 꼽는 SDK들
서명된 액션을 손으로 조립할 필요는 없습니다. 문서는 공식 Python SDK인 hyperliquid-dex/hyperliquid-python-sdk, 커뮤니티 Rust SDK, 두 개의 커뮤니티 TypeScript SDK(nktkas/hyperliquid와 nomeida/hyperliquid), 그리고 CCXT를 꼽습니다.
서명은 다시 쓰는 것보다 빌려 올 값이 있는 부분입니다. 액션은 정확한 모양으로 직렬화되어 서명되고, 필드 하나가 틀린 모양은 거부됩니다. 그 주문은 호가창에 닿지 못합니다.
API 지갑과 nonce
마스터 계좌는 API 지갑들을 승인해, 마스터 계좌나 그 하위 계좌를 대신해 서명하게 할 수 있습니다. 그것들은 서명만 합니다. 계좌의 데이터를 조회하려면 그 계좌의 실제 주소를 넘겨야 하고, 에이전트 지갑을 쓰면 빈 결과가 나옵니다.
nonce는 보이는 것보다 엄격합니다. Hyperliquid는 주소마다 가장 높은 nonce 100개를 보관하고, 새 액션에는 그 집합에서 가장 작은 것보다 크고, 전에 쓰인 적이 없고, (T 빼기 2일, T 더하기 1일) 창 안에 드는 nonce가 필요합니다. 여기서 T는 그 블록의 unix 밀리초 타임스탬프입니다.
API 지갑은 이름 없는 새 지갑이 등록될 때, 새 이름 있는 지갑이 기존 이름을 가져갈 때, 만료될 때, 또는 그것을 등록한 계좌에 자금이 남지 않을 때 솎아집니다. 문서는 등록이 해제된 에이전트는 nonce 상태가 솎일 수 있어 전에 서명한 액션이 재생될 수 있다고 경고합니다. 오래된 에이전트를 되살리지 말고 새 에이전트 지갑을 만드십시오.
레이트 한도, 문서대로
- IP마다. REST 요청은 분당 1200의 합산 가중치 한도를 함께 씁니다. exchange 액션의 가중치는
1 + floor(batch_length / 40)이므로 묶어 보내면 거의 공짜입니다. info 요청은 대부분 가중치 20, 몇 개는 2이고,userRole은 60입니다. - 주소마다. 누적으로 1 USDC를 거래할 때마다 1 요청. 처음에 10000 요청의 여유가 있고, 그다음에는 10초에 하나입니다. 취소에는 더 넓은 여유가 있습니다.
- Websocket. 연결은 최대 10개, 분당 새 연결 30개, 구독 1000개, 분당 보내는 메시지 2000개, 동시에 떠 있는 post 메시지 100개까지입니다.
- 미체결 주문. 기본 한도는 1000이고, 거래량 500만 USDC마다 하나씩 늘어나며, 합계 5000에서 멈춥니다.
주소마다의 한도는 새 프로그램을 놀라게 합니다. 그 여유는 거래해서 벌어야 하는 것인데, 무턱대고 재시도하는 루프는 그것을 아무것도 아닌 일에 써 버립니다.
스크립트, 봇, 어시스턴트
| 그것이 무엇인가 | 무엇이 결정하는가 | 당신에게 무엇을 요구하는가 |
|---|---|---|
| 스크립트 | 당신이 그것을 쓸 때 결정했습니다. 순서를 돌릴 뿐 아무것도 고르지 않습니다. | 돌리기 전에 읽는 것. 그 한도는 당신이 입력한 줄들입니다. |
| 봇 | 당신이 쓴 규칙이, 조건이 맞을 때마다, 아무도 보지 않는 채로 결정합니다. | 규칙 밖의 한도, 그리고 한 명령으로 멈추는 수단. |
| 어시스턴트(AI 에이전트) | 모델이 제안하고, 코드가 그 제안을 수치로 확인합니다. | 스스로 넓힐 수 없는 경계, 그리고 출금할 수 없는 키. |
API는 셋 가운데 어느 것이 부르는지 가릴 수 없고, 셋에 같은 규칙을 적용합니다. 다른 것은 결정이 어디서 내려지는지, 그리고 그것이 틀렸을 때 무슨 일이 생기는지입니다. 틀린 스크립트는 한 번 틀리고, 봇은 밤새 틀립니다.
Locker Protocol Agentic은 세 번째 종류입니다. 사람에게도 AI 에이전트에게도 쓰이는 lpa, 같은 명령을 도구로 내놓는 MCP 서버, 어떤 주문 전에도 두 번 확인되는 로컬 정책, 그리고 당신 자신의 지갑으로 서명한 위임장입니다. 결과는 약속하지 않습니다.