Skip to main content
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.
EnvironmentREST APIgRPCAuth DomainAudience
Devhttps://api.dev01.polymarketexchange.comgrpc-dev01.polymarketexchange.com:443pmx-dev01.us.auth0.comhttps://api.dev01.polymarketexchange.com
Preprodhttps://api.preprod.polymarketexchange.comgrpc-preprod.polymarketexchange.com:443pmx-preprod.us.auth0.comhttps://api.preprod.polymarketexchange.com
Prodhttps://api.prod.polymarketexchange.comgrpc-prod.polymarketexchange.com:443pmx-prod.us.auth0.comhttps://api.prod.polymarketexchange.com

API Path Patterns

API TypePath PatternExample
REST endpoints/v1/{service}/{operation}/v1/trading/orders
Health check/v1/healthGET /v1/health
Auth token/oauth/tokenPOST https://pmx-preprod.us.auth0.com/oauth/token

Environment Summary

EnvironmentPurposeAuth Domain
DevDevelopment and testingpmx-dev01.us.auth0.com
PreprodPre-production validationpmx-preprod.us.auth0.com
ProdProduction tradingpmx-prod.us.auth0.com

Dev Environment

Development environment for initial integration and testing.
ServiceEndpoint
REST APIhttps://api.dev01.polymarketexchange.com
gRPCgrpc-dev01.polymarketexchange.com:443
Auth Domainpmx-dev01.us.auth0.com
Audiencehttps://api.dev01.polymarketexchange.com

Dev Health Check

Click to check dev environment health

Preprod Environment

Pre-production environment for final validation before going live.
ServiceEndpoint
REST APIhttps://api.preprod.polymarketexchange.com
gRPCgrpc-preprod.polymarketexchange.com:443
Auth Domainpmx-preprod.us.auth0.com
Audiencehttps://api.preprod.polymarketexchange.com

Preprod Health Check

Click to check preprod environment health

Production Environment

Live production environment for real trading.
ServiceEndpoint
REST APIhttps://api.prod.polymarketexchange.com
gRPCgrpc-prod.polymarketexchange.com:443
Auth Domainpmx-prod.us.auth0.com
Audiencehttps://api.prod.polymarketexchange.com

Health Check Endpoint

All environments expose the same health check endpoint:
GET /v1/health

Example Request

curl https://api.dev01.polymarketexchange.com/v1/health

Example Response

{
  "status": "SERVING",
  "version": "1.0.0"
}

Quick Reference

REST API Base URLs

EnvironmentBase URL
Devhttps://api.dev01.polymarketexchange.com
Preprodhttps://api.preprod.polymarketexchange.com
Prodhttps://api.prod.polymarketexchange.com

gRPC Endpoints

EnvironmentEndpoint
Devgrpc-dev01.polymarketexchange.com:443
Preprodgrpc-preprod.polymarketexchange.com:443
Prodgrpc-prod.polymarketexchange.com:443

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.
EnvironmentPrivateLink DNS
Preprodtraderapi.us-east-1.privatelink.preprod.polymarketexchange.com
Prodtraderapi.us-east-1.privatelink.prod.polymarketexchange.com
ProtocolPort
FIX API443
The PrivateLink connection is used exclusively for FIX API access. The load balancer terminates TLS on port 443.

Setup Requirements

  1. Allowlist your AWS account - Contact support to allowlist your AWS Account ID
  2. Create VPC Endpoint - Use the VPC Service Name for your environment
  3. Wait for approval - Polymarket DevOps will approve the connection request
  4. Configure DNS - Enable Private DNS or create CNAME aliases

VPC Service Names

EnvironmentVPC Service Name
Preprodcom.amazonaws.vpce.us-east-1.vpce-svc-0ab4dc57271d74d3e
Prodcom.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

EnvironmentToken URL
Devhttps://pmx-dev01.us.auth0.com/oauth/token
Preprodhttps://pmx-preprod.us.auth0.com/oauth/token
Prodhttps://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:
  1. Dev - Initial development and unit testing
  2. Preprod - Integration testing and pre-launch validation
  3. Prod - Live trading
Contact onboarding@qcex.com to request access credentials for each environment.