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.

The Polymarket Exchange API is available in three environments. Use the appropriate endpoints based on your integration stage.

​
Endpoints

EnvironmentPurposeREST APIgRPCAuth Domain
DevDevelopment and testinghttps://api.dev01.polymarketexchange.comgrpc-dev01.polymarketexchange.com:443pmx-dev01.us.auth0.com
PreprodPre-production validationhttps://api.preprod.polymarketexchange.comgrpc-preprod.polymarketexchange.com:443pmx-preprod.us.auth0.com
ProdProduction tradinghttps://api.prod.polymarketexchange.comgrpc-prod.polymarketexchange.com:443pmx-prod.us.auth0.com
The Audience value for each environment matches its REST API base URL.

​
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

​
Authentication

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.

​
Health Check

All environments expose the same health check endpoint: 
curl https://api.dev01.polymarketexchange.com/v1/health

{
  "status": "SERVING",
  "version": "1.0.0"
}
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. VPC Service Names and PrivateLink endpoints are provisioned per-firm during FIX onboarding. Contact onboarding@polymarket.us with your AWS Account ID to get started.

​
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@polymarket.us to request access credentials for each environment.