Questa pagina è una traduzione della community e ha solo scopo informativo; fa fede la versione originale in inglese.
Documentazione Hyperliquid›Per gli sviluppatori›API›Endpoint info
Versione originale ↗

Endpoint info

L'endpoint info viene utilizzato per recuperare informazioni sull'exchange e su specifici utenti. I diversi corpi delle richieste producono schemi dei corpi di risposta corrispondenti differenti.

Paginazione

Le risposte che accettano un intervallo di tempo restituiscono soltanto 500 elementi o blocchi distinti di dati. Per interrogare intervalli più ampi, utilizzare l'ultimo timestamp restituito come successivo startTime per la paginazione.

Perpetuals rispetto a Spot

Gli endpoint di questa sezione, così come le sottoscrizioni WebSocket, funzionano sia per i Perpetuals sia per Spot. Per i perpetual, coin è il nome restituito nella risposta meta. Per Spot, coin deve essere PURR/USDC per PURR e @{index}, ad es. @1, per tutti gli altri token spot, dove index è l'indice della coppia spot nel campo universe della risposta spotMeta. Ad esempio, l'indice spot per HYPE sulla mainnet è @107 perché l'indice del token HYPE è 150 e la coppia spot @107 ha i token [150, 0]. Si noti che alcuni asset possono essere rimappati nelle interfacce utente. Ad esempio, BTC/USDC su app.hyperliquid.xyz corrisponde a UBTC/USDC su HyperCore mainnet. Il nome L1 nella pagina dei dettagli del token può essere utilizzato per rilevare le rimappature.

Indirizzo dell'utente

Per interrogare i dati dell'account associati a un account master o a un subaccount, è necessario fornire l'indirizzo effettivo di tale account. Un errore comune consiste nell'utilizzare l'indirizzo di un agent wallet, che produce un risultato vuoto.

Recupero dei mid per tutti i coin

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

Si noti che, se il book degli ordini è vuoto, come fallback verrà utilizzato l'ultimo prezzo di negoziazione

Intestazioni

Name Type Description
Content-Type* String "application/json"

Corpo della richiesta

Name Type Description
type* String "allMids"
dex String Nome del perp dex. Per impostazione predefinita, la stringa vuota, che rappresenta il primo perp dex. I mid spot sono inclusi soltanto con il primo perp dex..

{% tabs %}

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

{% endtab %}

Recupero degli ordini aperti di un utente

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

Visualizzare gli ordini aperti di un utente

Intestazioni

Name Type Description
Content-Type* String "application/json"

Corpo della richiesta

Name Type Description
type* String "openOrders"
user* String Indirizzo in formato esadecimale di 42 caratteri; ad es. 0x0000000000000000000000000000000000000000.
dex String Nome del perp dex. Per impostazione predefinita, la stringa vuota, che rappresenta il primo perp dex. Gli ordini aperti spot sono inclusi soltanto con il primo perp dex.

{% tabs %}

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

{% endtab %}

Recupero degli ordini aperti di un utente con informazioni frontend aggiuntive

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

Intestazioni

Name Type Description
Content-Type* String "application/json"

Corpo della richiesta

Name Type Description
type* String "frontendOpenOrders"
user* String Indirizzo in formato esadecimale di 42 caratteri; ad es. 0x0000000000000000000000000000000000000000.
dex String Nome del perp dex. Per impostazione predefinita, la stringa vuota, che rappresenta il primo perp dex. Gli ordini aperti spot sono inclusi soltanto con il primo 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 %}

Recupero dei fill di un utente

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

Restituisce al massimo i 2000 fill più recenti

Intestazioni

Name Type Description
Content-Type* String "application/json"

Corpo della richiesta

Name Type Description
type* String "userFills"
user* String Indirizzo in formato esadecimale di 42 caratteri; ad es. 0x0000000000000000000000000000000000000000.
aggregateByTime bool Quando è true, i fill parziali vengono combinati quando un ordine incrociato viene eseguito da più ordini resting differenti. Gli ordini resting eseguiti da più ordini incrociati vengono aggregati soltanto se appartengono allo stesso blocco.

