The Polymarket Exchange API is available in three environments. Use the appropriate endpoints based on your integration stage.
Complete Endpoint Reference
This is the single source of truth for all API endpoints. Bookmark this page for quick reference.
Environment REST API gRPC Auth Domain Audience Dev https://api.dev01.polymarketexchange.comgrpc-dev01.polymarketexchange.com:443pmx-dev01.us.auth0.comhttps://api.dev01.polymarketexchange.comPreprod https://api.preprod.polymarketexchange.comgrpc-preprod.polymarketexchange.com:443pmx-preprod.us.auth0.comhttps://api.preprod.polymarketexchange.comProd https://api.prod.polymarketexchange.comgrpc-prod.polymarketexchange.com:443pmx-prod.us.auth0.comhttps://api.prod.polymarketexchange.com
API Path Patterns
API Type Path Pattern Example REST endpoints /v1/{service}/{operation}/v1/trading/ordersHealth check /v1/healthGET /v1/healthAuth token /oauth/tokenPOST https://pmx-preprod.us.auth0.com/oauth/token
Environment Summary
Environment Purpose Auth Domain Dev Development and testing pmx-dev01.us.auth0.comPreprod Pre-production validation pmx-preprod.us.auth0.comProd Production trading pmx-prod.us.auth0.com
Dev Environment
Development environment for initial integration and testing.
Service Endpoint REST API https://api.dev01.polymarketexchange.comgRPC grpc-dev01.polymarketexchange.com:443Auth Domain pmx-dev01.us.auth0.comAudience https://api.dev01.polymarketexchange.com
Dev Health Check Click to check dev environment health
Preprod Environment
Pre-production environment for final validation before going live.
Service Endpoint REST API https://api.preprod.polymarketexchange.comgRPC grpc-preprod.polymarketexchange.com:443Auth Domain pmx-preprod.us.auth0.comAudience https://api.preprod.polymarketexchange.com
Preprod Health Check Click to check preprod environment health
Production Environment
Live production environment for real trading.
Service Endpoint REST API https://api.prod.polymarketexchange.comgRPC grpc-prod.polymarketexchange.com:443Auth Domain pmx-prod.us.auth0.comAudience https://api.prod.polymarketexchange.com
Health Check Endpoint
All environments expose the same health check endpoint:
Example Request
curl https://api.dev01.polymarketexchange.com/v1/health
Example Response
{
"status" : "SERVING" ,
"version" : "1.0.0"
}
Quick Reference
REST API Base URLs
Environment Base URL Dev https://api.dev01.polymarketexchange.comPreprod https://api.preprod.polymarketexchange.comProd https://api.prod.polymarketexchange.com
gRPC Endpoints
Environment Endpoint Dev grpc-dev01.polymarketexchange.com:443Preprod grpc-preprod.polymarketexchange.com:443Prod grpc-prod.polymarketexchange.com:443
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.
For secure, private connectivity from your AWS VPC for the FIX API, use AWS PrivateLink. This routes traffic over AWS’s private network instead of the public internet.
PrivateLink Endpoints
Environment PrivateLink DNS Preprod traderapi.us-east-1.privatelink.preprod.polymarketexchange.comProd traderapi.us-east-1.privatelink.prod.polymarketexchange.com
PrivateLink Ports
The PrivateLink connection is used exclusively for FIX API access. The load balancer terminates TLS on port 443.
Setup Requirements
Allowlist your AWS account - Contact support to allowlist your AWS Account ID
Create VPC Endpoint - Use the VPC Service Name for your environment
Wait for approval - Polymarket DevOps will approve the connection request
Configure DNS - Enable Private DNS or create CNAME aliases
VPC Service Names
Environment VPC Service Name Preprod com.amazonaws.vpce.us-east-1.vpce-svc-0ab4dc57271d74d3eProd com.amazonaws.vpce.us-east-1.vpce-svc-0cb1220f882b3879e
Full PrivateLink Setup Guide Complete VPC connection instructions for FIX API including availability zones and troubleshooting
Authentication Endpoints
Environment Token URL Dev https://pmx-dev01.us.auth0.com/oauth/tokenPreprod https://pmx-preprod.us.auth0.com/oauth/tokenProd https://pmx-prod.us.auth0.com/oauth/token
Tokens must be refreshed every 3 minutes across all environments.
Environment Progression
We recommend the following integration progression:
Dev - Initial development and unit testing
Preprod - Integration testing and pre-launch validation
Prod - Live trading