本ページはコミュニティ翻訳です。参考用であり、内容は英語版を優先します。
Hyperliquid ドキュメント›開発者向け›API›Info エンドポイント
英語の原文を見る ↗

Info エンドポイント

Info エンドポイントは、取引所および特定のユーザーに関する情報を取得するために使用されます。リクエストボディの種類に応じて、対応するレスポンスボディのスキーマも異なります。

ページネーション

時間範囲を受け取るレスポンスは、最大500要素または個別のデータブロックのみを返します。より広い範囲を照会するには、ページネーションのために、最後に返されたタイムスタンプを次の startTime として使用してください。

永続契約とスポット

このセクションのエンドポイントおよび WebSocket サブスクリプションは、永続契約とスポットの両方で動作します。永続契約の場合、coin は meta レスポンスで返される名前です。スポットの場合、PURR には PURR/USDC を使用し、その他すべてのスポットトークンには @{index}（例: @1）を使用します。ここで index は、spotMeta レスポンスの universe フィールドにおけるスポットペアのインデックスです。例えば、メインネットにおける HYPE のスポットインデックスは @107 です。これは、HYPE のトークンインデックスが 150 であり、スポットペア @107 のトークンが [150, 0] であるためです。一部のアセットはユーザーインターフェース上でリマップされている場合があることに注意してください。例えば、app.hyperliquid.xyz の BTC/USDC は、メインネットの HyperCore では UBTC/USDC に対応します。リマップの検出にはトークン詳細ページの L1 名を使用できます。

ユーザーアドレス

マスターアカウントまたはサブアカウントに関連付けられたアカウントデータを照会するには、そのアカウントの実際のアドレスを渡す必要があります。よくある落とし穴は、エージェントウォレットのアドレスを使用することであり、その場合は結果が空になります。

すべてのコインのミッドを取得

POST https://api.hyperliquid.xyz/info

オーダーブックが空の場合、最後の取引価格がフォールバックとして使用されることに注意してください

ヘッダー

名前 型 説明
Content-Type* String "application/json"

リクエストボディ

名前 型 説明
type* String "allMids"
dex String Perp dex の名前。デフォルトは空文字列で、最初の perp dex を表します。スポットのミッドは最初の perp dex の場合にのみ含まれます。

{% tabs %}

{
    "APE": "4.33245",
    "ARB": "1.21695"
}

{% endtab %}

ユーザーの未決済注文を取得

POST https://api.hyperliquid.xyz/info

ユーザーの未決済注文を表示します

ヘッダー

名前 型 説明
Content-Type* String "application/json"

リクエストボディ

名前 型 説明
type* String "openOrders"
user* String 42文字の16進形式のアドレス。例: 0x0000000000000000000000000000000000000000。
dex String Perp dex の名前。デフォルトは空文字列で、最初の perp dex を表します。スポットの未決済注文は最初の perp dex の場合にのみ含まれます。

{% tabs %}

[
    {
        "coin": "BTC",
        "limitPx": "29792.0",
        "oid": 91490942,
        "side": "A",
        "sz": "0.0",
        "timestamp": 1681247412573
    }
]

{% endtab %}

フロントエンド情報を含むユーザーの未決済注文を取得

POST https://api.hyperliquid.xyz/info

ヘッダー

名前 型 説明
Content-Type* String "application/json"

リクエストボディ

名前 型 説明
type* String "frontendOpenOrders"
user* String 42文字の16進形式のアドレス。例: 0x0000000000000000000000000000000000000000。
dex String Perp dex の名前。デフォルトは空文字列で、最初の perp dex を表します。スポットの未決済注文は最初の perp dex の場合にのみ含まれます。

{% tabs %}

[
    {
        "coin": "BTC",
        "isPositionTpsl": false,
        "isTrigger": false,
        "limitPx": "29792.0",
        "oid": 91490942,
        "orderType": "Limit",
        "origSz": "5.0",
        "reduceOnly": false,
        "side": "A",
        "sz": "5.0",
        "timestamp": 1681247412573,
        "triggerCondition": "N/A",
        "triggerPx": "0.0",
    }
]

{% endtab %}

ユーザーの約定を取得

POST https://api.hyperliquid.xyz/info

最大2000件の最新の約定を返します

ヘッダー

名前 型 説明
Content-Type* String "application/json"

