القائمة
Use when working with Polymarket API - profiles, activities, events, markets endpoints
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
通用代码质量检查，包括语法错误、TypeScript 类型检查和 Prettier 代码美化。在提交代码前、完成功能开发后、或用户要求检查代码质量时使用。
Use when designing data structures, database schemas, state management, or data relationships - covers single source of truth, complete data flow thinking
开发环境部署到生产环境前的验证清单与最佳实践，重点关注 Monorepo 依赖管理与环境一致性。
Use when integrating with external APIs, third-party SDKs, or libraries - covers verification workflow before writing any integration code
Implements filterable, paginated list pages with URL as single source of truth (nuqs) and TanStack Query to avoid duplicate requests and support shareable links. Use when building list pages with filters, pagination, URL-synced state, or when fixing multiple requests on page change.
规范 Polymarket 的 Privy + Safe + Builder + CLOB 集成流程，覆盖新老用户分支、三次签名、授权批处理、安全边界与排障步骤。Use when implementing or debugging Privy embedded wallet, Safe deployment, builder relayer, remote signing, CLOB api credentials, token approvals, or builder attribution order flow.
| name | polymarket-api |
| description | Use when working with Polymarket API - profiles, activities, events, markets endpoints |
Polymarket API 的对接指南，包含各接口的地址和关键注意事项。
对接前必读： 请先阅读 external-integration skill，遵循标准对接流程。
| 接口 | 用途 | 文档 |
|---|---|---|
| CLOB 认证 | L2 API 认证（HMAC 签名） | clob-authentication.md |
| Profile | 获取用户信息 | profiles-api.md |
| Activities | 获取交易活动 | activities-api.md |
| Events | 获取事件信息 | events-api.md |
API 中的时间戳都是秒级，不是毫秒级：
// ❌ 响应中的时间戳转换
new Date(activity.timestamp)
// ✅ 需要乘以 1000
new Date(activity.timestamp * 1000)
// ❌ 请求中的时间戳
const ts = Date.now();
// ✅ 需要除以 1000
const ts = Math.floor(Date.now() / 1000);
详见 clob-authentication.md，这是常见的间歇性失败原因。
// API 返回小写，数据库要求大写
const side = raw.side.toUpperCase() as 'BUY' | 'SELL'
特别是 address 字段，API 可能返回空值，应使用 proxy_wallet 作为主键。
polymarket_user_profiles (码表)
└── proxy_wallet (主键)
activities
├── proxy_wallet → profiles.proxy_wallet
└── event_slug → events.slug
events (码表)
└── markets[] (嵌套)
注意： activities 中的 event_slug 可能在 events 表中不存在（未同步），需要处理降级显示。