List mode categories
GET/v1/data/lending/mode
Return the available risk-category ("mode") entries for the requested lenders and chains.
Each entry contains the lender key, chain ID, and a list of mode categories (id + label) under the eModes field.
The "mode" terminology is the protocol-agnostic generalization of Aave V3's "e-mode" (efficiency mode); other lenders expose analogous category mechanisms.
Results are cached server-side (1 hour TTL) because mode categories rarely change.
Plain-text reference — GET /v1/data/lending/mode
Parameters
| Parameter | In | Type | Required | Description |
|---|---|---|---|---|
lenders | query | string[] | yes | Protocol identifiers (repeatable) See the LenderId schema for the full set of accepted values. |
chains | query | string[] | yes | Chain IDs (repeatable) |
Response 200
| Field | Type | Description |
|---|---|---|
success | True | |
data | object | Informational payload. null when the endpoint only builds calldata. |
actions | null |
Example response
{
"success": true,
"data": {}
}
Request
Responses
- 200
- 400
- 429
- 500
- 502
Mode categories per lender/chain
Validation error
Rate limited. Unauthenticated callers share a per-IP budget; send an x-api-key header to lift it. Retry with exponential backoff.
Unexpected server error. Safe to retry with backoff.
An upstream data source or protocol origin failed (error.code is ORIGIN_FAILED). error.details carries the per-origin status. This is also what a missing or malformed required parameter currently returns, rather than a 400.