The Polymarket Exchange API is available in three environments. Use the appropriate endpoints based on your integration stage.
Endpoints
| Environment | Purpose | REST API | gRPC | Auth Domain |
|---|
| Dev | Development and testing | https://api.dev01.polymarketexchange.com | grpc-dev01.polymarketexchange.com:443 | pmx-dev01.us.auth0.com |
| Preprod | Pre-production validation | https://api.preprod.polymarketexchange.com | grpc-preprod.polymarketexchange.com:443 | pmx-preprod.us.auth0.com |
| Prod | Production trading | https://api.prod.polymarketexchange.com | grpc-prod.polymarketexchange.com:443 | pmx-prod.us.auth0.com |
API Path Patterns
| API Type | Path Pattern | Example |
|---|
| REST endpoints | /v1/{service}/{operation} | /v1/trading/orders |
| Health check | /v1/health | GET /v1/health |
| Auth token | /oauth/token | POST https://pmx-preprod.us.auth0.com/oauth/token |
Authentication
| Environment | Token URL |
|---|
| Dev | https://pmx-dev01.us.auth0.com/oauth/token |
| Preprod | https://pmx-preprod.us.auth0.com/oauth/token |
| Prod | https://pmx-prod.us.auth0.com/oauth/token |
Tokens must be refreshed every 3 minutes across all environments.
Health Check
All environments expose the same health check endpoint:
curl https://api.dev01.polymarketexchange.com/v1/health
{
"status": "SERVING",
"version": "1.0.0"
}
AWS PrivateLink Connection
VPC connections are required only for FIX API access. REST and gRPC APIs use the public endpoints listed above and do not require VPC setup.
Environment Progression
We recommend the following integration progression:
- Dev - Initial development and unit testing
- Preprod - Integration testing and pre-launch validation
- Prod - Live trading
