Страница переведена сообществом и носит справочный характер; актуальна английская версия.
Документация Hyperliquid›Для разработчиков›API›Конечная точка info›Бессрочные контракты (перпы)
Оригинал ↗

Бессрочные контракты (перпы)

Этот раздел описывает информационные конечные точки API, относящиеся к бессрочным контрактам. Логику и весовые коэффициенты ограничения частоты запросов см. в разделе Rate limits.

Получить все перп-дексы

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

Заголовки

Имя Тип Описание
Content-Type* String "application/json"

Тело запроса

Имя Тип Описание
type* String "perpDexs"

{% tabs %}

[
  null,
  {
    "name": "test",
    "fullName": "test dex",
    "deployer": "0x5e89b26d8d66da9888c835c9bfcc2aa51813e152",
    "oracleUpdater": null,
    "feeRecipient": null,
    "assetToStreamingOiCap": [["COIN1", "100000.0"], ["COIN2", "200000.0"]],
    "assetToFundingMultiplier": [["COIN1", "1.0"], ["COIN2", "2.0"]]
  }
]

{% endtab %}

Получить метаданные бессрочных контрактов (universe и таблицы маржи)

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

Заголовки

Имя Тип Описание
Content-Type* String "application/json"

Тело запроса

Имя Тип Описание
type* String "meta"
dex String Название перп-декса. По умолчанию — пустая строка, которая обозначает первый перп-декс.

{% tabs %}

{
    "universe": [
        {
            "name": "BTC",
            "szDecimals": 5,
            "maxLeverage": 50
        },
        {
            "name": "ETH",
            "szDecimals": 4,
            "maxLeverage": 50
        },
        {
            "name": "HPOS",
            "szDecimals": 0,
            "maxLeverage": 3,
            "onlyIsolated": true
        },
        {
            "name": "LOOM",
            "szDecimals": 1,
            "maxLeverage": 3,
            "isDelisted": true,
            "marginMode": "strictIsolated", // "strictIsolated" means margin cannot be removed, "noCross" means only isolated margin allowed
            "onlyIsolated": true // deprecated. Means either "strictIsolated" or "noCross"
        }
    ],
    "marginTables": [
        [
            50,
            {
                "description": "",
                "marginTiers": [
                    {
                        "lowerBound": "0.0",
                        "maxLeverage": 50
                    }
                ]
            }
        ],
        [
            51,
            {
                "description": "tiered 10x",
                "marginTiers": [
                    {
                        "lowerBound": "0.0",
                        "maxLeverage": 10
                    },
                    {
                        "lowerBound": "3000000.0",
                        "maxLeverage": 5
                    }
                ]
            }
        ]
    ]
}

{% endtab %}

Получить контексты активов бессрочных контрактов (включает цену маркировки, текущее финансирование, открытый интерес и т.д.)

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

Заголовки

Имя Тип Описание
Content-Type* String "application/json"

Тело запроса

Имя Тип Описание
type* String "metaAndAssetCtxs"
dex String Название перп-декса. По умолчанию — пустая строка, которая обозначает первый перп-декс.

{% tabs %}

[
{
     "universe": [
        {
            "name": "BTC",
            "szDecimals": 5,
            "maxLeverage": 50
        },
        {
            "name": "ETH",
            "szDecimals": 4,
            "maxLeverage": 50
        },
        {
            "name": "HPOS",
            "szDecimals": 0,
            "maxLeverage": 3,
            "onlyIsolated": true
        }
    ],
    "marginTables":[
         [
            50,
            {
               "description":"",
               "marginTiers":[
                  {
                     "lowerBound":"0.0",
                     "maxLeverage":50
                  }
               ]
            }
         ]
     ],
     "collateralToken":0
},
[
    {
        "dayNtlVlm":"1169046.29406",
         "funding":"0.0000125",
         "impactPxs":[
            "14.3047",
            "14.3444"
         ],
         "markPx":"14.3161",
         "midPx":"14.314",
         "openInterest":"688.11",
         "oraclePx":"14.32",
         "premium":"0.00031774",
         "prevDayPx":"15.322"
    },
    {
         "dayNtlVlm":"1426126.295175",
         "funding":"0.0000125",
         "impactPxs":[
            "6.0386",
            "6.0562"
         ],
         "markPx":"6.0436",
         "midPx":"6.0431",
         "openInterest":"1882.55",
         "oraclePx":"6.0457",
         "premium":"0.00028119",
         "prevDayPx":"6.3611"
      },
      {
         "dayNtlVlm":"809774.565507",
         "funding":"0.0000125",
         "impactPxs":[
            "8.4505",
            "8.4722"
         ],
         "markPx":"8.4542",
         "midPx":"8.4557",
         "openInterest":"2912.05",
         "oraclePx":"8.4585",
         "premium":"0.00033694",
         "prevDayPx":"8.8097"
      }
]
]