リクエストボディ

名前 型 説明
type* String "userFills"
user* String 42文字の16進形式のアドレス。例: 0x0000000000000000000000000000000000000000。
aggregateByTime bool true の場合、交差注文が複数の異なる待機注文によって約定されるときに、部分約定が統合されます。複数の交差注文によって約定された待機注文は、同一ブロック内である場合にのみ集計されます。

{% tabs %}

[
    // Perp fill (first perp dex)
    {
        "closedPnl": "0.0",
        "coin": "AVAX",
        "crossed": false,
        "dir": "Open Long",
        "hash": "0xa166e3fa63c25663024b03f2e0da011a00307e4017465df020210d3d432e7cb8",
        "oid": 90542681,
        "px": "18.435",
        "side": "B",
        "startPosition": "26.86",
        "sz": "93.53",
        "time": 1681222254710,
        "fee": "0.01", // the total fee, inclusive of builderFee below
        "feeToken": "USDC",
        "builderFee": "0.01", // this is optional and will not be present if 0
        "tid": 118906512037719
    },
    // Perp Fill (HIP-3)
    {
        "coin": "xyz:XYZ100", // For HIP-3, the asset has the dex name as a prefix
        "px": "25372.0",
        "sz": "0.0353",
        "side": "B",
        "time": 1767651180109,
        "startPosition": "0.7045",
        "dir": "Open Long",
        "closedPnl": "0.0",
        "hash": "0xa166e3fa63c25663024b03f2e0da011a00307e4017465df020210d3d432e7cb9",
        "oid": 287286372177,
        "crossed": false,
        "fee": "0.026868",
        "tid": 164087028129848,
        "feeToken":" USDC"
    },
    // Spot fill - note the difference in the "coin" format. Refer to 
    // https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/asset-ids
    // for more information on how spot asset IDs work
    {
        "coin": "@107",
        "px": "18.62041381",
        "sz": "43.84",
        "side": "A",
        "time": 1735969713869,
        "startPosition": "10659.65434798",
        "dir": "Sell",
        "closedPnl": "8722.988077",
        "hash": "0x2222138cc516e3fe746c0411dd733f02e60086f43205af2ae37c93f6a792430b",
        "oid": 59071663721,
        "crossed": true,
        "fee": "0.304521",
        "tid": 907359904431134,
        "feeToken": "USDC"
    }
]

{% endtab %}

ユーザーの約定を時間で取得

POST https://api.hyperliquid.xyz/info

1回のレスポンスで最大2000件の約定を返します。利用可能なのは最新の10000件の約定のみです

ヘッダー

名前 型 説明
Content-Type* String "application/json"

リクエストボディ

名前 型 説明
type* String userFillsByTime
user* String 42文字の16進形式のアドレス。例: 0x0000000000000000000000000000000000000000。
startTime* int 開始時間（ミリ秒）。境界を含みます
endTime int 終了時間（ミリ秒）。境界を含みます。デフォルトは現在時刻です。
aggregateByTime bool true の場合、交差注文が複数の異なる待機注文によって約定されるときに、部分約定が統合されます。複数の交差注文によって約定された待機注文は、同一ブロック内である場合にのみ集計されます。

{% tabs %}

[
    // Perp fill (first perp dex)
    {
        "closedPnl": "0.0",
        "coin": "AVAX",
        "crossed": false,
        "dir": "Open Long",
        "hash": "0xa166e3fa63c25663024b03f2e0da011a00307e4017465df020210d3d432e7cb8",
        "oid": 90542681,
        "px": "18.435",
        "side": "B",
        "startPosition": "26.86",
        "sz": "93.53",
        "time": 1681222254710,
        "fee": "0.01", // the total fee, inclusive of builderFee below
        "feeToken": "USDC",
        "builderFee": "0.01", // this is optional and will not be present if 0
        "tid": 118906512037719
    },
    // Perp Fill (HIP-3)
    {
        "coin": "xyz:XYZ100", // For HIP-3, the asset has the dex name as a prefix
        "px": "25372.0",
        "sz": "0.0353",
        "side": "B",
        "time": 1767651180109,
        "startPosition": "0.7045",
        "dir": "Open Long",
        "closedPnl": "0.0",
        "hash": "0xa166e3fa63c25663024b03f2e0da011a00307e4017465df020210d3d432e7cb9",
        "oid": 287286372177,
        "crossed": false,
        "fee": "0.026868",
        "tid": 164087028129848,
        "feeToken":" USDC"
    },
    // Spot fill - note the difference in the "coin" format. Refer to 
    // https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/asset-ids
    // for more information on how spot asset IDs work
    {
        "coin": "@107",
        "px": "18.62041381",
        "sz": "43.84",
        "side": "A",
        "time": 1735969713869,
        "startPosition": "10659.65434798",
        "dir": "Sell",
        "closedPnl": "8722.988077",
        "hash": "0x2222138cc516e3fe746c0411dd733f02e60086f43205af2ae37c93f6a792430b",
        "oid": 59071663721,
        "crossed": true,
        "fee": "0.304521",
        "tid": 907359904431134,
        "feeToken": "USDC"
    }
]

