跳转到主要内容
Builder API keys 用于验证你的应用程序与 Polymarket relayer 的连接,并启用订单归因。你需要这些凭证来访问免 Gas 交易和追踪交易量。

访问你的 Builder 个人资料

2

从菜单进入

点击你的头像 → 选择 “Builders”

创建 API Keys

在你个人资料的 Builder Keys 部分:
  1. 点击 ”+ Create New” 生成新的 API key
  2. 立即复制全部三个值 — secret 和 passphrase 只会显示一次
  3. 将它们安全地存储在你的密钥管理器或环境变量中
每个 API key 包含三个组成部分:
ComponentDescriptionExample
key你的 builder 账户的公开标识符abc123-def456-...
secret用于签名请求的密钥base64-encoded-secret
passphrase额外的身份验证值your-passphrase
secretpassphrase 只在创建时显示一次。如果你丢失了它们,需要生成新的 key。

管理 Keys

为不同环境创建独立的 keys:
EnvironmentPurpose
Development测试和本地开发
Staging预生产环境测试
Production实盘交易

个人资料设置

你的 builder 个人资料包含可自定义的设置:
SettingDescription
Profile Picture显示在 Builder Leaderboard
Builder Name排行榜上显示的公开名称
Builder Address你的唯一 builder 标识符(只读)
Current Tier你的速率限制等级: Unverified、Verified 或 Partner

环境变量

将你的凭证存储为环境变量:
.env
POLY_BUILDER_API_KEY=your-api-key
POLY_BUILDER_SECRET=your-secret
POLY_BUILDER_PASSPHRASE=your-passphrase

安全最佳实践

PracticeDescription
绝不提交凭证使用 .gitignore 排除 .env 文件
使用环境变量从环境变量加载凭证,而不是硬编码字符串
使用密钥管理器生产环境使用 AWS Secrets Manager、HashiCorp Vault 等
分离环境为开发、预发布和生产环境使用不同的 keys
监控使用情况检查排行榜是否有异常的交易量变化
绝不要在客户端代码中暴露 Builder API 凭证。 你的 secret 和 passphrase 必须保留在服务器端。

故障排查

原因: 你已超出所在等级的每日交易限制。解决方案:
原因: secret 和 passphrase 只在创建时显示一次。解决方案: 创建新的 API key。你无法恢复原始值。

后续步骤