Siebly 发布 Hyperliquid API 的 Node.js JavaScript SDK 教程
来源标题:Hyperliquid API JavaScript Tutorial – Node.js SDK by Siebly
Siebly 发布了面向 Node.js 的 Hyperliquid API JavaScript 教程,配套 npm 包 @siebly/hyperliquid-api 和 GitHub 示例代码。教程覆盖公共行情数据、账户状态、永续与现货下单、WebSocket 数据流与请求、Testnet 及代理、断线重连恢复。开篇示例演示用 RestClient 调用交易所状态、全市场中间价和永续元数据接口。
以下正文由 AI 翻译自 Hacker News 最新(原文版权归原站所有),可能存在偏差,重要内容请以原文为准。
Hyperliquid API JavaScript 教程(Node.js 版) 用公开市场数据、账户状态、永续合约与现货订单、WebSocket 数据流、WebSocket API 请求、Testnet、代理和断线重连恢复来构建 Hyperliquid 集成。 npm 包GitHub first-hyperliquid-api-call.js 公开 REST API 复制import { RestClient } from '@siebly/hyperliquid-api'; const client = new RestClient(); async function main() { try { const status = await client.getExchangeStatus(); console.log('Exchange status:', status); } catch (error) { console.error('Exchange-status request failed:', error); try { const mids = await client.getAllMids(); console.log('BTC midpoint:', mids.BTC); } catch (error) { console.error('Midpoint request failed:', error); try { const metadata = await client.getPerpMetadata(); const btc = metadata.universe.find((asset) => asset.name === 'BTC'); console.log('BTC perpetual metadata:', btc); } catch (error) { console.error('Perpetual metadata request failed:', error); try { const orderBook = await client.getOrderBook({ coin: 'BTC', }); console.log('Best bid:', orderBook?.levels[0][0]); console.log('Best ask:', orderBook?.levels[1][0]); } catch (error) { console.error('Order-book request failed:', error); try { const candles = await client.getCandles({ coin: 'BTC', interval: '1h', startTime: Date.now() - 24 * 60 * 60 * 1000, }); console.log('Latest hourly candle:', candles.at(-1)); } catch (error) { console.error('Candle request failed:', error); try { const trades = await client.getRecentTrades({ coin: 'BTC', }); console.log('Most recent trade:', trades[0]); } catch (error) { console.error('Recent-trade request failed:', error); main(); API 接口一览 REST API 调用用一个客户端,订阅用一个客户端,通过 WebSocket 发送可等待请求再用一个客户端。 任何需要 Hyperliquid 市场数据、账户状态、订单或对账的 Node.js 或 JavaScript 服务。 市场数据、账户状态、订单、转账、质押、金库、子账户、HIP-3 以及其他 Info 和 Exchange 操作 公开市场数据和按地址划分的账户订阅 通过 WebSocket POST 协议发送的可等待 Info 请求和已签名 Exchange 请求 公开和账户 WebSocket 订阅 通过 WebSocket 发送 Info 和 Exchange 请求 把每个选择都明确下来,让读取和已签名操作落到预期的市场和账户上。 选择 Hyperliquid Testnet 而不是 Mainnet。 选择永续合约、现货交易对、HIP-3 市场、结果或数字资产 ID。 确定正在管理其状态和订单的是主账户、子账户还是金库。 用主钱包或已获批准的 API 钱包对 Exchange 操作签名。 通过 HTTPS 或 WebSocket 发送可等待的 Info 和 Exchange 请求。 先从公开数据开始,再逐步加入账户状态、签名、订单、数据流、网络配置和恢复。 资产与账户状态 解析当前市场元数据,并查询目标账户地址。 订单与签名 使用已获批准的 API 钱包、有效的十进制字符串,并显式检查响应。 网络与恢复 把 Mainnet 和 Testnet 配置分开保存,在连接中断后重建状态。 一次只运行一个聚焦的 JavaScript 示例,然后把相同的客户端应用到 Hyperliquid API 的其余部分。 Info 响应、数据流快照、Exchange 响应和最终订单状态承载的信息各不相同。 REST API 请求流程 选择一个 Info 方法,直接读取该端点特有的响应。 已签名订单流程 解析资产、对操作签名、检查其状态,然后单独确认最终状态。 签名者隔离、资产规则、响应处理、数据流连续性和网络路由都必须可预期。 把私钥保存在服务端,并为每个交易进程或子账户使用单独的已获批准 API 钱包。 用主账户、子账户或金库地址查询账户状态,而不是 API 钱包地址。 读取当前元数据,并对价格、数量、金额和触发价使用精确的十进制字符串。 生成客户端订单 ID,并在重试不确定的写入之前先按该 ID 查询。 检查 Exchange 响应中的每一个状态条目,并单独确认最终订单状态。 在账户数据流中断后,重新加载余额、持仓、未成交订单和成交记录。 保持系统时间同步,并遵守当前的 IP、地址和 WebSocket 限制。 启用代理时,监控代理可达性、延迟和出口 IP。 从 REST API 调用开始 读取市场数据、元数据和账户状态。 下 Testnet 订单 用 API 钱包运行完整的永续合约和现货订单流程。 配置网络 选择 Mainnet 或 Testnet,并在需要时配置代理。 本教程使用 @siebly/hyperliquid-api,这是 Siebly 为 Hyperliquid 提供的 Node.js 和 JavaScript SDK。它涵盖公开市场数据、账户状态、永续合约与现货订单、公开和账户 WebSocket 数据流、WebSocket API 请求、Testnet、网络路由和代理。 该 SDK 处理资产解析、操作签名、精确的传输格式、nonce 分配、WebSocket 心跳、重连、重新订阅和 WebSocket 请求匹配。对于使用 TypeScript 的项目,其中包含 TypeScript 声明。 Hyperliquid 用一个 Info 端点处理市场和账户读取,用一个 Exchange 端点处理已签名操作,用一个 WebSocket 端点同时处理订阅和请求-响应流量。资产标识符和签名格式也因操作而异。 RestClient 还提供更高层的辅助方法,例如 submitMarketOrder()、submitLimitOrder()、submitMarketClose() 和 getBalances()。底层方法仍然可用于批量操作、TP/SL 订单、转账、金库操作和其他高级工作流。 复制npm install @siebly/hyperliquid-api 支持 Node.js 22 或更新版本。下面的每个示例都是纯 JavaScript。
(原文较长,此处译出前 6000 字,完整内容请点「打开原文」。)
正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。