如何用加密货币行情 API 获取币种 24 小时涨跌幅（Python 实战手记）

一、前言

在做金融量化、行情监控类小项目时，24 小时涨跌幅是最核心的参考指标之一。起初我都是手动刷新页面查看数据，效率很低，于是尝试通过加密货币行情 API 自动拉取、计算涨跌幅。本文结合实操经验，分享完整实现思路、接口接入、代码编写以及踩坑解决方案，适合新手开发者、量化入门同学参考学习。

二、涨跌幅计算逻辑

很多人会误以为涨跌幅 = 最新价 - 前一日收盘价，目前主流行情 API 并非采用该口径。行业通用计算规则：24小时涨跌幅=24小时开盘价最新成交价−24小时开盘价×100%简单理解：以24 小时开盘价为基准，结合实时最新成交价，计算区间涨跌比例，能够客观反映单日价格波动。

核心字段说明

三、接口选型与接入规范

本次使用 AllTick 金融行情 API，该接口覆盖加密货币、外汇、股票等多类标的，同时支持 WebSocket 和 REST 两种调用方式。考虑到加密货币价格波动快、对实时性要求高，优先选择 WebSocket 长连接，相比轮询 REST 接口，请求更少、延迟更低，也更适合同时监控多个币种。

加密货币标准 WebSocket 访问地址：wss://quote.alltick.co/quote-b-ws-api?token=YOUR_TOKEN

接入要求：连接成功后，需按照官方规范发送订阅指令，指令固定使用 cmd_id=22004，通过 code 字段指定需要监听的交易对。

四、完整 Python 实战代码

下面是可直接运行的代码，包含连接回调、异常捕获、心跳保活、自动重连、数据节流等生产常用能力，新手可直接替换 Token 测试。

# 端点 / 订阅格式：AllTick 官方 API Docs
# https://en.apis.alltick.co/websocket-api/quote-b-ws-api/
import websocket
import json
import time
import random

# 请替换为你自己的有效Token
ACCESS_TOKEN = "YOUR_TOKEN"
# 官方标准WebSocket地址
WS_URL = f"wss://quote.alltick.co/quote-b-ws-api?token={ACCESS_TOKEN}"
# 本地缓存：用于数据节流，避免频繁重复计算
tick_cache = {}

def on_open(ws):
    """连接成功回调：发送币种订阅指令"""
    print("WebSocket连接成功，开始订阅加密货币行情")
    # 遵循官方订阅帧格式
    sub_frame = {
        "cmd_id": 22004,
        "seq_id": random.randint(1000, 9999),
        "trace": "crypto_tick_subscribe",
        "data": {
            "symbol_list": [
                {"code": "BTCUSDT"},
                {"code": "ETHUSDT"}
            ]
        }
    }
    ws.send(json.dumps(sub_frame))

def on_message(ws, message):
    """接收行情数据，计算24小时涨跌幅"""
    global tick_cache
    try:
        data = json.loads(message)
        symbol = data.get("symbol")
        price = data.get("price")
        open_24h = data.get("open_24h")

        # 过滤空值、0值等无效数据
        if not all([symbol, price, open_24h]) or float(open_24h) == 0:
            return

        current_ts = time.time()
        # 节流控制：同一币种每秒只更新一次结果
        if symbol in tick_cache and current_ts - tick_cache[symbol]["ts"] < 1:
            return

        # 更新缓存数据
        tick_cache[symbol] = {
            "price": price,
            "open_24h": open_24h,
            "ts": current_ts
        }

        # 计算涨跌幅
        price_float = float(price)
        open_float = float(open_24h)
        change_rate = (price_float - open_float) / open_float * 100
        print(f"交易对：{symbol} | 最新价：{price_float:.4f} | 24小时涨跌幅：{change_rate:.2f}%")
    except Exception as e:
        print(f"数据解析异常：{str(e)}")

def on_error(ws, error):
    """捕获连接运行异常"""
    print(f"WebSocket运行异常：{str(error)}")

def on_close(ws, close_status_code, close_msg):
    """监听连接断开事件"""
    print(f"连接已断开，状态码：{close_status_code}，提示：{close_msg}")

if __name__ == "__main__":
    # 初始化WebSocket客户端
    ws_app = websocket.WebSocketApp(
        WS_URL,
        on_open=on_open,
        on_message=on_message,
        on_error=on_error,
        on_close=on_close
    )

    # 心跳保活+自动重连：心跳10秒，超时30秒，断连3秒后重试
    while True:
        ws_app.run_forever(ping_interval=10, ping_timeout=30)
        print("准备重新连接...")
        time.sleep(3)

五、开发踩坑记录 & 问题解决方案

在调试和运行代码的过程中，我遇到了不少典型问题，整理成故障清单，方便大家避坑：

1. 问题：接口返回 price、open_24h 为空、None 或数值为 0排查方式：读取字段后增加非空判断、除数为零校验解决办法：直接跳过异常数据，仅打印日志，不执行涨跌幅计算

2. 问题：网络波动、接口限制导致 WebSocket 频繁断连排查方式：监听 on_close、on_error 回调，识别连接异常解决办法：启用心跳机制保活，连接断开后延迟 3 秒自动重连

3. 问题：低价币种出现浮点计算偏差，涨跌幅展示不准排查方式：截取多组连续数据交叉核对计算结果解决办法：统一转为浮点型计算，输出结果固定保留两位小数

4. 问题：行情高频推送，重复计算造成资源浪费排查方式：统计单币种单位时间内的数据更新次数解决办法：基于时间戳做节流，限制单个币种每秒仅运算一次

六、功能边界总结

这套代码仅用于加密货币行情数据读取与涨跌幅计算，可以实现单币种、多币种实时监控；不支持交易下单、历史全量 Tick 数据回溯功能，运行效果会受本地网络、第三方接口服务状态影响。

七、学习总结

对比传统 REST 轮询方式，WebSocket 长连接在实时行情场景下优势明显，尤其适合批量监控多个币种。整个开发流程可以总结为：理清计算公式 → 熟悉接口规范 → 编写基础代码 → 补充异常处理与优化。

对于编程初学者来说，本次案例既能练习 WebSocket 网络编程、JSON 数据解析，也能理解金融行情数据的基本逻辑，是非常不错的综合练手项目。

参考文档

参考文档：https://apis.alltick.co/
GitHub：https://github.com/alltick/alltick-realtime-forex-crypto-stock-tick-finance-websocket-api