{% 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 %}

Recupero dei fill di un utente per intervallo di tempo

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

Restituisce al massimo 2000 fill per risposta e sono disponibili soltanto i 10000 fill più recenti

Intestazioni

Name Type Description
Content-Type* String "application/json"

Corpo della richiesta

Name Type Description
type* String userFillsByTime
user* String Indirizzo in formato esadecimale di 42 caratteri; ad es. 0x0000000000000000000000000000000000000000.
startTime* int Orario di inizio in millisecondi, inclusivo
endTime int Orario di fine in millisecondi, inclusivo. Per impostazione predefinita, l'orario corrente.
aggregateByTime bool Quando è true, i fill parziali vengono combinati quando un ordine incrociato viene eseguito da più ordini resting differenti. Gli ordini resting eseguiti da più ordini incrociati vengono aggregati soltanto se appartengono allo stesso blocco.

{% 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 %}

Interrogazione dei limiti di frequenza dell'utente

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

Corpo della richiesta

Name Type Description
user String Indirizzo in formato esadecimale di 42 caratteri; ad es. 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 %}

Interrogazione dello stato dell'ordine per oid o cloid

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

Corpo della richiesta

Name Type Description
user* String Indirizzo in formato esadecimale di 42 caratteri; ad es. 0x0000000000000000000000000000000000000000.
type* String "orderStatus"
oid* uint64 or string Un u64 che rappresenta l'id dell'ordine oppure una stringa esadecimale di 16 byte che rappresenta l'id dell'ordine cliente

La stringa \ restituita può assumere i seguenti valori:

Order status Explanation
open Inserito correttamente
filled Eseguito
canceled Annullato dall'utente
triggered Ordine trigger attivato
rejected Rifiutato al momento dell'inserimento
marginCanceled Annullato per margine insufficiente per l'esecuzione
vaultWithdrawalCanceled Solo vault. Annullato a seguito del prelievo di un utente dal vault
openInterestCapCanceled Annullato perché l'ordine era troppo aggressivo quando l'open interest era al limite
selfTradeCanceled Annullato a causa della prevenzione del self-trade
reduceOnlyCanceled Annullato ordine reduce-only che non riduce la posizione
siblingFilledCanceled Solo TP/SL. Annullato a seguito dell'esecuzione dell'ordine correlato
delistedCanceled Annullato a seguito del delisting dell'asset
liquidatedCanceled Annullato a seguito di liquidazione
scheduledCancel Solo API. Annullato per superamento della scadenza di annullamento programmato (dead man's switch)
tickRejected Rifiutato per prezzo tick non valido
minTradeNtlRejected Rifiutato per nozionale dell'ordine inferiore al minimo
perpMarginRejected Rifiutato per margine insufficiente
reduceOnlyRejected Rifiutato per reduce only
badAloPxRejected Rifiutato per match immediato post-only
iocCancelRejected Rifiutato perché IOC non è stato in grado di trovare un match
badTriggerPxRejected Rifiutato per prezzo TP/SL non valido
marketOrderNoLiquidityRejected Rifiutato per mancanza di liquidità per l'ordine di mercato
positionIncreaseAtOpenInterestCapRejected Rifiutato per limite di open interest
positionFlipAtOpenInterestCapRejected Rifiutato per limite di open interest
tooAggressiveAtOpenInterestCapRejected Rifiutato per prezzo troppo aggressivo al limite di open interest
openInterestIncreaseRejected Rifiutato per limite di open interest
insufficientSpotBalanceRejected Rifiutato per saldo spot insufficiente
oracleRejected Rifiutato per prezzo troppo distante dall'oracle
perpMaxPositionRejected Rifiutato per superamento del limite della fascia di margine alla leva corrente

{% 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 %}

Snapshot del book L2

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

Restituisce al massimo 20 livelli per lato

Intestazioni

Name Value
Content-Type* "application/json"

Corpo

Name Type Description
type* String "l2Book"
coin* String coin
nSigFigs Number Campo opzionale per aggregare i livelli a nSigFigs cifre significative. I valori validi sono 2, 3, 4, 5 e null, che indica la precisione completa
mantissa Number Campo opzionale per aggregare i livelli. Questo campo è consentito soltanto se nSigFigs è 5. Accetta i valori 1, 2 o 5.

Risposta

{% 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 %}

Snapshot delle candele

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

Sono disponibili soltanto le 5000 candele più recenti

Intervalli supportati: "1m", "3m", "5m", "15m", "30m", "1h", "2h", "4h", "8h", "12h", "1d", "3d", "1w", "1M"

Intestazioni

Name Value
Content-Type* "application/json"

Corpo

Name Type Description
type* String "candleSnapshot"
req* Object

{"coin": \, "interval": "15m", "startTime": \, "endTime": \}
Per HIP-3 è necessario anteporre il nome del dex, ad es. "xyz:XYZ100"

Risposta

{% 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 %}

Verifica dell'approvazione della commissione builder

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

Intestazioni

Name Value
Content-Type* "application/json"

Corpo

Name Type Description
type* String "maxBuilderFee"
user* String Indirizzo in formato esadecimale di 42 caratteri; ad es. 0x0000000000000000000000000000000000000000.
builder* String Indirizzo in formato esadecimale di 42 caratteri; ad es. 0x0000000000000000000000000000000000000000.

Risposta

{% tabs %}

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

{% endtab %}

Recupero degli ordini storici di un utente

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

Restituisce al massimo i 2000 ordini storici più recenti

Intestazioni

Name Type Description
Content-Type* String "application/json"

Corpo della richiesta

Name Type Description
type* String "historicalOrders"
user* String Indirizzo in formato esadecimale di 42 caratteri; ad es. 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 %}