{% endtab %}

ユーザーのレート制限を照会

POST https://api.hyperliquid.xyz/info

リクエストボディ

名前 型 説明
user String 42文字の16進形式のアドレス。例: 0x0000000000000000000000000000000000000000
type String userRateLimit

{% tabs %}

{
  "cumVlm": "2854574.593578",
  "nRequestsUsed": 2890, // max(0, cumulative_used minus reserved)
  "nRequestsCap": 2864574, 
  "nRequestsSurplus": 0, // max(0, reserved minus cumulative_used)
}

{% endtab %}

oid または cloid で注文ステータスを照会

POST https://api.hyperliquid.xyz/info

リクエストボディ

名前 型 説明
user* String 42文字の16進形式のアドレス。例: 0x0000000000000000000000000000000000000000。
type* String "orderStatus"
oid* uint64 or string 注文IDを表す u64、またはクライアント注文IDを表す16バイトの16進文字列のいずれか

返される \ 文字列は以下のいずれかの値を取ります:

注文ステータス 説明
open 正常に発注されました
filled 約定済み
canceled ユーザーによりキャンセル
triggered トリガー注文が発動
rejected 発注時に拒否
marginCanceled 約定に必要な証拠金が不足したためキャンセル
vaultWithdrawalCanceled ボールトのみ。ユーザーのボールトからの引き出しによりキャンセル
openInterestCapCanceled 建玉が上限に達していた際に注文が攻撃的すぎたためキャンセル
selfTradeCanceled 自己取引防止機能によりキャンセル
reduceOnlyCanceled ポジションを削減しない reduce-only 注文としてキャンセル
siblingFilledCanceled TP/SL のみ。兄弟注文の約定によりキャンセル
delistedCanceled アセットの下場によりキャンセル
liquidatedCanceled 清算によりキャンセル
scheduledCancel API のみ。予約キャンセル期限を超過したためキャンセル（デッドマンスイッチ）
tickRejected 無効なティック価格により拒否
minTradeNtlRejected 注文ノーショナルが最小値未満のため拒否
perpMarginRejected 証拠金不足により拒否
reduceOnlyRejected reduce only により拒否
badAloPxRejected post-only 注文の即時約定により拒否
iocCancelRejected IOC が約定できなかったため拒否
badTriggerPxRejected 無効な TP/SL 価格により拒否
marketOrderNoLiquidityRejected 成行注文に必要な流動性が不足しているため拒否
positionIncreaseAtOpenInterestCapRejected 建玉上限により拒否
positionFlipAtOpenInterestCapRejected 建玉上限により拒否
tooAggressiveAtOpenInterestCapRejected 建玉上限時に価格が攻撃的すぎたため拒否
openInterestIncreaseRejected 建玉上限により拒否
insufficientSpotBalanceRejected スポット残高不足により拒否
oracleRejected 価格がオラクルから乖離しすぎているため拒否
perpMaxPositionRejected 現在のレバレッジにおける証拠金ティア制限の超過により拒否

{% tabs %}

{
  "status": "order",
  "order": {
    "order": {
      "coin": "ETH",
      "side": "A",
      "limitPx": "2412.7",
      "sz": "0.0",
      "oid": 1,
      "timestamp": 1724361546645,
      "triggerCondition": "N/A",
      "isTrigger": false,
      "triggerPx": "0.0",
      "children": [],
      "isPositionTpsl": false,
      "reduceOnly": true,
      "orderType": "Market",
      "origSz": "0.0076",
      "tif": "FrontendMarket",
      "cloid": null
    },
    "status": <status>,
    "statusTimestamp": 1724361546645
  }
}

