Deriv API
Documentation
System

Health Check

GETNo auth

Health check endpoint to verify service availability

Endpoint

GET/v1/health

Base URL: https://api.derivws.com

Status Codes

200OK - Service is healthy and operational
OK

About Health Checks

The health check endpoint provides a simple way to verify that the Deriv API service is operational and responding to requests.

Response Format

Returns plain text OK when the service is healthy. A non-200 status code indicates the service is experiencing issues.

Best Practices

  • Poll at regular intervals (e.g. every 30–60 seconds) for continuous monitoring
  • Set appropriate timeouts (e.g. 5 seconds) to detect slow responses
  • Monitor both response status and response time
  • Log health check failures with timestamps for troubleshooting
  • Implement exponential backoff if health checks fail repeatedly

Example Usage

curl https://api.derivws.com/v1/health

Monitoring Integration

Uptime Monitors

Use services like UptimeRobot, Pingdom, or StatusCake to monitor this endpoint:

  • Set check interval to 1–5 minutes
  • Alert on HTTP status code != 200
  • Alert on response time > 2 seconds
Application Monitoring (APM)

Integrate with APM tools like DataDog, New Relic, or Prometheus:

  • Track response times as metrics
  • Set up alerts for failures
  • Create dashboards for uptime visualization
Click to open live chat support. Get instant help from our support team.