GET
/
v1
/
health
Health Check
curl --request GET \
  --url https://api.example.com/v1/health
This endpoint is public — no API key required.

​
Aggregate Health

Returns the health of all providers in a single call: 
curl https://api.perps.studio/v1/health
Example Response
{
  "status": "ok",
  "service": "provider-api",
  "timestamp": "2026-04-02T12:00:00.000Z",
  "providers": {
    "hyperliquid": {
      "status": "ok",
      "latency": 145
    },
    "aster": {
      "status": "ok",
      "latency": 230
    },
    "polymarket": {
      "status": "ok",
      "latency": 180
    }
  }
}

​
Status Values

StatusMeaning
okProvider is healthy and responding normally
degradedProvider is responding but latency exceeds 3 seconds
downProvider is not responding or returning errors
The top-level status reflects the worst status among all providers.

​
Single Provider Health

Check a specific provider: 
GET /v1/health/:provider

curl https://api.perps.studio/v1/health/hyperliquid
Example Response
{
  "provider": "hyperliquid",
  "status": "ok",
  "latency": 145,
  "checkedAt": "2026-04-02T12:00:00.000Z",
  "checkMethod": "POST https://api.hyperliquid.xyz/info"
}
Use the health endpoint in your monitoring and alerting systems. If a provider shows degraded or down, consider routing traffic to alternative providers.