{% endtab %}

{% tab title="200: OK Missing Order" %}

{
  "status": "unknownOid"
}

{% endtab %}

L2 ブックのスナップショット

POST https://api.hyperliquid.xyz/info

片面あたり最大20レベルを返します

ヘッダー

名前 値
Content-Type* "application/json"

ボディ

名前 型 説明
type* String "l2Book"
coin* String coin
nSigFigs Number レベルを nSigFigs 桁の有効数字に集約するためのオプションフィールド。有効な値は 2、3、4、5、および null（完全な精度を意味します）です
mantissa Number レベルを集約するためのオプションフィールド。このフィールドは nSigFigs が 5 の場合にのみ許可されます。1、2、または 5 の値を受け付けます。

レスポンス

{% tabs %}

{
  "coin": "BTC",
  "time": 1754450974231,
  "levels": [
    [
      {
        "px": "113377.0",
        "sz": "7.6699",
        "n": 17 // number of levels
      },
      {
        "px": "113376.0",
        "sz": "4.13714",
        "n": 8
      },
    ],
    [
      {
        "px": "113397.0",
        "sz": "0.11543",
        "n": 3
      }
    ]
  ]
}

{% endtab %}

ローソク足のスナップショット

POST https://api.hyperliquid.xyz/info

最新の5000本のローソク足のみが利用可能です

サポートされるインターバル: "1m", "3m", "5m", "15m", "30m", "1h", "2h", "4h", "8h", "12h", "1d", "3d", "1w", "1M"

ヘッダー

名前 値
Content-Type* "application/json"

ボディ

名前 型 説明
type* String "candleSnapshot"
req* Object

{"coin": \, "interval": "15m", "startTime": \, "endTime": \}
HIP-3 の場合、dex 名をプレフィックスとして付ける必要があります。例: "xyz:XYZ100"

レスポンス

{% tabs %}

[
  {
    "T": 1681924499999,
    "c": "29258.0",
    "h": "29309.0",
    "i": "15m",
    "l": "29250.0",
    "n": 189,
    "o": "29295.0",
    "s": "BTC",
    "t": 1681923600000,
    "v": "0.98639"
  }
]

{% endtab %}

ビルダー手数料の承認を確認

POST https://api.hyperliquid.xyz/info

ヘッダー

名前 値
Content-Type* "application/json"

ボディ

名前 型 説明
type* String "maxBuilderFee"
user* String 42文字の16進形式のアドレス。例: 0x0000000000000000000000000000000000000000。
builder* String 42文字の16進形式のアドレス。例: 0x0000000000000000000000000000000000000000。

レスポンス

{% tabs %}

1 // maximum fee approved in tenths of a basis point i.e. 1 means 0.001%

{% endtab %}

ユーザーの履歴注文を取得

POST https://api.hyperliquid.xyz/info

最大2000件の最新の履歴注文を返します

ヘッダー

名前 型 説明
Content-Type* String "application/json"

リクエストボディ

名前 型 説明
type* String "historicalOrders"
user* String 42文字の16進形式のアドレス。例: 0x0000000000000000000000000000000000000000。

{% tabs %}

[
  {
    "order": {
      "coin": "ETH",
      "side": "A",
      "limitPx": "2412.7",
      "sz": "0.0",
      "oid": 1,
      "timestamp": 1724361546645,
      "triggerCondition": "N/A",
      "isTrigger": false,
      "triggerPx": "0.0",
      "children": [],
      "isPositionTpsl": false,
      "reduceOnly": true,
      "orderType": "Market",
      "origSz": "0.0076",
      "tif": "FrontendMarket",
      "cloid": null
    },
    "status": "filled" | "open" | "canceled" | "triggered" | "rejected" | "marginCanceled",
    "statusTimestamp": 1724361546645
  }
]

{% endtab %}

ユーザーの TWAP スライス約定を取得

POST https://api.hyperliquid.xyz/info

最大2000件の最新の TWAP スライス約定を返します

ヘッダー

名前 型 説明
Content-Type* String "application/json"

リクエストボディ