{% endtab %}

{% tab title="200: OK Успешный ответ (декс HIP-3)" %}

[
   {
      "universe":[
         {
            "szDecimals":4,
            "name":"xyz:XYZ100",
            "maxLeverage":20,
            "marginTableId":20,
            "onlyIsolated":true,
            "marginMode":"strictIsolated",
            "growthMode":"enabled",
            "lastGrowthModeChangeTime":"2025-11-23T17:21:40.390706535"
         },
         {
            "szDecimals":3,
            "name":"xyz:TSLA",
            "maxLeverage":10,
            "marginTableId":10,
            "onlyIsolated":true,
            "marginMode":"strictIsolated",
            "growthMode":"enabled",
            "lastGrowthModeChangeTime":"2025-11-23T17:21:40.390706535"
         },
         {
            "szDecimals":3,
            "name":"xyz:NVDA",
            "maxLeverage":10,
            "marginTableId":10,
            "onlyIsolated":true,
            "marginMode":"strictIsolated",
            "growthMode":"enabled",
            "lastGrowthModeChangeTime":"2025-11-23T17:21:40.390706535"
         }
      ],
      "marginTables":[
         [
            50,
            {
               "description":"",
               "marginTiers":[
                  {
                     "lowerBound":"0.0",
                     "maxLeverage":50
                  }
               ]
            }
         ]
      ],
      "collateralToken":0
   },
   [
      {
         "funding":"0.0002110251",
         "openInterest":"0.0854",
         "prevDayPx":"25956.0",
         "dayNtlVlm":"462.9758",
         "premium":"0.0031136686",
         "oraclePx":"25372.0",
         "markPx":"25451.0",
         "midPx":"25451.0",
         "impactPxs":[
            "24946.0",
            "25956.0"
         ],
         "dayBaseVlm":"0.0183"
      },
      {
         "funding":"0.0",
         "openInterest":"12.208",
         "prevDayPx":"447.49",
         "dayNtlVlm":"0.0",
         "premium":null,
         "oraclePx":"450.78",
         "markPx":"465.13",
         "midPx":"464.92",
         "impactPxs":null,
         "dayBaseVlm":"0.0"
      },
      {
         "funding":"0.0",
         "openInterest":"9.43",
         "prevDayPx":"177.0",
         "dayNtlVlm":"2192.853",
         "premium":null,
         "oraclePx":"188.15",
         "markPx":"177.06",
         "midPx":null,
         "impactPxs":null,
         "dayBaseVlm":"12.389"
      }
   ]
]

{% endtab %}

Получить сводку по счёту пользователя для бессрочных контрактов

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

Просмотр открытых позиций пользователя и сводки по марже для торговли бессрочными контрактами.

В едином аккаунте или при портфельной марже используйте вместо этого конечную точку балансов спот-активов для получения баланса торгового счёта по споту и перпам.

Заголовки

Имя Тип Описание
Content-Type* "application/json"

Тело запроса

Имя Тип Описание
type* String "clearinghouseState"
user* String Адрес в блокчейне в 42-символьном шестнадцатеричном формате; напр. 0x0000000000000000000000000000000000000000.
dex String Название перп-декса. По умолчанию — пустая строка, которая обозначает первый перп-декс.

{% tabs %}

{
  "assetPositions": [
    {
      "position": {
        "coin": "ETH",
        "cumFunding": {
          "allTime": "514.085417",
          "sinceChange": "0.0",
          "sinceOpen": "0.0"
        },
        "entryPx": "2986.3",
        "leverage": {
          "rawUsd": "-95.059824",
          "type": "isolated",
          "value": 20
        },
        "liquidationPx": "2866.26936529",
        "marginUsed": "4.967826",
        "maxLeverage": 50,
        "positionValue": "100.02765",
        "returnOnEquity": "-0.0026789",
        "szi": "0.0335",
        "unrealizedPnl": "-0.0134"
      },
      "type": "oneWay"
    }
  ],
  "crossMaintenanceMarginUsed": "0.0",
  "crossMarginSummary": {
    "accountValue": "13104.514502",
    "totalMarginUsed": "0.0",
    "totalNtlPos": "0.0",
    "totalRawUsd": "13104.514502"
  },
  "marginSummary": {
    "accountValue": "13109.482328",
    "totalMarginUsed": "4.967826",
    "totalNtlPos": "100.02765",
    "totalRawUsd": "13009.454678"
  },
  "time": 1708622398623,
  "withdrawable": "13104.514502"
}

{% endtab %}

Получить историю финансирования пользователя или обновления леджера без финансирования

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

Примечание: обновления леджера без финансирования включают депозиты, переводы и выводы средств.

Заголовки

Имя Тип Описание
Content-Type* String "application/json"

Тело запроса

Имя Тип Описание
type* String "userFunding" или "userNonFundingLedgerUpdates"
user* String Адрес в 42-символьном шестнадцатеричном формате; напр. 0x0000000000000000000000000000000000000000.
startTime* int Начальное время в миллисекундах, включительно
endTime int Конечное время в миллисекундах, включительно. По умолчанию — текущее время.

{% tabs %}

[
    {
        "delta": {
            "coin": "ETH",
            "fundingRate": "0.0000417",
            "szi": "49.1477",
            "type": "funding",
            "usdc":" -3.625312",
            "nSamples": null
        },
        "hash": "0xa166e3fa63c25663024b03f2e0da011a00307e4017465df020210d3d432e7cb8",
        "time": 1681222254710
    },
    ...
]

{% endtab %}

{% tab title="200: OK Успешный ответ (декс HIP-3)" %}

[
   {
      "delta":{
           "type": "funding",
           "coin": "xyz:XYZ100",
           "usdc": "2.378343",
           "szi": "-15.0",
           "fundingRate": "0.00000625",
           "nSamples": null
      },
      "time": 1767654000068,
      "hash": "0xa166e3fa63c25663024b03f2e0da011a00307e4017465df020210d3d432e7cb9"
   },
   ...
]

{% endtab %}

Получить исторические ставки финансирования

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

Заголовки

Имя Тип Описание
Content-Type* String "application/json"

Тело запроса

Имя Тип Описание
type* String "fundingHistory"
coin* String Монета, напр. "ETH"
startTime* int Начальное время в миллисекундах, включительно
endTime int Конечное время в миллисекундах, включительно. По умолчанию — текущее время.

{% tabs %}

[
    {
        "coin":"ETH",
        "fundingRate": "-0.00022196",
        "premium": "-0.00052196",
        "time":1683849600076
    }
]

{% endtab %}

{% tab title="200: OK (декс HIP-3)" %}

[ 
    {
        "coin": "xyz:XYZ100",
        "fundingRate": "-0.00022196",
        "premium": "-0.00052196",
        "time": 1683849600076
    }
]

{% endtab %}

Получить прогнозируемые ставки финансирования для разных площадок

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

Обратите внимание: прогнозируемые ставки финансирования поддерживаются только для первого перп-декса.

Заголовки

Имя Тип Описание
Content-Type* String "application/json"

Тело запроса

Имя Тип Описание
type* String "predictedFundings"

{% tabs %}

[
  [
    "AVAX",
    [
      [
        "BinPerp",
        {
          "fundingRate": "0.0001",
          "nextFundingTime": 1733961600000
        }
      ],
      [
        "HlPerp",
        {
          "fundingRate": "0.0000125",
          "nextFundingTime": 1733958000000
        }
      ],
      [
        "BybitPerp",
        {
          "fundingRate": "0.0001",
          "nextFundingTime": 1733961600000
        }
      ]
    ]
  ],...
]

{% endtab %}

Запросить перпы на лимитах открытого интереса

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

Заголовки

Имя Тип Описание
Content-Type* String "application/json"

Тело запроса

Имя Тип Описание
type* String "perpsAtOpenInterestCap"
dex String Название перп-декса dex-рынка, развёрнутого билдером. Если не указан, используется первый перп-декс

{% tabs %}

["BADGER","CANTO","FTM","LOOM","PURR"]

{% endtab %}

Получить информацию об аукционе развёртывания перпов

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

Заголовки

Имя Тип Описание
Content-Type* String "application/json"

Тело запроса

Имя Тип Описание
type* String "perpDeployAuctionStatus"

{% tabs %}

{
  "startTimeSeconds": 1747656000,
  "durationSeconds": 111600,
  "startGas": "500.0",
  "currentGas": "500.0",
  "endGas": null
}

{% endtab %}

Получить данные по активным активам пользователя

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

Заголовки

Имя Тип Описание
Content-Type* String "application/json"

Тело запроса

Имя Тип Описание
type* String "activeAssetData"
user* String Адрес в 42-символьном шестнадцатеричном формате; напр. 0x0000000000000000000000000000000000000000.
coin* String Монета, напр. "ETH". Подробнее см. здесь.

{% tabs %}

{
  "user": "0xb65822a30bbaaa68942d6f4c43d78704faeabbbb",
  "coin": "APT",
  "leverage": {
    "type": "cross",
    "value": 3
  },
  "maxTradeSzs": ["24836370.4400000013", "24836370.4400000013"],
  "availableToTrade": ["37019438.0284740031", "37019438.0284740031"],
  "markPx": "4.4716"
}

{% endtab %}

{% tab title="200: OK (декс HIP-3)" %}

{
   "user": "0xa15099a30bbf2e68942d6f4c43d70d04faeab0a0",
   "coin": "xyz:XYZ100",
   "leverage":{
      "type": "isolated",
      "value": 20,
      "rawUsd": "0.0"
   },
   "maxTradeSzs": [
      "0.0",
      "0.0"
   ],
   "availableToTrade": [
      "0.0",
      "0.0"
   ],
   "markPx": "25451.0"
}

{% endtab %}

Получить лимиты перп-рынков, развёрнутых билдерами

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

Заголовки

Имя Тип Описание
Content-Type* String "application/json"

Тело запроса

Имя Тип Описание
type* String "perpDexLimits"
dex* String Название перп-декса dex-рынка, развёрнутого билдером. Пустая строка не допускается.

{% tabs %}

{
  "totalOiCap": "10000000.0",
  "oiSzCapPerPerp": "10000000000.0",
  "maxTransferNtl": "100000000.0",
  "coinToOiCap": [["COIN1", "100000.0"], ["COIN2", "200000.0"]],
}

{% endtab %}

Получить статус перп-рынка

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

Заголовки

Имя Тип Описание
Content-Type* String "application/json"

Тело запроса

Имя Тип Описание
type* String "perpDexStatus"
dex* String Название перп-декса dex-рынка, развёрнутого билдером. Пустая строка обозначает первый перп-декс.

{% tabs %}

{
  "totalNetDeposit": "4103492112.4478230476"
}

{% endtab %}

Получить все метаданные бессрочных контрактов (universe и таблицы маржи)

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

Заголовки

Имя Тип Описание
Content-Type* String "application/json"

Тело запроса

Имя Тип Описание
type* String "allPerpMetas"

{% tabs %}

[ // first perp dex
    [
        {
            "universe":[
                {
                    "name":"BTC",
                    "szDecimals":5,
                    "maxLeverage":50
                },
                {
                    "name":"ETH",
                    "szDecimals":4,
                    "maxLeverage":50
                },
                {
                    "name":"HPOS",
                    "szDecimals":0,
                    "maxLeverage":3,
                    "onlyIsolated":true
                }
            ],
            "marginTables":[
                [
                    50,
                    {
                        "description":"",
                        "marginTiers":[
                            {
                                "lowerBound":"0.0",
                                "maxLeverage":50
                            }
                        ]
                    }
                ]
            ],
            "collateralToken":0
        },
        [
            {
                "dayNtlVlm":"1169046.29406",
                "funding":"0.0000125",
                "impactPxs":[
                    "14.3047",
                    "14.3444"
                ],
                "markPx":"14.3161",
                "midPx":"14.314",
                "openInterest":"688.11",
                "oraclePx":"14.32",
                "premium":"0.00031774",
                "prevDayPx":"15.322"
            },
            {
                "dayNtlVlm":"1426126.295175",
                "funding":"0.0000125",
                "impactPxs":[
                    "6.0386",
                    "6.0562"
                ],
                "markPx":"6.0436",
                "midPx":"6.0431",
                "openInterest":"1882.55",
                "oraclePx":"6.0457",
                "premium":"0.00028119",
                "prevDayPx":"6.3611"
            },
            {
                "dayNtlVlm":"809774.565507",
                "funding":"0.0000125",
                "impactPxs":[
                    "8.4505",
                    "8.4722"
                ],
                "markPx":"8.4542",
                "midPx":"8.4557",
                "openInterest":"2912.05",
                "oraclePx":"8.4585",
                "premium":"0.00033694",
                "prevDayPx":"8.8097"
            }
        ]
    ],
    [ // second perp dex
        {
            "universe":[
                {
                    "szDecimals":4,
                    "name":"xyz:XYZ100",
                    "maxLeverage":20,
                    "marginTableId":20,
                    "onlyIsolated":true,
                    "marginMode":"strictIsolated",
                    "growthMode":"enabled",
                    "lastGrowthModeChangeTime":"2025-11-23T17:21:40.390706535"
                },
                {
                    "szDecimals":3,
                    "name":"xyz:TSLA",
                    "maxLeverage":10,
                    "marginTableId":10,
                    "onlyIsolated":true,
                    "marginMode":"strictIsolated",
                    "growthMode":"enabled",
                    "lastGrowthModeChangeTime":"2025-11-23T17:21:40.390706535"
                },
                {
                    "szDecimals":3,
                    "name":"xyz:NVDA",
                    "maxLeverage":10,
                    "marginTableId":10,
                    "onlyIsolated":true,
                    "marginMode":"strictIsolated",
                    "growthMode":"enabled",
                    "lastGrowthModeChangeTime":"2025-11-23T17:21:40.390706535"
                }
            ],
            "marginTables":[
                [
                    50,
                    {
                        "description":"",
                        "marginTiers":[
                            {
                                "lowerBound":"0.0",
                                "maxLeverage":50
                            }
                        ]
                    }
                ]
            ],
            "collateralToken":0
        },
        [
            {
                "funding":"0.0002110251",
                "openInterest":"0.0854",
                "prevDayPx":"25956.0",
                "dayNtlVlm":"462.9758",
                "premium":"0.0031136686",
                "oraclePx":"25372.0",
                "markPx":"25451.0",
                "midPx":"25451.0",
                "impactPxs":[
                    "24946.0",
                    "25956.0"
                ],
                "dayBaseVlm":"0.0183"
            },
            {
                "funding":"0.0",
                "openInterest":"12.208",
                "prevDayPx":"447.49",
                "dayNtlVlm":"0.0",
                "premium":null,
                "oraclePx":"450.78",
                "markPx":"465.13",
                "midPx":"464.92",
                "impactPxs":null,
                "dayBaseVlm":"0.0"
            },
            {
                "funding":"0.0",
                "openInterest":"9.43",
                "prevDayPx":"177.0",
                "dayNtlVlm":"2192.853",
                "premium":null,
                "oraclePx":"188.15",
                "markPx":"177.06",
                "midPx":null,
                "impactPxs":null,
                "dayBaseVlm":"12.389"
            }
        ]
    ]
]

{% endtab %}

Получить аннотацию перпа

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

Заголовки

Имя Тип Описание
Content-Type* String "application/json"

Тело запроса

Имя Тип Описание
type* String "perpAnnotation"
coin* String название монеты, напр. "BTC"

{% tabs %}

{
  "category": "other",
  "description": "other perps"
}

{% endtab %}

Получить категории перпов

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

Заголовки

Имя Тип Описание
Content-Type* String "application/json"

Тело запроса

Имя Тип Описание
type* String "perpCategories"

{% tabs %}

[["birb:PENGU","test_cat"],["nq:TEST","preipo"],["nq:TEST1","all"],["nq:TEST2","ai"]]

{% endtab %}

Получить краткие аннотации перпов

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

Заголовки

Имя Тип Описание
Content-Type* String "application/json"

Тело запроса

Имя Тип Описание
type* String "perpConciseAnnotations"

{% tabs %}

[    
    [
        "dex:CATS",
        {
            "category": "indices",
            "keywords": ["meow"]
        }
    ],
    [
        "dex:DOGS",
        {
            "category": "indices"
        }
    ]
]

{% endtab %}

Официальный источник: https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/perpetuals
Дата снимка: · Дата сборки: · Перевод сообщества; приоритет у английской версии
Неофициальный перевод сообщества. Права на контент принадлежат Hyperliquid; актуальна английская версия. Источник: https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/perpetuals