Health Check

​

Endpoint

​

Request

curl -X GET "https://api.prod.polymarketexchange.com/rest/api/v1/health"

​

Response

{
  "status": "ok"
}

​

Response Fields

​

Use Cases

​

Pre-flight Check

import requests

def check_health():
    response = requests.get("https://api.prod.polymarketexchange.com/rest/api/v1/health")
    if response.status_code == 200 and response.json().get("status") == "ok":
        return True
    return False

if check_health():
    # Proceed with trading operations
    pass
else:
    # Handle service unavailability
    pass

​

Monitoring

• Load balancer health checks - Configure your load balancer to poll this endpoint
• Alerting systems - Set up alerts when the endpoint fails
• Dashboard status - Display real-time service status in your application

​

Best Practices

1. Don’t over-poll - Check health at reasonable intervals (e.g., every 30 seconds)
2. Implement retry logic - Transient failures can occur; retry before alerting
3. Cache results - Don’t check health before every API call
4. Handle gracefully - If health check fails, queue operations and retry later