名前 型 説明
type* String "userTwapSliceFills"
user* String 42文字の16進形式のアドレス。例: 0x0000000000000000000000000000000000000000。

{% tabs %}

[
    {
        "fill": {
            "closedPnl": "0.0",
            "coin": "AVAX",
            "crossed": true,
            "dir": "Open Long",
            "hash": "0x0000000000000000000000000000000000000000000000000000000000000000", // TWAP fills have a hash of 0
            "oid": 90542681,
            "px": "18.435",
            "side": "B",
            "startPosition": "26.86",
            "sz": "93.53",
            "time": 1681222254710,
            "fee": "0.01",
            "feeToken": "USDC",
            "tid": 118906512037719
        },
        "twapId": 3156
    }
]

{% endtab %}

ユーザーのサブアカウントを取得

POST https://api.hyperliquid.xyz/info

ヘッダー

名前 型 説明
Content-Type* String "application/json"

リクエストボディ

名前 型 説明
type* String "subAccounts"
user* String 42文字の16進形式のアドレス。例: 0x0000000000000000000000000000000000000000。

{% tabs %}

[
  {
    "name": "Test",
    "subAccountUser": "0x035605fc2f24d65300227189025e90a0d947f16c",
    "master": "0x8c967e73e6b15087c42a10d344cff4c96d877f1d",
    "clearinghouseState": {
      "marginSummary": {
        "accountValue": "29.78001",
        "totalNtlPos": "0.0",
        "totalRawUsd": "29.78001",
        "totalMarginUsed": "0.0"
      },
      "crossMarginSummary": {
        "accountValue": "29.78001",
        "totalNtlPos": "0.0",
        "totalRawUsd": "29.78001",
        "totalMarginUsed": "0.0"
      },
      "crossMaintenanceMarginUsed": "0.0",
      "withdrawable": "29.78001",
      "assetPositions": [],
      "time": 1733968369395
    },
    "spotState": {
      "balances": [
        {
          "coin": "USDC",
          "token": 0,
          "total": "0.22",
          "hold": "0.0",
          "entryNtl": "0.0"
        }
      ]
    }
  }
]

{% endtab %}

ボールトの詳細を取得

POST https://api.hyperliquid.xyz/info

ヘッダー

名前 型 説明
Content-Type* String "application/json"

リクエストボディ

名前 型 説明
type* String "vaultDetails"
vaultAddress* String 42文字の16進形式のアドレス。例: 0x0000000000000000000000000000000000000000。
user String 42文字の16進形式のアドレス。例: 0x0000000000000000000000000000000000000000。

{% tabs %}

{
  "name": "Test",
  "vaultAddress": "0xdfc24b077bc1425ad1dea75bcb6f8158e10df303",
  "leader": "0x677d831aef5328190852e24f13c46cac05f984e7",
  "description": "This community-owned vault provides liquidity to Hyperliquid through multiple market making strategies, performs liquidations, and accrues platform fees.",
  "portfolio": [
    [
      "day",
      {
        "accountValueHistory": [
          [
            1734397526634,
            "329265410.90790099"
          ]
        ],
        "pnlHistory": [
          [
            1734397526634,
            "0.0"
          ],
        ],
        "vlm": "0.0"
      }
    ],
    [
      "week" | "month" | "allTime" | "perpDay" | "perpWeek" | "perpMonth" | "perpAllTime",
      {...}
    ]
  ],
  "apr": 0.36387129259090006,
  "followerState": null,
  "leaderFraction": 0.0007904828725729887,
  "leaderCommission": 0,
  "followers": [
    {
      "user": "0x005844b2ffb2e122cf4244be7dbcb4f84924907c",
      "vaultEquity": "714491.71026243",
      "pnl": "3203.43026143",
      "allTimePnl": "79843.74476743",
      "daysFollowing": 388,
      "vaultEntryTime": 1700926145201,
      "lockupUntil": 1734824439201
    }
  ],
  "maxDistributable": 94856870.164485,
  "maxWithdrawable": 742557.680863,
  "isClosed": false,
  "relationship": {
    "type": "parent",
    "data": {
      "childAddresses": [
        "0x010461c14e146ac35fe42271bdc1134ee31c703a",
        "0x2e3d94f0562703b25c83308a05046ddaf9a8dd14",
        "0x31ca8395cf837de08b24da3f660e77761dfb974b"
      ]
    }
  },
  "allowDeposits": true,
  "alwaysCloseOnWithdraw": false
}

