Participant lifecycle
When a Retail Participant completes KYC and is approved:- Polymarket US automatically provisions their trading identity (Participant).
- A trading account is created for them.
- They can then be funded and trade.
Terminology. These docs use Retail Participant for the end user. In API payloads the underlying field names use
user/users; treat those as the Retail Participant’s trading identity. See the Glossary.Resolve who you can act for
You discover the identities available to your Firm with three endpoints from the Accounts API. Each links to its full API reference below; the partner-specific usage is summarized here.
For the account and identity hierarchy and entitlements model, see Accounts & Identity.
In partner usage, the IDs returned by
GET /v1/users (for example, firms/your-firm/users/participant-123) are the values you place in the x-participant-id header to act on behalf of a specific Retail Participant.
Call
GET /v1/whoami and GET /v1/users after authenticating and before trading, so you use the correct participant and account IDs in subsequent requests.Participant vs Account
A Participant can have multiple accounts for different purposes (e.g., separate trading strategies).
Related guides
- Onboard Participants — How KYC creates the Participant and Account
- Accounts & Identity — The account and identity hierarchy
- KYC Verification — Identity verification (provisions participants automatically)
- Accounts — List trading accounts
- Funding — How participant trading is funded (coming soon)