Polymarket pUSD 迁移指南：USDC.e 到 pUSD（2026年4月）

第 36 章，共 36 章

简版

在 2026 年 4 月 28 日，Polymarket 将其在 Polygon 上的结算抵押品从 USDC.e（桥接版 USDC 代币，合约 0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174）迁移到了 pUSD，这是一种由 Polymarket 发行、可按 1:1 比例兑换为原生 USDC 的稳定币。网页端交易者无需做任何操作 - 余额和持仓会在快照区块自动转换。API 和机器人运维者必须更新：每个 CLOB 订单签名中的抵押品资产地址都已更改，使用旧 USDC.e 签名的订单已被取消，并且需要 py-clob-client 0.40 或更新版本。本指南将逐步说明保持机器人在切换期间及切换后继续运行所需的确切代码、合约和授权变更。

第1部分：三种稳定币，一个 Polygon

在迁移之前，Polymarket 在 Polygon 上的生态中存在三种美元稳定币。了解它们之间的差异，是理解 Polymarket 为什么更换平台的第一步。

Polymarket 最初选择 USDC.e，是因为它在 2020 年上线时是 Polygon 上占主导地位的 USDC 版本。Circle 后来直接在 Polygon 上发行了原生 USDC，并暗示最终会弃用桥接版本。继续用 USDC.e 结算每个市场，使 Polymarket 面临桥接通道突然退场的长期尾部风险。迁移到由 Polymarket 控制的稳定币可以解决这一问题，并解锁未来的产品功能（例如永续合约保证金、金库存款、跨链收据），这些功能都共享同一计价单位。

第 2 部分：pUSD 是什么（以及不是什么）

pUSD 是一种标准的Polygon 上的 ERC-20 代币（chain id 137），拥有 6 位小数，精度与 USDC 相同。它只能由 Polymarket Treasury 合约铸造，并可随时按 1:1 比例兑换为原生 USDC，兑换不收取费用（但仍需支付网络 Gas 费）。支持 pUSD 的储备金存放在隔离账户中，并通过第三方证明按月披露。

pUSD 不是 算法稳定币，也不是由加密资产超额抵押的代币，更不产生收益。如果你在 Polymarket 之外持有 pUSD，应将其视为 Polymarket 发行、可兑换为原生 USDC 的欠条 - 在平台内有用，可按需赎回，但长期持有在外部钱包中没有收益优势。

第 3 部分：Web 应用交易者看到的内容

如果你只通过 polymarket.com 进行交易，这次迁移是不可见的。在 2026 年 4 月 28 日的快照区块时：

• Polymarket 代理钱包中持有的每一笔 USDC.e 余额都以 1:1 原子式转换为 pUSD。
• 未平仓头寸保持相同的美元价值、相同的结果赔率和相同的到期时间。条件代币 ID 没有变化。
• 以 USDC.e 计价的挂单在快照时被取消。迁移后的新订单会自动以 pUSD 签名。
• 向外部钱包的提现从发送 USDC.e 改为发送 原生 USDC（或按要求发送原始 pUSD - 大多数用户不需要这样做）。

无需任何签名、交易或设置更改。对你有影响的挂限价单应在迁移后手动重新挂出；取消只是一次性事件。

第 4 部分：API 和机器人运营者 - 关键变更

如果你不采取行动，这一部分会让机器人失效。

升级 py-clob-client

Polymarket 在切换前两周发布了 py-clob-client 0.40.0，完整支持 pUSD。0.34.x 版本线在迁移次日已退役。

# 升级到支持 pUSD 的版本
pip install --upgrade "py-clob-client>=0.40.0"

# 验证已接入的抵押资产
python -c "from py_clob_client.constants import POLYGON; \
print('pUSD address:', POLYGON.get('collateral'))"

新的 SDK 会在启动时从链配置中读取抵押资产地址，因此你无需硬编码任何内容。如果你分叉过或锁定了较旧版本，最稳妥的做法是删除 lockfile，使用最新的 constants 模块重新安装，然后重新运行测试套件。

重新批准授权额度

你的 Polymarket 代理钱包需要从 你的交易账户 -> CTF Exchange 合约 获得 pUSD 代币的 ERC-20 授权额度。USDC.e 的旧授权额度虽然仍在链上，但完全没用了: CLOB 不会消耗它。没有新的 pUSD 授权额度，每个订单都会返回 "INSUFFICIENT_ALLOWANCE"。

from py_clob_client.client import ClobClient

