Skip to main content

​
Health Check

The Health Check endpoint allows you to verify the API service status before making trading requests.

​
Endpoint

MethodEndpointDescription
GET/v1/healthCheck service health status

​
Request

curl -X GET "https://api.polymarketexchange.com/rest/api/v1/health"
No authentication is required for the health check endpoint.

​
Response

{
  "status": "ok"
}

​
Response Fields

FieldTypeDescription
statusstringService status (ok when healthy)

​
Use Cases

​
Pre-flight Check

Before initiating trading operations, verify the API is healthy: 
import requests

def check_health():
    response = requests.get("https://api.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

Use the health endpoint for:
  • 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