Recupero dei fill delle slice TWAP di un utente

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

Restituisce al massimo i 2000 fill delle slice TWAP più recenti

Intestazioni

Name Type Description
Content-Type* String "application/json"

Corpo della richiesta

Name Type Description
type* String "userTwapSliceFills"
user* String Indirizzo in formato esadecimale di 42 caratteri; ad es. 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 %}

Recupero dei subaccount di un utente

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

Intestazioni

Name Type Description
Content-Type* String "application/json"

Corpo della richiesta

Name Type Description
type* String "subAccounts"
user* String Indirizzo in formato esadecimale di 42 caratteri; ad es. 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 %}

Recupero dei dettagli di un vault

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

Intestazioni

Name Type Description
Content-Type* String "application/json"

Corpo della richiesta

Name Type Description
type* String "vaultDetails"
vaultAddress* String Indirizzo in formato esadecimale di 42 caratteri; ad es. 0x0000000000000000000000000000000000000000.
user String Indirizzo in formato esadecimale di 42 caratteri; ad es. 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 %}

Recupero dei depositi in vault di un utente

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

Intestazioni

Name Type Description
Content-Type* String "application/json"

Corpo della richiesta

Name Type Description
type* String "userVaultEquities"
user* String Indirizzo in formato esadecimale di 42 caratteri; ad es. 0x0000000000000000000000000000000000000000.

{% tabs %}

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

{% endtab %}

Interrogazione del ruolo di un utente

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

Intestazioni

Name Type Description
Content-Type* String "application/json"

Corpo della richiesta

Name Type Description
type* String "userRole"
user* String Indirizzo in formato esadecimale di 42 caratteri; ad es. 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 %}

Interrogazione del portafoglio di un utente

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

Intestazioni

Name Type Description
Content-Type* String "application/json"

Corpo della richiesta

Name Type Description
type* String "portfolio"
user* String formato esadecimale; ad es. 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 %}

Interrogazione delle informazioni di referral di un utente

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

