Petrovich Penki

公開加密貨幣市場 API 可用於建立價格追蹤器、研究工具、儀表板，以及交易實驗。在本教學中，我們將使用 Python 取得 XT.com 現貨市場行情資料，無需 API 金鑰或外部套件。

此實驗是在研究該交易所並為 XTGuide.com 準備獨立教學時所建立的。

我們正在建立什麼

我們將建立一個小型命令列腳本，它能：

  • 連線到 XT.com 公開行情端點
  • 接受交易對，例如 btc_usdt
  • 取得公開市場資料
  • 以格式化的 JSON 印出回應
  • 處理基本的網路錯誤

由於本範例僅請求公開可取得的市場資訊，因此您不需要 XT.com 帳戶或私密 API 憑證。

Python 程式碼

建立一個名為 xt_ticker.py 的新檔案，並加入下列程式碼：

import json
import sys
from urllib.parse import urlencode
from urllib.request import Request, urlopen
from urllib.error import HTTPError, URLError

API_URL = "https://sapi.xt.com/v4/public/ticker"


def get_ticker(symbol: str) -> dict:
    query = urlencode({"symbol": symbol.lower()})
    request = Request(
        f"{API_URL}?{query}",
        headers={"User-Agent": "xt-market-data-python/1.0"},
    )

    with urlopen(request, timeout=10) as response:
        return json.load(response)


def main():
    symbol = sys.argv[1] if len(sys.argv) > 1 else "btc_usdt"

    try:
        ticker = get_ticker(symbol)
        print(json.dumps(ticker, indent=2))
    except (HTTPError, URLError, TimeoutError) as error:
        print(f"Unable to retrieve ticker data: {error}")
        sys.exit(1)


if __name__ == "__main__":
    main()

Enter fullscreen mode Exit fullscreen mode

執行腳本

本專案需要 Python 3.9 或更新版本。由於使用 Python 標準函式庫中的模組，因此不需要額外相依套件。

使用以下指令執行腳本：

python xt_ticker.py btc_usdt

Enter fullscreen mode Exit fullscreen mode

若要請求其他交易對，請替換 symbol：

python xt_ticker.py eth_usdt

Enter fullscreen mode Exit fullscreen mode

若未提供 symbol，腳本預設使用 btc_usdt。

運作原理

urlencode() 函式會將所選 symbol 轉換為有效的查詢參數。程式隨後向此公開端點發送 GET 請求：

https://sapi.xt.com/v4/public/ticker?symbol=btc_usdt

Enter fullscreen mode Exit fullscreen mode

回傳的 JSON 會被轉換為 Python 字典，並以易讀格式印出。

交易對通常包含一個基礎資產與一個報價資產。例如在 btc_usdt 中，BTC 是基礎資產，USDT 是報價資產。這份獨立的 XT.com 現貨交易指南 以非技術性方式說明交易對、現貨委託，以及一般交易流程。

錯誤處理

逾時機制可防止應用程式在網路或 API 無法使用時無限等待。腳本同時捕捉基本的 HTTP 與連線錯誤，並回傳易讀的錯誤訊息。

正式版本可額外加入：

  • 自動重試
  • 回應驗證
  • 請求記錄
  • 本地快取
  • 速率限制處理
  • 多交易對支援

可能的專案構想

此範例可擴展為：

  • 加密貨幣價格儀表板
  • 終端機式市場監控器
  • 交易對比較工具
  • 歷史資料收集器
  • 價格警示應用程式
  • 投資組合研究筆記本

若您正在建立投資組合追蹤器，最終可能希望同時記錄存入與提領，以及市場價格。這份 XT.com 提領指南 從使用者角度說明提領網路、手續費、限額，以及常見的轉帳錯誤。

安全性說明

公開市場端點不需要私密憑證。若日後您加入需驗證的帳戶或交易功能，切勿將 API 金鑰直接放在程式碼或公開的 GitHub 儲存庫中。

請將敏感憑證儲存在受保護的環境變數中，並盡可能限制 API 金鑰的權限。

其他資源

端點參數與回應細節可參閱 XT.com 官方行情 API 文件。

結論

公開行情端點是使用加密貨幣市場資料進行實驗的簡單起點。只需幾行 Python 程式碼，您就能取得公開資訊，並以此作為進階研究或儀表板專案的基礎。