Liveness, readiness, and dashboard-friendly platform status checks. Use these for operational monitoring, not for reconstructing full portfolio state.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/euler:euler-health-api"curl "https://apis.io/api/v1/apis?limit=25"Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Euler Health API
version: 3.0.0
description: 'Operations tagged Health across 2 of this provider''s published API definitions: euler-openapi.json, euler-v3-data-api.json. Each path carries the servers of the definition it was published in.'
servers:
- url: /
description: Current environment
security: []
tags:
- name: Health
description: Liveness, readiness, and dashboard-friendly platform status checks. Public readiness calls use a bounded per-process admission budget; dependency-health routes share that budget and Kubernetes probes use a Service-excluded management listener. Use these for operational monitoring, not for reconstructing full portfolio state.
paths:
/v3/health:
get:
tags:
- Health
summary: Basic health check
x-status: implemented
responses:
'200':
description: OK
headers:
X-Request-Id:
$ref: '#/components/headers/X-Request-Id'
content:
application/json:
schema:
type: object
required:
- data
- meta
properties:
data:
$ref: '#/components/schemas/HealthResponse'
meta:
$ref: '#/components/schemas/PaginationMeta'
operationId: getHealth
servers:
- url: /
description: Current environment
/v3/health/detailed:
get:
tags:
- Health
summary: Dependency health check
x-status: implemented
responses:
'200':
description: OK
headers:
X-Request-Id:
$ref: '#/components/headers/X-Request-Id'
content:
application/json:
schema:
type: object
required:
- data
- meta
properties:
data:
$ref: '#/components/schemas/DetailedHealthResponse'
meta:
$ref: '#/components/schemas/PaginationMeta'
'429':
$ref: '#/components/responses/Error429'
operationId: getHealthDetailed
servers:
- url: /
description: Current environment
/v3/health/dashboard:
get:
tags:
- Health
summary: Human-readable dependency health dashboard
description: Sanitized aggregate dependency and per-chain health intended for browser viewing.
x-status: implemented
responses:
'200':
description: Health dashboard HTML.
headers:
X-Request-Id:
$ref: '#/components/headers/X-Request-Id'
content:
text/html:
schema:
type: string
'429':
$ref: '#/components/responses/Error429'
operationId: getHealthDashboard
servers:
- url: /
description: Current environment
/v3/health/live:
get:
tags:
- Health
summary: Liveness probe
x-status: implemented
responses:
'200':
description: OK
headers:
X-Request-Id:
$ref: '#/components/headers/X-Request-Id'
content:
application/json:
schema:
type: object
required:
- data
- meta
properties:
data:
type: object
required:
- status
properties:
status:
type: string
enum:
- ok
meta:
$ref: '#/components/schemas/PaginationMeta'
'503':
description: Local health-check cleanup did not terminate; process restart required
headers:
X-Request-Id:
$ref: '#/components/headers/X-Request-Id'
content:
application/json:
schema:
type: object
required:
- data
- meta
properties:
data:
type: object
required:
- status
- reason
properties:
status:
type: string
enum:
- not_live
reason:
type: string
enum:
- health_check_cleanup_stalled
meta:
$ref: '#/components/schemas/PaginationMeta'
operationId: getHealthLive
servers:
- url: /
description: Current environment
/v3/health/ready:
get:
tags:
- Health
summary: Public readiness status
description: Public mirror of the readiness result. Kubernetes probes use the Service-excluded management listener and do not consume this endpoint's bounded per-process admission budget.
x-status: implemented
responses:
'200':
description: Ready
headers:
X-Request-Id:
$ref: '#/components/headers/X-Request-Id'
content:
application/json:
schema:
type: object
required:
- data
- meta
properties:
data:
type: object
required:
- status
properties:
status:
type: string
enum:
- ready
meta:
$ref: '#/components/schemas/PaginationMeta'
'429':
$ref: '#/components/responses/Error429'
'503':
description: Not ready
content:
application/json:
schema:
type: object
required:
- data
- meta
properties:
data:
type: object
required:
- status
- reasons
- checks
properties:
status:
type: string
enum:
- not_ready
reasons:
type: array
items:
type: string
checks:
type: object
properties:
database:
type: string
enum:
- ok
- error
ponderRead:
type: string
enum:
- ok
- error
redis:
type: string
enum:
- ok
- error
meta:
$ref: '#/components/schemas/PaginationMeta'
operationId: getHealthReady
servers:
- url: /
description: Current environment
/v3/metrics:
get:
tags:
- Health
summary: Prometheus metrics endpoint
description: Internal observability endpoint for Prometheus scraping.
x-status: implemented
security:
- AdminSecret: []
responses:
'200':
description: Prometheus metrics text payload
content:
text/plain:
schema:
type: string
'401':
$ref: '#/components/responses/Error401'
'403':
$ref: '#/components/responses/Error403'
operationId: getMetrics
servers:
- url: /
description: Current environment
components:
schemas:
LabelHoldSummary:
description: What a draft read shows on a held row.
type: object
required:
- id
- kind
- reason
- since
properties:
id:
type: string
format: uuid
kind:
type: string
enum:
- quarantine
- entity-hold
reason:
type: string
since:
type: string
format: date-time
ListingFlag:
type: boolean
nullable: true
description: Curator listing flag. `null` leaves the decision to platform overrides and deprecation, `true` hides the vault(s) from discovery, `false` keeps a deprecated vault listed.
ErrorResponse:
type: object
required:
- error
properties:
error:
type: object
required:
- code
- message
- requestId
properties:
code:
type: string
description: 'Domain error code. Examples:
- BAD_REQUEST
- INVALID_ADDRESS
- INVALID_CHAIN_ID
- CHAIN_NOT_SUPPORTED
- CHAIN_CAPABILITY_DISABLED
- NOT_FOUND
- VAULT_NOT_FOUND
- TOKEN_NOT_FOUND
- ACCOUNT_NOT_FOUND
- VALIDATION_ERROR
- CONFLICT
- PRECONDITION_FAILED
- PAYLOAD_TOO_LARGE
- RATE_LIMIT_EXCEEDED
- UNSUPPORTED_MEDIA_TYPE
- UPSTREAM_TIMEOUT
- UNAUTHORIZED
- FORBIDDEN
- SERVICE_UNAVAILABLE
- SERVICE_DISABLED
- INTERNAL_ERROR
'
message:
type: string
requestId:
type: string
details:
type: object
additionalProperties: true
description: Context of the error. Where present, `details.reason` is a stable kebab-case value to key on, and `details.cause` narrows a reason that has several causes. The labels routes list theirs in the Labels tag.
ExcludedChains:
type: array
description: 'On a read across chains that names no `chainId`: the served chains it left out because they do not run the capability the operation needs, rather than reading them as empty. Absent when no chain was left out.'
items:
type: object
required:
- chainId
- capability
properties:
chainId:
type: integer
capability:
type: string
enum:
- indexing
- activity
- prices
- historicalPrices
- assessments
- labels
- logos
- stats
- risk
- rewards
- apys
HealthResponse:
type: object
required:
- status
- version
- uptime
- timestamp
properties:
status:
type: string
enum:
- healthy
- degraded
- unhealthy
version:
type: string
uptime:
type: integer
timestamp:
type: string
format: date-time
ProductPlatformListing:
description: The platform-owned discovery decision on a product, as a product row shows it.
type: object
required:
- notExplorableLend
- notExplorableBorrow
- reason
properties:
notExplorableLend:
type: boolean
notExplorableBorrow:
type: boolean
reason:
type: string
nullable: true
ResolvedProductLabels:
type: object
readOnly: true
description: Read-time entity fallbacks for display. Derived, never stored.
required:
- entityName
- url
- logo
properties:
entityName:
type: string
nullable: true
url:
type: string
nullable: true
description: Product url, falling back to the owning entity url.
logo:
type: string
nullable: true
description: Product logo, falling back to the owning entity logo.
PaginationMeta:
type: object
required:
- timestamp
properties:
total:
type: integer
description: Exact total count when the endpoint provides one.
hasMore:
type: boolean
description: Indicates whether another page exists beyond the current page.
offset:
type: integer
limit:
type: integer
description: Echoed page size after endpoint-side clamping.
outcome:
type: string
enum:
- disabled
- removed
description: On a toolbox config DELETE, what happened to the row.
products:
type: array
description: 'On a curation vault `POST`, `PUT`, or `PATCH`: the products the write touched (the one the vault left and the one it joined) as they are after the write, `governanceMode` included, so the caller applies them instead of re-reading.'
items:
$ref: '#/components/schemas/ProductLabels'
timestamp:
type: string
format: date-time
chainId:
type: string
description: Comma-separated chain IDs for multi-chain responses.
degradedProviders:
type: array
items:
type: string
description: Live providers whose data is incomplete in this response.
excludedChains:
$ref: '#/components/schemas/ExcludedChains'
ProductLabels:
type: object
required:
- id
- chainId
- entityId
- coBrandEntityIds
- name
- isDeprecated
- notExplorable
- governanceMode
- resolved
- anyExplorableLend
- anyExplorableBorrow
- createdAt
- updatedAt
properties:
id:
type: string
pattern: ^[a-z0-9]+(?:-[a-z0-9]+)*$
chainId:
type: integer
minimum: 1
entityId:
type: string
coBrandEntityIds:
type: array
description: Additional entities whose logos should be displayed. Product management remains exclusively with entityId.
items:
type: string
name:
type: string
logo:
type: string
nullable: true
description:
type: string
nullable: true
url:
type: string
nullable: true
maxLength: 2048
pattern: ^[Hh][Tt][Tt][Pp][Ss]://
description: Absolute https URL.
portfolioNotice:
type: string
nullable: true
isDeprecated:
type: boolean
deprecationReason:
type: string
nullable: true
notExplorable:
allOf:
- $ref: '#/components/schemas/ListingFlag'
description: Product-wide curator listing flag applied to both sides of every member vault unless a vault-level flag overrides it.
governanceMode:
type: string
enum:
- governed
- ungoverned
- unknown
readOnly: true
description: Derived by the server from the on-chain governor of member vaults; clients cannot set it. Products are created as `unknown`. Every vault assignment recomputes the mode over the resulting member set and rejects sets that mix governed and ungoverned vaults. Layer 2 adopts `governed` or `ungoverned` for an `unknown` product once its membership verifies against chain state. Entity members cannot update or delete an `ungoverned` product or its vaults after the initial assignment.
resolved:
$ref: '#/components/schemas/ResolvedProductLabels'
anyExplorableLend:
type: boolean
readOnly: true
description: True when at least one member vault is lend-discoverable per the materialized visibility verdicts. Live chain state (e.g. borrowability) is deliberately excluded.
anyExplorableBorrow:
type: boolean
readOnly: true
description: True when at least one member vault is borrow-discoverable per the materialized visibility verdicts. Live chain state (e.g. borrowability) is deliberately excluded.
createdAt:
type: string
format: date-time
updatedAt:
type: string
format: date-time
hold:
type: object
nullable: true
description: The hold covering this row on a draft read; absent on published reads.
allOf:
- $ref: '#/components/schemas/LabelHoldSummary'
platformListing:
type: object
nullable: true
description: Euler's listing override on this product, shown to platform sessions on draft reads (null when there is none); absent on published reads and to curators.
allOf:
- $ref: '#/components/schemas/ProductPlatformListing'
DetailedHealthResponse:
allOf:
- $ref: '#/components/schemas/HealthResponse'
- type: object
required:
- checks
properties:
checks:
type: object
properties:
database:
type: object
properties:
status:
type: string
enum:
- ok
- error
latency:
type: number
error:
type: string
enum:
- Database health check failed
code:
type: string
enum:
- DATABASE_HEALTH_CHECK_FAILED
ponderRead:
type: object
properties:
status:
type: string
enum:
- ok
- error
latency:
type: number
error:
type: string
enum:
- Ponder read-model health check failed
code:
type: string
enum:
- PONDER_READ_MODEL_HEALTH_CHECK_FAILED
redis:
type: object
properties:
status:
type: string
enum:
- ok
- error
latency:
type: number
error:
type: string
enum:
- Redis health check failed
code:
type: string
enum:
- REDIS_HEALTH_CHECK_FAILED
indexer:
type: object
properties:
status:
type: string
enum:
- ok
- syncing
- error
blocksBehind:
type: integer
syncProgress:
type: number
latency:
type: number
error:
type: string
enum:
- Indexer health check failed
code:
type: string
enum:
- INDEXER_HEALTH_CHECK_FAILED
chains:
type: array
items:
type: object
required:
- chainId
- status
properties:
chainId:
type: integer
status:
type: string
enum:
- ok
- syncing
- error
lastIndexedBlock:
type: integer
blocksBehind:
type: integer
syncProgress:
type: number
latency:
type: number
error:
type: string
enum:
- Indexer chain health check failed
code:
type: string
enum:
- INDEXER_CHAIN_HEALTH_CHECK_FAILED
ErrorResponse_2:
type: object
required:
- error
properties:
error:
type: object
required:
- code
- message
- requestId
properties:
code:
type: string
description: 'Domain error code. Examples:
- INVALID_ADDRESS
- CHAIN_NOT_SUPPORTED
- VAULT_NOT_FOUND
- TOKEN_NOT_FOUND
- ACCOUNT_NOT_FOUND
- VALIDATION_ERROR
- RATE_LIMIT_EXCEEDED
- UNSUPPORTED_MEDIA_TYPE
- UNAUTHORIZED
- FORBIDDEN
- INTERNAL_ERROR
'
message:
type: string
requestId:
type: string
details:
type: object
additionalProperties: true
PaginationMeta_2:
type: object
required:
- timestamp
properties:
total:
type: integer
description: Exact total count when the endpoint provides one.
hasMore:
type: boolean
description: Indicates whether another page exists beyond the current page.
offset:
type: integer
limit:
type: integer
description: Echoed page size after endpoint-side clamping.
timestamp:
type: string
format: date-time
chainId:
type: string
description: Comma-separated chain IDs for multi-chain responses.
DetailedHealthResponse_2:
allOf:
- $ref: '#/components/schemas/HealthResponse'
- type: object
required:
- checks
properties:
checks:
type: object
properties:
database:
type: object
properties:
status:
type: string
enum:
- ok
- error
latency:
type: number
error:
type: string
redis:
type: object
properties:
status:
type: string
enum:
- ok
- error
latency:
type: number
error:
type: string
indexer:
type: object
properties:
status:
type: string
enum:
- ok
- syncing
- error
blocksBehind:
type: integer
syncProgress:
type: number
latency:
type: number
error:
type: string
headers:
X-Request-Id:
description: Request identifier for tracing.
schema:
type: string
responses:
Error429:
description: Rate limited
headers:
Retry-After:
description: Seconds until next request is allowed.
schema:
type: integer
X-Request-Id:
$ref: '#/components/headers/X-Request-Id'
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
Error403:
description: Forbidden
headers:
X-Request-Id:
$ref: '#/components/headers/X-Request-Id'
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse_2'
Error401:
description: Unauthorized
headers:
X-Request-Id:
$ref: '#/components/headers/X-Request-Id'
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse_2'
securitySchemes:
ApiKeyAuth:
type: apiKey
in: header
name: X-API-Key
description: API key authentication (optional; higher rate limits).
BearerAuth:
type: http
scheme: bearer
bearerFormat: API key
description: 'Alternative to X-API-Key using Authorization: Bearer <key>'
AdminSecret:
type: apiKey
in: header
name: X-Admin-Secret
description: Admin secret (server-to-server) for API key management.
PlatformSession:
type: apiKey
in: cookie
name: euler_platform_session
description: Signed, httpOnly platform-operator browser session cookie.
PlatformCsrf:
type: apiKey
in: header
name: X-CSRF-Token
description: Double-submit CSRF token required for unsafe cookie-authenticated methods.
x-refined-from:
- euler-openapi.json
- euler-v3-data-api.json