{% endtab %}

ユーザーのボールト預け入れを取得

POST https://api.hyperliquid.xyz/info

ヘッダー

名前 型 説明
Content-Type* String "application/json"

リクエストボディ

名前 型 説明
type* String "userVaultEquities"
user* String 42文字の16進形式のアドレス。例: 0x0000000000000000000000000000000000000000。

{% tabs %}

[
  {
    "vaultAddress": "0xdfc24b077bc1425ad1dea75bcb6f8158e10df303",
    "equity": "742500.082809",
  }
]

{% endtab %}

ユーザーのロールを照会

POST https://api.hyperliquid.xyz/info

ヘッダー

名前 型 説明
Content-Type* String "application/json"

リクエストボディ

名前 型 説明
type* String "userRole"
user* String 42文字の16進形式のアドレス。例: 0x0000000000000000000000000000000000000000。

{% tabs %}

{"role":"user"} # "missing", "user", "agent", "vault", or "subAccount"

{% endtab %}

{% tab title="Agent" %}

{"role":"agent", "data": {"user": "0x..."}}

{% endtab %}

{% tab title="Vault" %}

{"role":"vault"}

{% endtab %}

{% tab title="Subaccount" %}

{"role":"subAccount", "data":{"master":"0x..."}}

{% endtab %}

{% tab title="Missing" %}

{"role":"missing"}

{% endtab %}

ユーザーのポートフォリオを照会

POST https://api.hyperliquid.xyz/info

ヘッダー

名前 型 説明
Content-Type* String "application/json"

リクエストボディ

名前 型 説明
type* String "portfolio"
user* String 16進形式。例: 0x0000000000000000000000000000000000000000。

{% tabs %}

[
  [
    "day",
    {
      "accountValueHistory": [
        [
          1741886630493,
          "0.0"
        ],
        [
          1741895270493,
          "0.0"
        ],
        ...
      ],
      "pnlHistory": [
        [
          1741886630493,
          "0.0"
        ],
        [
          1741895270493,
          "0.0"
        ],
        ...
      ],
      "vlm": "0.0"
    }
  ],
  ["week", { ... }],
  ["month", { ... }],
  ["allTime", { ... }],
  ["perpDay", { ... }],
  ["perpWeek", { ... }],
  ["perpMonth", { ... }],
  ["perpAllTime", { ... }]
]

{% endtab %}

ユーザーのリファラル情報を照会

POST https://api.hyperliquid.xyz/info

ヘッダー

名前 型 説明
Content-Type* String "application/json"

リクエストボディ

名前 型 説明
type* String "referral"
user* String 16進形式。例: 0x0000000000000000000000000000000000000000。

{% tabs %}

{
    "referredBy": {
        "referrer": "0x5ac99df645f3414876c816caa18b2d234024b487",
        "code": "TESTNET"
    },
    "cumVlm": "149428030.6628420055", // USDC Only
    "unclaimedRewards": "11.047361", // USDC Only
    "claimedRewards": "22.743781", // USDC Only
    "builderRewards": "0.027802", // USDC Only
    "tokenToState":[
      0,
      {
         "cumVlm":"149428030.6628420055",
         "unclaimedRewards":"11.047361",
         "claimedRewards":"22.743781",
         "builderRewards":"0.027802"
      }
   ],
    "referrerState": {
        "stage": "ready",
        "data": {
            "code": "TEST",
            "referralStates": [
                {
                    "cumVlm": "960652.017122",
                    "cumRewardedFeesSinceReferred": "196.838825",
                    "cumFeesRewardedToReferrer": "19.683748",
                    "timeJoined": 1679425029416,
                    "user": "0x11af2b93dcb3568b7bf2b6bd6182d260a9495728"
                },
                {
                    "cumVlm": "438278.672653",
                    "cumRewardedFeesSinceReferred": "97.628107",
                    "cumFeesRewardedToReferrer": "9.762562",
                    "timeJoined": 1679423947882,
                    "user": "0x3f69d170055913103a034a418953b8695e4e42fa"
                }
            ]
        }
    },
    "rewardHistory": []
}

{% endtab %}

