Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.polymarket.us/llms.txt

Use this file to discover all available pages before exploring further.

​
Accounts API

The Accounts API provides user and account management capabilities for partners managing retail traders.
Partner APIThis API is primarily used by partners who are building trading platforms for retail users. Direct trading partners typically don’t need these endpoints.

​
Endpoints

MethodEndpointDescription
GET/v1/whoamiGet current user info
GET/v1/accountsList accounts
POST/v1/accountsCreate account
GET/v1/accounts/{id}Get account details

​
Account Hierarchy

Partner (Firm)
└── Users
    └── Accounts
        └── Positions & Orders
  • Firm: Your partner organization
  • Users: Individual retail traders on your platform
  • Accounts: Trading accounts belonging to users

​
User vs Account

EntityDescription
UserA person with identity (KYC verified)
AccountA trading account with balances and positions
A user can have multiple accounts (e.g., for different strategies or purposes).

​
Common Use Cases

  1. User onboarding - Create accounts for new users after KYC
  2. Account lookup - Get account details for display
  3. Multi-account management - List and manage user accounts