Petrovich Penki

公开的加密货币市场 API 可用于构建价格跟踪器、研究工具、仪表板和交易实验。在本教程中，我们将使用 Python 在无需 API 密钥或外部包的情况下检索 XT.com 现货市场行情数据。

本实验是在研究该交易所并为 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

要请求其他交易对，请替换符号：

python xt_ticker.py eth_usdt

Enter fullscreen mode Exit fullscreen mode

如果未提供符号，脚本将默认使用 btc_usdt。

工作原理

urlencode() 函数将所选符号转换为有效的查询参数。程序随后向此公共端点发送 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 代码，您就可以检索公开信息，并将其用作更高级研究或仪表板项目的基础。