The journey at a glance
Funding is coming soon. The mechanics for funding participant trading accounts are being finalized — see Funding.
What you’ll build
A complete partner integration has a handful of components. You can build them incrementally in the order below.| Component | Purpose | Primary interface |
|---|---|---|
| Auth client | Authenticate as your Firm and refresh access tokens | Private Key JWT |
| KYC flow | Onboard and verify Retail Participants | KYC |
| Order entry | Submit, modify, and cancel orders on behalf of participants | Trading API |
| Funding | Fund participant trading accounts | Funding (coming soon) |
| Stream consumers | Maintain a live mirror of orders, positions, and balances | gRPC streaming |
| Webhook receiver | Receive KYC and account lifecycle notifications | Account notifications (coming soon) |
Polymarket US is a streaming-first platform. REST endpoints are intended for one-off queries and are rate-limited; continuous data should come from streams. Keep this in mind as you design every component above.
Recommended reading order
Understand the platform and your role
Start with Your Role and the Platform Model. Keep the Glossary open in a tab.
Understand funding
The mechanics for funding participant trading accounts are coming soon — see Funding. Contact your Polymarket US integration lead to discuss funding for your integration.
Get connected
Complete partner onboarding, then set up authentication. Confirm you can call
GET /v1/whoami successfully.Onboard your participants
Implement the KYC flow. You collect each participant’s required information and submit it; Polymarket US performs the verification and decision. On approval, the Retail Participant and their account are provisioned automatically. See Onboard Participants.
Place your first order
Walk through the Quickstart to authenticate, list instruments, and place and cancel an order end to end.
Monitor and reconcile
Subscribe to the order, position, and balance streams and maintain a local mirror. Add a webhook receiver for KYC and account lifecycle events.
Start here
Your Role
What you do, what we do, and what you never handle.
Platform Model
DCM + DCO and the entities you act on.
Authentication
Authenticate as your Firm with Private Key JWT.
Quickstart
Place your first order end to end.