rewardHistory はレガシーの報酬用です。現在、請求済みの報酬は nonFundingLedgerUpdate で返されることに注意してください。

ユーザーの手数料を照会

POST https://api.hyperliquid.xyz/info

ヘッダー

名前 型 説明
Content-Type* String "application/json"

リクエストボディ

名前 型 説明
type* String "userFees"
user* String 16進形式。例: 0x0000000000000000000000000000000000000000。

{% tabs %}

{
  "dailyUserVlm": [
    {
      "date": "2025-05-23",
      "userCross": "0.0",
      "userAdd": "0.0",
      "exchange": "2852367.0770729999"
    },
    ...
  ],
  "feeSchedule": {
    "cross": "0.00045",
    "add": "0.00015",
    "spotCross": "0.0007",
    "spotAdd": "0.0004",
    "tiers": {
      "vip": [
        {
          "ntlCutoff": "5000000.0",
          "cross": "0.0004",
          "add": "0.00012",
          "spotCross": "0.0006",
          "spotAdd": "0.0003"
        },
        ...
      ],
      "mm": [
        {
          "makerFractionCutoff": "0.005",
          "add": "-0.00001"
        },
        ...
      ]
    },
    "referralDiscount": "0.04",
    "stakingDiscountTiers": [
      {
        "bpsOfMaxSupply": "0.0",
        "discount": "0.0"
      },
      {
        "bpsOfMaxSupply": "0.0001",
        "discount": "0.05"
      },
      ...
    ]
  },
  "userCrossRate": "0.000315",
  "userAddRate": "0.000105",
  "userSpotCrossRate": "0.00049",
  "userSpotAddRate": "0.00028",
  "activeReferralDiscount": "0.0",
  "trial": null,
  "feeTrialReward": "0.0",
  "nextTrialAvailableTimestamp": null,
  "stakingLink": {
    "type": "tradingUser",
    "stakingUser": "0x54c049d9c7d3c92c2462bf3d28e083f3d6805061"
  },
  "activeStakingDiscount": {
    "bpsOfMaxSupply": "4.7577998927",
    "discount": "0.3"
  }
}

{% endtab %}

ユーザーのステーキングデリゲーションを照会

POST https://api.hyperliquid.xyz/info

ヘッダー

名前 型 説明
Content-Type* String "application/json"

リクエストボディ

名前 型 説明
type* String "delegations"
user* String 16進形式。例: 0x0000000000000000000000000000000000000000。

{% tabs %}

[
    {
        "validator":"0x5ac99df645f3414876c816caa18b2d234024b487",
        "amount":"12060.16529862",
        "lockedUntilTimestamp":1735466781353
    },
    ...
]

{% endtab %}

ユーザーのステーキング概要を照会

POST https://api.hyperliquid.xyz/info

ヘッダー

名前 型 説明
Content-Type* String "application/json"

リクエストボディ

名前 型 説明
type* String "delegatorSummary"
user* String 16進形式。例: 0x0000000000000000000000000000000000000000。

{% tabs %}

{
    "delegated": "12060.16529862",
    "undelegated": "0.0",
    "totalPendingWithdrawal": "0.0",
    "nPendingWithdrawals": 0
}

{% endtab %}

ユーザーのステーキング履歴を照会

POST https://api.hyperliquid.xyz/info

ヘッダー

名前 型 説明
Content-Type* String "application/json"

リクエストボディ

名前 型 説明
type* String "delegatorHistory"
user* String 16進形式。例: 0x0000000000000000000000000000000000000000。

{% tabs %}

[
    {
        "time": 1735380381353,
        "hash": "0x55492465cb523f90815a041a226ba90147008d4b221a24ae8dc35a0dbede4ea4",
        "delta": {
            "delegate": {
                "validator": "0x5ac99df645f3414876c816caa18b2d234024b487",
                "amount": "10000.0",
                "isUndelegate": false
            }
        }
    },
    ...
]

{% endtab %}

ユーザーのステーキング報酬を照会

POST https://api.hyperliquid.xyz/info

ヘッダー

名前 型 説明
Content-Type* String "application/json"

リクエストボディ

名前 型 説明
type* String "delegatorRewards"
user* String 16進形式。例: 0x0000000000000000000000000000000000000000。

{% tabs %}

