Предисловие
Недавно платформа FMZ добавила поддержку Hyperliquid DEX — высокопроизводительной децентрализованной биржи, предоставляющей пользователям больше возможностей для участия в децентрализованных транзакциях. В настоящее время функция кастодиана платформы FMZ полностью обновлена для поддержки спотовых и бессрочных контрактных транзакций Hyperliquid и охвата всех функций API DEX.
Обзор платформы Hyperliquid
Hyperliquid — это высокопроизводительный блокчейн L1, оптимизированный с нуля с целью создания полностью открытой финансовой системы на основе блокчейна. Пользователи могут создавать приложения независимо, взаимодействуя с эффективными собственными компонентами, обеспечивая при этом удобство работы конечного пользователя.
Производительность Hyperliquid L1 достаточна для поддержки экосистемы финансовых приложений, не требующей разрешений. Все заказы, снятия заказов, транзакции и ликвидации выполняются в блокчейне абсолютно прозрачным образом, с задержкой блоков менее 1 секунды. В настоящее время сеть поддерживает мощность обработки до 100 000 заказов в секунду.
Hyperliquid L1 использует собственный алгоритм консенсуса HyperBFT, созданный по мотивам Hotstuff и его последователей. Как механизм консенсуса, так и архитектура сети оптимизированы снизу вверх для удовлетворения потребностей высокопроизводительного блокчейна.
С помощью этого руководства мы надеемся помочь вам быстро начать программную и количественную торговлю Hyperliquid DEX на платформе FMZ и открыть для себя больше торговых возможностей.
Практика содержания
REST-протокол
- Практика взаимодействия с рынком.
- Практика торгового интерфейса (размещение ордеров, отмена ордеров).
- Практики запросов, связанных с транзакциями (счета, заказы).
- Другие функции (спот, перевод контрактов, вывод средств из хранилища, перевод активов в кошелек и т. д.).
Протокол веб-сокета
- Практика подписки на информацию обмена (в интерфейсе REST отсутствует интерфейс Trades, который дополняется интерфейсом Websocket)
Hyperliquid
-
Типы торговли
Hyperliquid делится на спотовые и бессрочные контракты на основе торговых разновидностей. На основе архитектуры платформы FMZ он также делится на объекты спотовой биржи Hyperliquid и объекты фьючерсной биржи Hyperliquid на платформе FMZ. Они соответствуют различным разновидностям Hyperliquid DEX соответственно.На странице «Добавить биржу» платформы FMZ вы можете настроить объекты спотовой и фьючерсной биржи Hyperliquid:
-
Экологический отдел
Как и большинство бирж, Hyperliquid имеет тестовую среду.-
Адрес приложения Mainnet:
По опыту реального использования основная сеть относительно стабильна, а скорость также хорошая.
Соответствующий адрес узла интерфейса API протокола REST:https://api.hyperliquid.xyz。
Информация, связанная с подписанием сообщений, также отличается:source == "a"，chainId = 42161 -
Адрес приложения тестовой сети:
Тестовая сеть часто дает сбои, но она используется только как тестовый интерфейс и для ознакомления с торговыми функциями на DEX.
Соответствующий адрес узла интерфейса API протокола REST:https://api.hyperliquid-testnet.xyz。
Информация, связанная с подписанием сообщений, также отличается:source == "b"，chainId = 421614
-
Информация о подключении, входе в систему и конфигурации кошелька
Как и в случае с большинством бирж DEX, вы можете использовать приложение кошелька для сканирования QR-кода для подключения к Hyperliquid (переключите кошелек на Arbitrum и отсканируйте код для входа, тестовая сеть и основная сеть одинаковы). .
-
Подключение кошелька к Hyperliquid
-
Testnet Faucet (тестовый депозит активов USDC)
Если вы хотите сначала ознакомиться с тестовой сетью, вы можете найти кран прямо на странице Hyperliquid после подключения своего кошелька к Hyperliquid.
Вы можете запросить тестовые активы. Получив USDC для тестирования, нажмите кнопку «Депозит», чтобы внести его в Hyperliquid (лучше всего иметь немного ETH для тестовой сети Arbitrum).
-
Внесите активы USDC в основную сеть
Нажмите кнопку «Депозит», чтобы внести депозит. Для этого потребуется верификация кошелька и будет потрачено немного ETH на Arbitrum.
-
Создайте конфигурацию прокси-кошелька
При выполнении ручных транзакций на странице Hyperliquid APP, страница автоматически сгенерирует адрес прокси-кошелька и закрытый ключ, которые записываются в браузер и используются для таких операций, как размещение заказов на странице браузера. Если мы хотим сделать программные и количественные Каким образом транзакция должна получить эту информацию о конфигурации?
Создать необходимый адрес прокси-кошелька и соответствующий ему закрытый ключ можно на странице API Hyperliquid:
-
- Дайте имя прокси-кошельку, который вы хотите создать.
-
- Сгенерируйте адрес и закрытый ключ.
-
- Авторизуйте прокси-кошелек, используя кошелек, подключенный к Hyperliquid.
-
-
Настройте адрес прокси-кошелька и закрытый ключ на FMZ
Затем вы можете настроить эту информацию на платформе FMZ (интерфейс настройки указан выше).
- Адрес кошелька: адрес кошелька, подключенного к Hyperliquid (обратите внимание, это не адрес прокси-кошелька).
- Wallet PrivateKey: закрытый ключ кошелька, подключенный к Hyperliquid (необязательно, требуется только при вызове API, например, для переводов, можно оставить пустым).
- Секретный ключ: закрытый ключ прокси-кошелька (сгенерирован на предыдущем шаге, закрытый ключ отображается после авторизации).
Гиперликвидная практика на FMZ
Информация, необходимая для настройки объекта обмена:
- Адрес кошелька используется для запроса информации о транзакциях пользователя.
- Кошелек PrivateKey используется для переводов, трансферов и других операций
- Секретный ключ используется для операций, связанных с транзакциями.
После завершения конфигурации мы можем протестировать ее на платформе FMZ. Мы напрямую используем «инструмент отладки» платформы FMZ для практики тестирования.
Если вы используете объект обмена Hyperliquid, настроенный с использованием информации тестовой сети, вам потребуется выполнить некоторые операции переключения при его использовании, например:
javascript
function main() {
// REST协议API地址切换到测试网
exchange.SetBase("https://api.hyperliquid-testnet.xyz")
// source : a 主网 , b 测试网
exchange.IO("source", "b")
return exchange.GetAccount()
}
Конфигурация mainnet не требует вышеуказанной операции переключения. Интерфейсы API, связанные со спотовыми и фьючерсными продуктами на бирже Hyperliquid DEX, почти одинаковы, с небольшими различиями в деталях. Далее мы используемИнформация о конфигурации основной сетииИнформация о конфигурации тестовой сетииз Гиперликвидные фьючерсыОбменяйтесь объектами для тестирования.
Информация о сорте
javascript
function main() {
var markets = exchange.GetMarkets()
if (!markets) {
throw "get markets error"
}
var tbl = {
type: "table",
title: "test markets",
cols: [
"key", "Symbol", "BaseAsset", "QuoteAsset", "TickSize", "AmountSize", "PricePrecision", "AmountPrecision", "MinQty",
"MaxQty", "MinNotional", "MaxNotional", "CtVal", "CtValCcy"
],
rows: []
}
for (var symbol in markets) {
var market = markets[symbol]
tbl.rows.push([
symbol, market.Symbol, market.BaseAsset, market.QuoteAsset, market.TickSize, market.AmountSize,
market.PricePrecision, market.AmountPrecision, market.MinQty, market.MaxQty, market.MinNotional, market.MaxNotional, market.CtVal, market.CtValCcy
])
}
LogStatus("`" + JSON.stringify(tbl) + "`")
}
Данные книги заказов
javascript
function main() {
var depth = exchange.GetDepth("ETH_USD.swap")
var asks = depth.Asks
var bids = depth.Bids
Log("买3", bids[2])
Log("买2", bids[1])
Log("买1", bids[0])
Log("卖1", asks[0])
Log("卖2", asks[1])
Log("卖3", asks[2])
}
Активы счета
javascript
function main() {
var account = exchange.GetAccount()
return account
}
Заказать и проверить
javascript
function main() {
var symbols = ["ETH_USD.swap", "XRP_USD.swap", "HYPE_USD.swap"]
var arrDir = ["market_buy", "sell", "buy"]
var markets = exchange.GetMarkets()
var ids = []
for (var i in symbols) {
var symbol = symbols[i]
var side = arrDir[i]
var ticker = exchange.GetTicker(symbol)
var info = markets[symbol]
exchange.SetPrecision(info.PricePrecision, info.AmountPrecision)
// USDC
var qty = 15
var price = null
var amount = null
if (side == "market_buy") {
price = -1
side = "buy"
amount = qty / ticker.Last
} else {
price = side == "buy" ? ticker.Last * 0.9 : ticker.Last * 1.1
amount = qty / price
}
var id = exchange.CreateOrder(symbol, side, price, amount)
ids.push(id)
}
var tbl = {type: "table", title: "test", cols: ["Symbol", "Id", "Price", "Amount", "DealAmount", "AvgPrice", "Status", "Type", "Offset", "ContractType"], rows: []}
for (var id of ids) {
var order = exchange.GetOrder(id)
tbl.rows.push([order.Symbol, order.Id, order.Price, order.Amount, order.DealAmount, order.AvgPrice, order.Status, order.Type, order.Offset, order.ContractType])
Sleep(500)
}
LogStatus("`" + JSON.stringify(tbl) + "`")
}
Отменить все заказы
javascript
function main() {
var orders = exchange.GetOrders("USD.swap")
for (var order of orders) {
exchange.CancelOrder(order.Id, order)
Sleep(1000)
}
var tbl = {type: "table", title: "test", cols: ["Symbol", "Id", "Price", "Amount", "DealAmount", "AvgPrice", "Status", "Type", "Offset", "ContractType"], rows: []}
for (var order of orders) {
tbl.rows.push([order.Symbol, order.Id, order.Price, order.Amount, order.DealAmount, order.AvgPrice, order.Status, order.Type, order.Offset, order.ContractType])
}
LogStatus("`" + JSON.stringify(tbl) + "`")
}
Переключение кредитного плеча, переключение кросс-маржи/изолированной маржи
javascript
function main() {
// 设置当前为全仓
exchange.IO("cross", true)
// 设置杠杆
exchange.SetMarginLevel("ETH_USD.swap", 10)
return exchange.GetRawJSON()
}
exchange.GetRawJSON() возвращает ответную информацию запроса на настройку кредитного плеча:
{"status":"ok","response":{"type":"default"}}
Другие интерфейсы
Поскольку параметры интерфейса биржи сложны, использовать метод кодирования URL для передачи параметров невозможно.exchange.IOПри вызове функции в качестве параметров можно передавать только строки JSON. Ниже приведены примеры вызова каждого интерфейса.
Справочная документация Hyperliquid: https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#place-an-order
Schedule Cancel (dead man's switch)
javascript
var params = {"type": "scheduleCancel", "time": new Date().getTime()}
return exchange.IO("api", "POST", "/exchange", null, JSON.stringify(params))
{"status":"err","response":"Cannot set scheduled cancel time until enough volume traded. Required: $1000000. Traded: $174.57424."}
Эта функция имеет ограничения: для использования этой функции счет должен достичь торгового уровня.
twapOrder
Создайте заказ TWAP.
javascript
function main() {
var params = {
"type": "twapOrder",
"twap": {
"a": 0,
"b": true,
"s": "1",
"r": false,
"m": 10,
"t": false
}
}
// SOL_USDT.swap , 订单量 : 1 , twapOrder 订单有头寸要求，最少100美元价值
// a : 0 , 即 SOL_USDT.swap 这个品种
return exchange.IO("api", "POST", "/exchange", null, JSON.stringify(params))
}
twapCancel
Отменить заказ TWAP.
javascript
function main() {
var params = {
"type": "twapCancel",
"a": 0,
"t": 3805
}
return exchange.IO("api", "POST", "/exchange", null, JSON.stringify(params))
}
approveAgent
Тестовая сеть, авторизуйте новый прокси-кошелек.
javascript
function main() {
var params = {
"type": "approveAgent",
"hyperliquidChain": "Testnet",
"signatureChainId": "0x66eee",
"agentAddress": "0xAAAA",
"agentName": "test02",
"nonce": new Date().getTime()
}
return exchange.IO("api", "POST", "/exchange", null, JSON.stringify(params))
}
Авторизация успешно возвращает:
{"status":"ok","response":{"type":"default"}}
- Создайте API proxy кошелек. 0xAAAA — это сгенерированный адрес кошелька (просто пример). Сохраните соответствующий закрытый ключ при его генерации.
- "test02" — имя API proxy wallet. Сгенерированная пара ключей будет отображаться на странице hyperliquid APP.
https://app.hyperliquid-testnet.xyz/APIсередина.
vaultTransfer
Изъять активы из хранилища.
javascript
function main() {
var params = {
"type": "vaultTransfer",
"vaultAddress": "0xAAA",
"isDeposit": true,
"usd": 5000000
}
return exchange.IO("api", "POST", "/exchange", null, JSON.stringify(params))
}
- «usd»: 5000000 означает 5 USDC.
- «0xAAA»: адрес хранилища.
- "isDeposit": true, управляет депозитом и пополнением.
withdraw3
Тестовая сеть, вывод средств на кошелек.
javascript
function main() {
var params = {
"type": "withdraw3",
"hyperliquidChain": "Testnet",
"signatureChainId": "0x66eee",
"amount": "5",
"time": new Date().getTime(),
"destination": "0xAAA"
}
return exchange.IO("api", "POST", "/exchange", null, JSON.stringify(params))
}
- Выведите деньги на ваш текущий адрес кошелька: «0xAAA».
usdClassTransfer
Перевод активов между спотовыми/фьючерсными контрактами (бессрочные контракты).
javascript
function main() {
var params = {
"type": "usdClassTransfer",
"hyperliquidChain": "Testnet",
"signatureChainId": "0x66eee",
"amount": "5",
"toPerp": false,
"nonce": new Date().getTime()
}
return exchange.IO("api", "POST", "/exchange", null, JSON.stringify(params))
}
- Параметр "toPerp" установлен на
falseУказывает направление вращения: фьючерсы -> спот. - Параметр "toPerp" установлен на
trueУказывает направление перевода: спот -> фьючерс.
Использование интерфейса WebSocket
Основной адрес сетевого интерфейса WS:
Mainnet: wss://api.hyperliquid.xyz/ws
Поскольку интерфейс API протокола REST не имеет интерфейса для получения данных о последних транзакциях, интерфейс Websocket имеет этот канал, на который можно подписаться.
Структура сообщения подписки
{
"method": "subscribe",
"subscription": {
"type": "trades",
"coin": "SOL"
}
}
Пример теста, выполненного в отладчике:
javascript
function main() {
var loopCount = 20
var subMsg = {
"method": "subscribe",
"subscription": {
"type": "trades",
"coin": "SOL"
}
}
var conn = Dial("wss://api.hyperliquid.xyz/ws")
conn.write(JSON.stringify(subMsg))
if (conn) {
for (var i = 0; i < loopCount; i++) {
var msg = conn.read(1000)
if (msg) {
Log(msg)
}
}
}
conn.close()
Log("测试结束")
}
END
Вышеуказанные тесты основаны на последнем кастодиане. Вам необходимо загрузить последний кастодиан для поддержки обмена Hyperliquid DEX.
Спасибо за вашу поддержку и спасибо за чтение.
- 1