client = ClobClient(
    host="https://clob.polymarket.com",
    chain_id=137,
    key=os.environ["POLY_PRIVATE_KEY"],
    funder=os.environ["POLY_FUNDER"],
    signature_type=1,  # Magic-link 账户使用 POLY_PROXY
)
client.set_api_creds(client.create_or_derive_api_creds())

# 仅需一次: 为 CTF Exchange 合约批准 pUSD
# (帮助函数已在 py-clob-client 0.40 中加入)
client.update_balance_allowance(asset_type="COLLATERAL")

刷新 API 凭据

现有 API 密钥仍可继续使用，但如果你在 4 月 1 日之前派生过凭据，出于谨慎应当轮换它们: 现在 L1 ECDSA 签名绑定到一个包含新抵押资产地址的域。最简单的路径:

creds = client.create_or_derive_api_creds()  # 幂等地重新派生
client.set_api_creds(creds)

# 持久化到你的 .env
print(creds.api_key, creds.api_secret, creds.api_passphrase)

第 5 部分：迁移后验证你的机器人

在让任何仓位管理逻辑真正使用真钱之前，先运行这个最小烟雾测试：

# 1. 在代理钱包上确认 pUSD 余额
from py_clob_client.client import ClobClient
client = ClobClient(...)  # 如上
balance = client.get_balance_allowance(params={"asset_type": "COLLATERAL"})
print("pUSD 余额（原始值）：", balance["balance"])
print("交易所授权额度：", balance["allowance"])

# 2. 下一个远离最优买卖价的 1 美元限价单
from py_clob_client.clob_types import OrderArgs
order = client.create_order(OrderArgs(
    token_id=test_token_id,
    price=0.05,        # 距离市场很远
    size=20,           # 以 $0.05 计的 $1 名义价值
    side="BUY",
))
resp = client.post_order(order)
print(resp)

# 3. 取消并确认
client.cancel(order_id=resp["orderID"])

如果这三次调用都成功，说明你的连接是正常的: SDK 使用 pUSD 进行了签名，授权额度已被识别，订单账本也一致。然后再逐步提高规模。

第 6 部分：常见错误与修复

第 7 部分：条件代币、订单 ID，以及其他没有发生变化的东西

为了让重构范围保持诚实，以下是迁移过程中保持稳定的标识符列表：

• 条件代币合约（CTF）：地址完全相同。你的 YES / NO ERC-1155 仓位未受影响。
• condition_id 和 question_id：由市场参数确定性生成；不受抵押品切换影响。
• token_id（结果）：由 condition_id + 结果索引派生；保持不变。
• Polymarket 代理钱包地址：地址相同；仍是相同的 Gnosis Safe 风格代码。
• API key、API secret、API passphrase：仍然有效（建议轮换；非必需）。
• WebSocket schema：完全相同；新的 asset 字段在成交事件中读取为 "pUSD"，而不是 "USDC.e"。
• Gamma 和 Data API：无需认证，且未发生变化。它们从未直接引用抵押品代币。

第 8 部分：税务和记账影响

对于大多数司法管辖区而言，USDC.e 自动转换为 pUSD 属于USD 锚定稳定币按 1:1 比例的同类兑换，不会产生应税事件。你的成本基础和持有期限会延续。

不过，有两项记账事项值得注意：

1. 更新你的账本架构。 任何按 USDC.e 合约筛选 Polygon 交易的税务工具、SQLite 账本或会计导出，都会悄然漏掉迁移后的每一笔交易。请将 pUSD 合约地址添加为别名。
2. 为快照转换添加注释。 即使在大多数制度下它不征税，也请在记录中明确记载这次转换：金额、区块、时间戳，以及注明这是一次 1:1 稳定币迁移。如果你的司法管辖区日后进行核查，你会希望有一条清晰的审计轨迹。

以色列交易者应查阅税务指南，了解 ITA 相关申报要求；此次迁移本身不会改变标准处理方式，但合约地址变更会影响自动化申报工具。

第 9 部分：来自亲历切换的运营者的专业建议

接下来是什么？

• Polymarket API 指南 - 面向 pUSD 更新后的完整 API 指南
• 充值指南 - 在应用内存入 USDC 并接收 pUSD
• 提现指南 - 将 pUSD 作为原生 USDC 提现到外部钱包
• 工具与资源 - 已更新为支持 pUSD 的第三方仪表板
• 术语表 - 本文所用每个术语的通俗英文定义