Liquidation events and related historical views used for risk analysis and monitoring.
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-liquidations-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 Liquidations API
version: 3.0.0
description: 'Operations tagged Liquidations 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: Liquidations
description: Liquidation events and related historical views used for risk analysis and monitoring.
paths:
/v3/liquidations:
get:
tags:
- Liquidations
summary: Liquidation events
x-status: implemented
x-cache-ttl: 60
parameters:
- $ref: '#/components/parameters/ChainIdParam'
- name: vault
in: query
required: false
schema:
type: string
- name: violator
in: query
required: false
schema:
type: string
- name: liquidator
in: query
required: false
schema:
type: string
- name: from
in: query
required: true
schema:
type: integer
- name: to
in: query
required: true
schema:
type: integer
- $ref: '#/components/parameters/SortParam'
- $ref: '#/components/parameters/OffsetParam'
- $ref: '#/components/parameters/LimitParam'
responses:
'200':
description: Liquidations
headers:
X-Request-Id:
$ref: '#/components/headers/X-Request-Id'
content:
application/json:
schema:
type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/LiquidationEvent'
meta:
$ref: '#/components/schemas/PaginationMeta'
'400':
$ref: '#/components/responses/Error400'
operationId: getLiquidations
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.
LiquidationEvent:
type: object
required:
- chainId
- vault
- violator
- liquidator
- collateral
- repayAssets
- yieldBalance
- debtAsset
- debtAssetDecimals
- debtAssetPriceUsd
- repayAssetsUsd
- collateralAsset
- collateralAssetDecimals
- collateralAssetPriceUsd
- collateralAssets
- collateralAssetsUsd
- bonusUsd
- valuation
- unitOfAccountValuation
- blockNumber
- txHash
- timestamp
properties:
chainId:
type: integer
vault:
type: string
description: Debt vault address.
violator:
type: string
liquidator:
type: string
collateral:
type: string
description: Collateral vault address.
repayAssets:
type: string
description: Debt repaid in raw underlying units of the debt vault asset.
yieldBalance:
type: string
description: Collateral seized in raw collateral-vault share units.
debtAsset:
type: string
nullable: true
description: Underlying token address of the debt vault at the liquidation block.
debtAssetDecimals:
type: integer
nullable: true
debtAssetPriceUsd:
type: number
nullable: true
minimum: 0
description: Historical debt-asset USD price at or before the event time and block, never a current-price fallback.
repayAssetsUsd:
type: number
nullable: true
minimum: 0
collateralAsset:
type: string
nullable: true
description: Underlying token address of the collateral vault at the liquidation block.
collateralAssetDecimals:
type: integer
nullable: true
collateralAssetPriceUsd:
type: number
nullable: true
minimum: 0
description: Historical collateral-asset USD price at or before the event time and block, never a current-price fallback.
collateralAssets:
type: string
nullable: true
description: Seized collateral shares converted to raw underlying units from the first indexed collateral VaultStatus after the liquidation log in the same transaction, using EVK virtual-deposit and rounding semantics. Null when that transaction-ordered status is unavailable.
collateralAssetsUsd:
type: number
nullable: true
minimum: 0
description: USD value of seized collateral. A liquidation-block oracle quote can value the seized shares when underlying token metadata or share conversion is unavailable; those native fields remain null.
bonusUsd:
type: number
nullable: true
description: Collateral assets USD minus repaid debt USD. Null unless both values are available.
valuation:
$ref: '#/components/schemas/LiquidationValuation'
unitOfAccountValuation:
allOf:
- $ref: '#/components/schemas/LiquidationUnitOfAccountValuation'
nullable: true
description: Historical liquidation-block protocol-oracle quote used for fallback valuation. Retained when oracle enrichment completes the USD valuation. Null when no historical RPC quote was requested or available.
blockNumber:
type: string
txHash:
type: string
timestamp:
type: string
format: date-time
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
LiquidationUnitOfAccountValuation:
type: object
required:
- source
- unitOfAccount
- unitOfAccountDecimals
- repayValue
- collateralValue
- bonusValue
- blockNumber
properties:
source:
type: string
enum:
- historical-protocol-oracle
unitOfAccount:
type: string
description: Debt vault unit-of-account address used by the protocol oracle.
unitOfAccountDecimals:
type: integer
nullable: true
minimum: 0
maximum: 255
repayValue:
type: string
pattern: ^\d+$
description: Debt repaid, quoted into the unit of account at the liquidation block.
collateralValue:
type: string
pattern: ^\d+$
description: Seized collateral-vault shares, quoted into the unit of account at the liquidation block.
bonusValue:
type: string
pattern: ^-?\d+$
description: Collateral value minus repay value in raw unit-of-account units.
blockNumber:
type: string
pattern: ^\d+$
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'
LiquidationValuation:
type: object
required:
- status
- source
properties:
status:
type: string
enum:
- available
- partial
- unavailable
description: Available when both liquidation legs have USD values, partial when one does, and unavailable when neither does.
source:
type: string
enum:
- historical-price-snapshots
- historical-protocol-oracle
description: Oracle USD enrichment is disabled by default and requires the LIQUIDATION_ORACLE_USD_ENABLED server rollout gate. Historical protocol oracle indicates that at least one missing USD leg uses the liquidation-block oracle quote. Token-denominated quotes require a USD snapshot from the preceding 15 minutes with no future block. Existing snapshot-valued legs are preserved.
reason:
type: string
description: Present when valuation is partial or unavailable.
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.
headers:
X-Request-Id:
description: Request identifier for tracing.
schema:
type: string
parameters:
LimitParam:
name: limit
in: query
required: false
description: Requested page size. Values above the endpoint cap are clamped; the default shared cap is 100.
schema:
type: integer
minimum: 1
default: 20
maximum: 100
ChainIdParam:
name: chainId
in: query
required: false
schema:
type: string
description: Comma-separated list of positive chain IDs (single value allowed). Duplicate IDs are removed in first-occurrence order; at most 20 distinct IDs and 512 input characters are accepted.
example: 1,10,8453
SortParam:
name: sort
in: query
required: false
schema:
type: string
description: Sort field, prefix with '-' for descending.
OffsetParam:
name: offset
in: query
required: false
description: Page offset, capped at 10000 to bound query cost.
schema:
type: integer
minimum: 0
maximum: 10000
default: 0
ChainIdParam_2:
name: chainId
in: query
required: false
schema:
type: string
description: Comma-separated list of chain IDs (single value allowed).
example: 1,10,8453
LimitParam_2:
name: limit
in: query
required: false
description: Requested page size. Values above the endpoint cap are clamped; the default shared cap is 100.
schema:
type: integer
default: 20
maximum: 100
OffsetParam_2:
name: offset
in: query
required: false
schema:
type: integer
default: 0
responses:
Error400:
description: Bad request
headers:
X-Request-Id:
$ref: '#/components/headers/X-Request-Id'
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
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