Intestazioni

Name Type Description
Content-Type* String "application/json"

Corpo della richiesta

Name Type Description
type* String "referral"
user* String formato esadecimale; ad es. 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 %}

Si noti che rewardHistory riguarda le ricompense legacy. Le ricompense riscattate sono ora restituite in nonFundingLedgerUpdate

Interrogazione delle commissioni di un utente

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

Intestazioni

Name Type Description
Content-Type* String "application/json"

Corpo della richiesta

Name Type Description
type* String "userFees"
user* String formato esadecimale; ad es. 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 %}

Interrogazione delle deleghe di staking di un utente

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

Intestazioni

Name Type Description
Content-Type* String "application/json"

Corpo della richiesta

Name Type Description
type* String "delegations"
user* String formato esadecimale; ad es. 0x0000000000000000000000000000000000000000.

{% tabs %}

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

{% endtab %}

Interrogazione del riepilogo di staking di un utente

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

Intestazioni

Name Type Description
Content-Type* String "application/json"

Corpo della richiesta

Name Type Description
type* String "delegatorSummary"
user* String formato esadecimale; ad es. 0x0000000000000000000000000000000000000000.

{% tabs %}

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

{% endtab %}

Interrogazione della cronologia di staking di un utente

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

Intestazioni

Name Type Description
Content-Type* String "application/json"

Corpo della richiesta

Name Type Description
type* String "delegatorHistory"
user* String formato esadecimale; ad es. 0x0000000000000000000000000000000000000000.

{% tabs %}

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

{% endtab %}

Interrogazione delle ricompense di staking di un utente

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

Intestazioni

Name Type Description
Content-Type* String "application/json"

Corpo della richiesta

Name Type Description
type* String "delegatorRewards"
user* String formato esadecimale; ad es. 0x0000000000000000000000000000000000000000.

{% tabs %}

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

{% endtab %}

Interrogazione dello stato di astrazione HIP-3 DEX di un utente

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

Intestazioni

Name Type Description
Content-Type* String "application/json"

Corpo della richiesta

Name Type Description
type* String "userDexAbstraction"
user* String formato esadecimale; ad es. 0x0000000000000000000000000000000000000000.

{% tabs %}

true

{% endtab %}

Interrogazione dello stato di astrazione di un utente

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

Intestazioni

Name Type Description
Content-Type* String "application/json"

Corpo della richiesta

Name Type Description
type* String "userAbstraction"
user* String formato esadecimale; ad es. 0x0000000000000000000000000000000000000000.

{% tabs %}

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

{% endtab %}

Interrogazione dello stato borrow/lend dell'utente

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

Intestazioni

Name Type Description
Content-Type* String "application/json"

Corpo della richiesta

Name Type Description
type* String "borrowLendUserState"
user* String formato esadecimale; ad es. 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 %}

Interrogazione dello stato della riserva borrow/lend

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

Intestazioni

Name Type Description
Content-Type* String "application/json"

Corpo della richiesta

Name Type Description
type* String "borrowLendReserveState"
token* Number Indice del token

{% 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 %}

Interrogazione di tutti gli stati delle riserve borrow/lend

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

Intestazioni

Name Type Description
Content-Type* String "application/json"

Corpo della richiesta

Name Type Description
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 %}

Interrogazione dei builder approvati per l'utente

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

Intestazioni

Name Type Description
Content-Type* String "application/json"

Corpo della richiesta

Name Type Description
type* String "approvedBuilders"
user* String formato esadecimale; ad es. 0x0000000000000000000000000000000000000000.

{% tabs %}

["0x476fa87b4d3818f437f38f1263bee508d7672d82"]

{% endtab %}

Fonte ufficiale: https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint
Istantanea della fonte: · Mirror generato: · Traduzione della community; fa fede la versione inglese
Traduzione non ufficiale della community della documentazione Hyperliquid. Contenuti © Hyperliquid; fa fede la versione inglese. Fonte: https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint