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

スポット

このセクションでは、スポットに固有のinfoエンドポイントについて説明します。

スポットメタデータを取得

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

ヘッダー

Name Value
Content-Type* "application/json"

ボディ

Name Type Description
type* String "spotMeta"

レスポンス

{% tabs %}

{
    "tokens": [
        {
            "name": "USDC",
            "szDecimals": 8,
            "weiDecimals" 8,
            "index": 0,
            "tokenId": "0x6d1e7cde53ba9467b783cb7c530ce054",
            "isCanonical": true,
            "evmContract":null,
            "fullName":null
        },
        {
            "name": "PURR",
            "szDecimals": 0,
            "weiDecimals": 5,
            "index": 1,
            "tokenId": "0xc1fb593aeffbeb02f85e0308e9956a90",
            "isCanonical": true,
            "evmContract":null,
            "fullName":null
        },
        {
            "name": "HFUN",
            "szDecimals": 2,
            "weiDecimals": 8,
            "index": 2,
            "tokenId": "0xbaf265ef389da684513d98d68edf4eae",
            "isCanonical": false,
            "evmContract":null,
            "fullName":null
        },
    ],
    "universe": [
        {
            "name": "PURR/USDC",
            "tokens": [1, 0],
            "index": 0,
            "isCanonical": true
        },
        {
            "tokens": [2, 0],
            "name": "@1",
            "index": 1,
            "isCanonical": false
        },
    ]
}

{% endtab %}

スポットアセットコンテキストを取得

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

ヘッダー

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

リクエストボディ

Name Type Description
type* String "spotMetaAndAssetCtxs"

{% tabs %}

[
{
    "tokens": [
        {
            "name": "USDC",
            "szDecimals": 8,
            "weiDecimals" 8,
            "index": 0,
            "tokenId": "0x6d1e7cde53ba9467b783cb7c530ce054",
            "isCanonical": true,
            "evmContract":null,
            "fullName":null
        },
        {
            "name": "PURR",
            "szDecimals": 0,
            "weiDecimals": 5,
            "index": 1,
            "tokenId": "0xc1fb593aeffbeb02f85e0308e9956a90",
            "isCanonical": true,
            "evmContract":null,
            "fullName":null
        }
    ],
    "universe": [
        {
            "name": "PURR/USDC",
            "tokens": [1, 0],
            "index": 0,
            "isCanonical": true
        }
    ]
},
[
    {
        "dayNtlVlm":"8906.0",
        "markPx":"0.14",
        "midPx":"0.209265",
        "prevDayPx":"0.20432"
    }
]
]

{% endtab %}

ユーザーのトークン残高を取得

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

ユーザーのトークン残高を確認します。

統合アカウントまたはポートフォリオ証拠金の場合、スポットと永続契約にわたる取引アカウント残高の信頼できる情報源はこのエンドポイントです。

ヘッダー

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

リクエストボディ

Name Type Description
type* String "spotClearinghouseState"
user* String 42文字の16進数形式のオンチェーンアドレス。例：0x0000000000000000000000000000000000000000。

{% tabs %}

{
    "balances": [
        {
            "coin": "USDC",
            "token": 0,
            "hold": "0.0",
            "total": "14.625485",
            "entryNtl": "0.0"
        },
        {
            "coin": "PURR",
            "token": 1,
            "hold": "0.0",
            "total": "2000.0",
            "entryNtl": "1234.56"
        },
        {
            "coin": "+1230",
            "hold": "0.0",
            "total": "25.0",
            "entryNtl": "12.5"
        }
    ]
}

{% endtab %}

Spot Deploy Auctionの情報を取得

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

ヘッダー

Name Value
Content-Type* "application/json"

ボディ

Name Type Description
type* String "spotDeployState"
user* String 42文字の16進数形式のオンチェーンアドレス。例：0x0000000000000000000000000000000000000000。

レスポンス

{% tabs %}

{
  "states": [
    {
      "token": 150,
      "spec" : {
        "name": "HYPE",
        "szDecimals": 2,
        "weiDecimals": 8,
      },
      "fullName": "Hyperliquid",
      "spots": [107],
      "maxSupply": 1000000000,
      "hyperliquidityGenesisBalance": "120000",
      "totalGenesisBalanceWei": "100000000000000000",
      "userGenesisBalances": [
        ("0xdddddddddddddddddddddddddddddddddddddddd", "428,062,211")...
      ],
      "existingTokenGenesisBalances": [
        (1, "0")...
      ]
    }
  ],
  "gasAuction": {
    "startTimeSeconds": 1733929200,
    "durationSeconds": 111600,
    "startGas": "181305.90046",
    "currentGas": null,
    "endGas": "181291.247358"
  }
}

{% endtab %}

Spot Pair Deploy Auctionの情報を取得

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

注：このエンドポイントは、既存のベース資産とクォート資産間のスポットペアデプロイに関するオランダ式オークションのステータスを返します。このオークションへの参加は、ベーストークンのデプロイにおけるregisterSpotフェーズと同じアクションによってパーミッションレスに行えます。

ヘッダー

Name Value
Content-Type* "application/json"

ボディ

Name Type Description
type* String "spotPairDeployAuctionStatus"

{% tabs %}

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

{% endtab %}

トークンの情報を取得

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

ヘッダー

Name Value
Content-Type* "application/json"

ボディ

Name Type Description
type* String "tokenDetails"
tokenId* String 34文字の16進数形式のオンチェーンID。例：0x00000000000000000000000000000000。

レスポンス

{% tabs %}

{
  "name": "TEST",
  "maxSupply": "1852229076.12716007",
  "totalSupply": "851681534.05516005",
  "circulatingSupply": "851681534.05516005",
  "szDecimals": 0,
  "weiDecimals": 5,
  "midPx": "3.2049",
  "markPx": "3.2025",
  "prevDayPx": "3.2025",
  "genesis": {
    "userBalances": [
      [
        "0x0000000000000000000000000000000000000001",
        "1000000000.0"
      ],
      [
        "0xffffffffffffffffffffffffffffffffffffffff",
        "1000000000.0"
      ]
    ],
    "existingTokenBalances": []
  },
  "deployer": "0x0000000000000000000000000000000000000001",
  "deployGas": "100.0",
  "deployTime": "2024-06-05T10:50:59.434",
  "seededUsdc": "0.0",
  "nonCirculatingUserBalances": [],
  "futureEmissions": "0.0"
}

{% endtab %}

アウトカムメタデータを取得

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

アウトカムを参照するためにAPIが使用する形式については、Asset IDsセクションを参照してください。テンプレートからデプロイされたアウトカムとクエスチョンのnameはtemplate:<id>であり、<id>はoutcomeTemplatesレスポンス内のテンプレートのidです。それらの記述形式については、HIP-4のデプロイドキュメントを参照してください。

繰り返しのスタンドアロンアウトカムとクエスチョンはRecurringと名付けられ、そのdescriptionはclassで始まる|区切りのkey:valueペアです。expiryはYYYYMMDD-HHMM形式のUTC時刻、underlyingは永続契約のコイン名です。記述には他のキーが含まれる場合がありますが、無視できます。

  • class:priceBinaryはスタンドアロンアウトカムです。例：class:priceBinary|underlying:BTC|expiry:20260526-0600|targetPrice:77363|period:1d。expiry時点のunderlyingのマーク価格がtargetPriceを上回る場合、Yesに決着します。
  • class:priceBucketはクエスチョンです。例：class:priceBucket|underlying:BTC|expiry:20260615-0600|priceThresholds:63250,65831|period:1d。ここでpriceThresholdsは<lower>,<upper>です。expiry時点のunderlyingのマーク価格に基づき：
  • 記述がindex:0のアウトカムは、価格がlower未満の場合にYesに決着します。
  • 記述がindex:1のアウトカムは、価格がlower以上かつupper未満の場合にYesに決着します。
  • 記述がindex:2のアウトカムは、価格がupper以上の場合にYesに決着します。

ヘッダー

Name Value
Content-Type* "application/json"

ボディ

Name Type Description
type* String "outcomeMeta"

レスポンス

{% tabs %}

{
  "outcomes": [
    {
      "outcome": 123,
      "name": "Recurring",
      "description": "class:priceBinary|underlying:HYPE|expiry:20260310-1100|targetPrice:34.5|period:3m",
      "sideSpecs": [
        {
          "name": "Yes"
        },
        {
          "name": "No"
        }
      ]
    }
  ]
}

{% endtab %}

アウトカムテンプレートを取得

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

ヘッダー

Name Value
Content-Type* "application/json"

ボディ

Name Type Description
type* String "outcomeTemplates"

すべてのアウトカムテンプレートを返します。roleは{"standaloneOutcome": {"sideNames": [...]}}、"question"、{"questionOutcome": {"parent": <question template id>}}のいずれかです。nameとdescriptionには{keyword}プレースホルダーが含まれ、keywordsは各キーワードとその型を[keyword, type]ペアとして列挙します。各型の値の形式については、HIP-4のデプロイドキュメントを参照してください。

レスポンス

{% tabs %}

[
  {
    "id": "binaryPrice",
    "role": { "standaloneOutcome": { "sideNames": ["Yes", "No"] } },
    "name": "{perp} above {threshold} at {time}?",
    "description": "The market resolves to Yes if the {perp} price is above {threshold} at {time}, and otherwise resolves to No. Settlement is according to the {seconds}-second TWAP of {priceDescription} price ending at {time}. If {perp} is delisted before this market settles, settlement is instead according to the {perp} settlement price at delisting. metadata=category:price|subCategory:N/A|semanticRestriction:This market must refer to the price of a Hyperliquid perp.",
    "keywords": [["perp", "hlPerp"], ["priceDescription", "string"], ["seconds", "uInt"], ["threshold", "uDecimal"], ["time", "dateTime"]]
  },
  {
    "id": "policyRateDecision",
    "role": "question",
    "name": "{institution} {decisionLabel} rate decision",
    "description": "This market has three possible results: No change, Decrease, or Increase. Exactly one corresponding named outcome resolves to Yes; the other two and the protocol-created fallback resolve to No. It covers the {decisionLabel} {institution} decision concerning {policyMeasure}, scheduled for {scheduledDecision} UTC (the \"Decision\"). The Decision Value is the numeric value of {policyMeasure} announced by {officialSource}. The Prior Value is the value of that same measure in effect immediately before the Decision. No change resolves to Yes if the Decision Value equals the Prior Value. Decrease resolves to Yes if the Decision Value is lower. Increase resolves to Yes if the Decision Value is higher. If the Decision is rescheduled, the rescheduled decision applies if {officialSource} publishes it by {decisionDeadline} UTC. If the Decision is canceled or postponed without a replacement decision, or no official Decision Value is published by {decisionDeadline} UTC, No change resolves to Yes. Policy changes outside the scheduled Decision are ignored except when establishing the Prior Value. If {institution} replaces {policyMeasure}, the closest official successor measure identified by {officialSource} is used. Resolution uses the initially published decision; later revisions do not change the resolution. {officialSource} is the primary resolution source; independent reputable reporting may be used if it has not published the relevant decision. No change resolves to Yes under the deadline rule above only if neither {officialSource} nor independent reputable reporting establishes a Decision Value by {decisionDeadline} UTC. metadata=category:economics|subCategory:N/A|semanticRestriction:This market must refer to a scheduled policy rate decision by an official institution.",
    "keywords": [["decisionDeadline", "dateTime"], ["decisionLabel", "string"], ["institution", "string"], ["officialSource", "string"], ["policyMeasure", "string"], ["scheduledDecision", "dateTime"]]
  },
  {
    "id": "policyRateDecrease",
    "role": { "questionOutcome": { "parent": "policyRateDecision" } },
    "name": "Decrease",
    "description": "This outcome resolves to Yes if the Decision Value is lower than the Prior Value under the parent question's rules.",
    "keywords": []
  }
]

{% endtab %}

決着済みアウトカムの情報を取得

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

ヘッダー

Name Value
Content-Type* "application/json"

ボディ

Name Type Description
type* String "settledOutcome"
outcome* int アウトカムID

レスポンス

{% tabs %}

{
  "spec": {
    "outcome": 95,
    "name": "Recurring",
    "description": "class:priceBinary|underlying:BTC|expiry:20260526-0600|targetPrice:77363|period:1d",
    "sideSpecs": [
      {
        "name": "Yes"
      },
      {
        "name": "No"
      }
    ],
    "quoteToken": "USDC"
  },
  "settleFraction": "0.0",
  "details": "price:76876.9"
}

{% endtab %}

アウトカムデプロイヤーの制限を取得

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

ヘッダー

Name Value
Content-Type* "application/json"

ボディ

Name Type Description
type* String "outcomeDeployerLimits"
venue* String venue名

レスポンス

{% tabs %}

{
  "nDailyOutcomesRemaining": 50,
  "nActiveOutcomesRemaining": 14
}

{% endtab %}

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