API reference
Health and OpenAPI
Check whether the API and its database are up, and download the OpenAPI 3.1 document for every public endpoint.
Health check
GET
/api/v1/healthNo key
Reports whether the API is up and can reach its database. No key needed; it does not count against any limit.
Request
No parameters and no body.
Response
200 Healthy (200) or degraded (503, database unreachable). Both use this shape.
| Field | Description |
|---|---|
statusstring | "degraded" when the database check failed.one of "healthy", "degraded" |
timestampstring | Server time.date-time |
versionstring | Server API version. |
environmentstring | Server environment, "production" on enton.ai. |
servicesobject | Per-service status. |
services.databasestring | Database reachability.one of "operational", "down" |
services.apistring | Always "operational" when this responds.one of "operational" |
endpointsobject | Paths of the main endpoints. |
documentationstring | Link to these docs.uri |
developerstring | Link to the developer portal.uri |
{
"status": "healthy",
"timestamp": "2026-10-23T14:02:11.093Z",
"version": "v1.0.0",
"environment": "production",
"services": {
"database": "operational",
"api": "operational"
},
"endpoints": {
"ai": "/api/v1/ai/query",
"trading": "/api/v1/trading/cards",
"execute": "/api/v1/trading/execute",
"discovery": "/api/v1/discover",
"oauth": "/api/v1/oauth/[provider]"
},
"documentation": "https://enton.ai/docs",
"developer": "https://enton.ai/developer"
}Errors
| Status | When | error |
|---|---|---|
| 503 | The database is unreachable (status "degraded"), or the check itself failed (status "error", with message and error fields). | Varies |
This endpoint needs no key and is not rate limited.
Examples
curl "https://enton.ai/api/v1/health"OpenAPI document
GET
/api/v1/openapi.jsonNo key
This API described as OpenAPI 3.1, built from the same source as these pages. Import it into Postman, Insomnia or a client generator. No key needed.
Request
No parameters and no body.
Response
200 An OpenAPI 3.1 document.
| Field | Description |
|---|---|
openapistring | "3.1.0". |
infoobject | Title and version. |
serversarray of object | Base URL. |
pathsobject | Every public endpoint. |
componentsobject | Shared schemas, responses and the bearer scheme. |
{
"openapi": "3.1.0",
"info": {
"title": "ENTON API",
"version": "1.0.0"
},
"servers": [
{
"url": "https://enton.ai/api/v1"
}
],
"paths": {},
"components": {}
}Errors
This endpoint needs no key and is not rate limited.
Examples
curl "https://enton.ai/api/v1/openapi.json"