Polymarket 接入文档

友商接入（服务端签名 · 三请求头）

流程图（总览）

时序图

服务端验签（Polymarket 内部）

签名规范与多语言示例

与后端 internal/partnerauth.SignedMessage 一致：待签内容为 APPID + "\n" + 用户 ID 的 UTF-8 字节。 从 sk_ 解析 32 字节 seed → ed25519.NewKeyFromSeed（Go）或等价 API。

请求头

Go

package main

import (
  "crypto/ed25519"
  "encoding/base64"
  "strings"
)

func main() {
  appID := "<你的 APPID>"
  uid := "user_123"
  appSecret := "sk_..." // sk_ + base64url(32-byte seed)
  seed, _ := base64.RawURLEncoding.DecodeString(strings.TrimPrefix(appSecret, "sk_"))
  priv := ed25519.NewKeyFromSeed(seed)
  msg := []byte(appID + "\n" + uid)
  sig := ed25519.Sign(priv, msg)
  sigB64 := base64.RawURLEncoding.EncodeToString(sig)
  _ = sigB64
}

Node.js（@noble/ed25519）

import { sign } from '@noble/ed25519';

const appId = '<你的 APPID>';
const uid = 'user_123';
const seed = Uint8Array.from(Buffer.from('sk_....'.slice(3), 'base64url'));
const msg = new TextEncoder().encode(`${appId}\n${uid}`);
const sig = await sign(msg, seed);
const sigB64 = Buffer.from(sig).toString('base64url');

Python 3

import base64
from cryptography.hazmat.primitives.asymmetric.ed25519 import Ed25519PrivateKey

app_id = "<你的 APPID>"
uid = "user_123"
app_secret = "sk_..."  # sk_ + base64url seed
seed = base64.urlsafe_b64decode(app_secret.removeprefix("sk_") + "==")[:32]
priv = Ed25519PrivateKey.from_private_bytes(seed)
msg = f"{app_id}\n{uid}".encode("utf-8")
sig_b64 = base64.urlsafe_b64encode(priv.sign(msg)).decode().rstrip("=")
print(sig_b64)

Java（JDK Ed25519）

// 伪代码：Base64URL 解码 sk_ 去掉前缀得 32B seed → Ed25519PrivateKey
// 对 UTF-8(APPID + "\n" + 用户ID) 签名 → Base64URL 无填充 → X-Signature

测试向量（可复现）

由仓库 go run ./scripts/gen_partner_signature_vectors 生成。

📈 交易流程

① 获取市场列表

GET /markets?status=ACTIVE
// status 可选：PENDING | ACTIVE | PAUSED | SETTLED

② 试算（强烈建议先 preview）

POST /trades/preview
X-App-Id: <APPID>
X-Uid: <商户用户ID>
X-Signature: <base64url Ed25519>
# 或使用管理站：Authorization: Bearer <HS256>

{
  "marketId": "市场UUID",
  "side": "YES",      // YES 或 NO
  "tickets": 10       // 购买票数
}

// 响应
{
  "currentPrice": 0.5,
  "netCost": 5.25,       // 实际扣款（含5%手续费）
  "priceImpact": 0.002,  // 价格影响
  "newYesPrice": 0.502,
  "maxTickets": 490
}

③ 正式下单

POST /trades/buy
X-App-Id: <APPID>
X-Uid: <商户用户ID>
X-Signature: <base64url Ed25519>
# 或 Authorization: Bearer <HS256>

{
  "marketId": "市场UUID",
  "side": "YES",
  "tickets": 10
}

// 响应
{
  "trade": {
    "id": "交易UUID",
    "netCost": "5.25",
    "tickets": "10",
    "side": "YES"
  },
  "newBalance": 994.75,
  "yesPrice": 0.502,
  "noPrice": 0.498
}

🔌 WebSocket 实时推送

连接端点

wss://polymarket.gzshujiu.com/api/ws

最小接入示例（浏览器）

const ws = new WebSocket('wss://polymarket.gzshujiu.com/api/ws');

ws.addEventListener('open', () => {
  // 订阅指定市场
  ws.send(JSON.stringify({
    type: 'subscribe_market',
    marketId: '市场UUID'
  }));
  // 同时订阅 BTC 实时价格
  ws.send(JSON.stringify({ type: 'subscribe_btc' }));
});

ws.addEventListener('message', (ev) => {
  const msg = JSON.parse(ev.data);
  switch (msg.type) {
    case 'price_update':
      // { yesPrice, noPrice, yesPool, noPool, maxYesTickets, maxNoTickets }
      updatePriceDisplay(msg);
      break;
    case 'trade_feed':
      // { side, tickets, price, grossCost, timestamp }
      addTradeToFeed(msg);
      break;
    case 'market_settled':
      // { marketId, result: 'YES'|'NO', totalPayout }
      showSettlementResult(msg);
      break;
    case 'btc_price':
      // { price, timestamp }
      updateBtcBanner(msg);
      break;
  }
});

// 心跳保活（每25秒）
setInterval(() => ws.send(JSON.stringify({ type: 'ping' })), 25000);

全部客户端消息类型

📊 市场状态与生命周期

状态说明

⚠️ 错误码速查