[
    {
        "time": 1736726400073,
        "source": "delegation",
        "totalAmount": "0.73117184"
    },
    {
        "time": 1736726400073,
        "source": "commission",
        "totalAmount": "130.76445876"
    },
    ...
]

{% endtab %}

ユーザーの HIP-3 DEX アブストラクション状態を照会

POST https://api.hyperliquid.xyz/info

ヘッダー

名前 型 説明
Content-Type* String "application/json"

リクエストボディ

名前 型 説明
type* String "userDexAbstraction"
user* String 16進形式。例: 0x0000000000000000000000000000000000000000。

{% tabs %}

true

{% endtab %}

ユーザーのアブストラクション状態を照会

POST https://api.hyperliquid.xyz/info

ヘッダー

名前 型 説明
Content-Type* String "application/json"

リクエストボディ

名前 型 説明
type* String "userAbstraction"
user* String 16進形式。例: 0x0000000000000000000000000000000000000000。

{% tabs %}

"unifiedAccount" | "portfolioMargin" | "disabled" | "default" | "dexAbstraction"

{% endtab %}

借入/貸出のユーザー状態を照会

POST https://api.hyperliquid.xyz/info

ヘッダー

名前 型 説明
Content-Type* String "application/json"

リクエストボディ

名前 型 説明
type* String "borrowLendUserState"
user* String 16進形式。例: 0x0000000000000000000000000000000000000000。

{% tabs %}

{
    "tokenToState":[
        [
            0,
            {
                "borrow":{
                    "basis": "0.0",
                    "value": "0.0"
                },
                "supply":{
                    "basis": "44.69295862",
                    "value": "44.69692314"
                }
            }
        ],
        [
            1105,
            {
                "borrow":{
                    "basis": "0.0",
                    "value": "0.0"
                },
                "supply":{
                    "basis": "0.0",
                    "value": "0.0"
                }
            }
        ],
    ],
    "health":"healthy",
    "healthFactor":null
}

{% endtab %}

借入/貸出のリザーブ状態を照会

POST https://api.hyperliquid.xyz/info

ヘッダー

名前 型 説明
Content-Type* String "application/json"

リクエストボディ

名前 型 説明
type* String "borrowLendReserveState"
token* Number トークンインデックス

{% tabs %}

{
    "borrowYearlyRate": "0.05",
    "supplyYearlyRate": "0.0008245002",
    "balance": "3245939.4732256099",
    "utilization": "0.018322226",
    "oraclePx": "1.0",
    "ltv": "0.0",
    "totalSupplied": "3306509.7335290499",
    "totalBorrowed": "60582.61869494"
}

{% endtab %}

すべての借入/貸出リザーブ状態を照会

POST https://api.hyperliquid.xyz/info

ヘッダー

名前 型 説明
Content-Type* String "application/json"

リクエストボディ

名前 型 説明
type* String "allBorrowLendReserveStates"

{% tabs %}

[
    [
        0,
        {
            "borrowYearlyRate": "0.05",
            "supplyYearlyRate": "0.0008244951",
            "balance": "3245960.0596176102",
            "utilization": "0.0183221137",
            "oraclePx": "1.0",
            "ltv": "0.0",
            "totalSupplied": "3306530.3251102199",
            "totalBorrowed": "60582.62446067"
        }
    ],
    [
        150,
        {
            "borrowYearlyRate": "0.05",
            "supplyYearlyRate": "0.0",
            "balance": "11318.09684696",
            "utilization": "0.0",
            "oraclePx": "23.99",
            "ltv": "0.5",
            "totalSupplied": "11318.09684696",
            "totalBorrowed": "0.0"
        }
    ]
]

{% endtab %}

ユーザーの承認済みビルダーを照会

POST https://api.hyperliquid.xyz/info

ヘッダー

名前 型 説明
Content-Type* String "application/json"

リクエストボディ

名前 型 説明
type* String "approvedBuilders"
user* String 16進形式。例: 0x0000000000000000000000000000000000000000。

{% tabs %}

["0x476fa87b4d3818f437f38f1263bee508d7672d82"]

{% endtab %}

英語の公式ソース: https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint
原文取得日: · ミラー構築日: · コミュニティ翻訳。英語版を優先
非公式のコミュニティ翻訳です。著作権は Hyperliquid に帰属し、内容は英語版を優先します。 出典: https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint