Health

Service health checks. No authentication required.

Endpoints

Method	Path	Description
GET	/v1/health	Basic health status
GET	/v1/health/detailed	Health status with dependency checks

---

Basic Health

GET /v1/health

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

Response:

{
  "status": "healthy",
  "timestamp": "2026-06-28T12:00:00.000Z",
  "version": "0.1.0",
  "uptime": 3825.21
}

Field	Type	Description
status	string	healthy, degraded, or unhealthy
timestamp	string	ISO-8601 timestamp of the check
version	string	Running API version
uptime	number	Process uptime in seconds

Detailed Health

GET /v1/health/detailed

Adds a dependencies block reporting the status of downstream services. Use this for monitoring; the basic endpoint is best for cheap liveness probes.

curl https://api.tokenbot.com/v1/health/detailed

Response:

{
  "status": "healthy",
  "timestamp": "2026-06-28T12:00:00.000Z",
  "version": "0.1.0",
  "uptime": 3825.21,
  "dependencies": {
    "graphql": "up",
    "redis": "up"
  }
}

Field	Type	Description
dependencies.graphql	string	up or down — GraphQL API reachability
dependencies.redis	string	up or down — cache reachability (optional)

Status Values

Status	Meaning
healthy	All checked dependencies are up
degraded	Some dependencies are down; partial functionality
unhealthy	All checked dependencies are down