Partner Guide
This guide is for partners building retail trading platforms on top of Polymarket US. If you’re building a platform that onboards end-users for trading, this section is for you.What is a Partner?A partner builds a consumer-facing trading application. Partners manage their own users, handle KYC verification, process deposits and withdrawals, and execute trades on behalf of their customers.
Before You Start
Onboarding
Generate your API keys, share your public key with Polymarket, and complete the verification process to receive your credentials.
Partner Types
Polymarket US supports two types of partners:| Partner Type | Description | APIs Used |
|---|---|---|
| Direct Trading | Institutional or proprietary traders who trade their own capital | Trading APIs only |
| Retail Partner | Retail platforms onboarding end-users | Trading APIs + Partner APIs |
User Lifecycle
Partners manage the complete user lifecycle from KYC verification to trading:Automatic User CreationUsers are created automatically when KYC verification is approved. There is no separate account creation step - the system provisions EP3 trading resources as part of the KYC approval process.
1. Identity Verification (KYC)
Start by verifying user identity. When approved, the user is automatically provisioned for trading.- API: KYC API
- Key endpoint:
POST /v1/kyc/start
2. Funding
Link bank accounts or cards and process deposits.- API: Payments API
- Guides: Aeropay (ACH) | Checkout (Cards)
- Key endpoints:
POST /v1/aeropay/initialize- Link bank accountPOST /v1/checkout/deposits- Process card deposit
3. Trading
Once funded, users can place orders.- API: Trading API
- Key endpoints:
POST /v1/trading/orders- Insert orderPOST /v1/trading/orders/cancel- Cancel order
4. Positions & Withdrawals
Track positions and process withdrawals (following FIFO rules).- API: Positions API | Funding Management
- Key endpoints:
GET /v1/positions- Get positionsPOST /v1/aeropay/withdrawals- Process withdrawal
Complete Onboarding Flow
Getting Started
Users API
List and manage users
KYC Verification
Identity verification workflow
Payments
Bank and card payment processing
Referral Codes
Track user acquisition

