Skip to main content
Source OpenAPI: 0xArchive API 1.14.0; 242 paths; 243 component schemas. Get historical liquidation events for a specific user address. Returns liquidations where the user was the liquidated party. Served from December 22, 2025; older rows exist but are not served.

Route Metadata

Human endpoint reference

Open GET /v1/hyperliquid/liquidations/user/{user} for authentication, parameters, responses, and examples.

Request Parameters

Path Parameters

Query Parameters

Header Parameters

Response Contracts

Status 200

User liquidation events

application/json

Status 401

Authentication required: the API key is missing or invalid.

application/json

OpenAPI example

Status 403

The request is outside the plan’s history window or per-request span, or the key is not allowed to make it.

application/json

OpenAPI example: historical_depth_exceeded
OpenAPI example: historical_range_exceeded

Status 429

Rate limit, concurrency limit or monthly credits exceeded. See error_code.

application/json

OpenAPI example: insufficient_credits
OpenAPI example: rate_limited

Status default

Any other error. The body is an ErrorResponse; branch on error_code. A 503 (upstream_unavailable) carries Retry-After.

application/json

OpenAPI example: internal_error
OpenAPI example: upstream_unavailable
Last modified on November 17, 2026