# 4SEC Liquidation Alert Subscription

> 4SEC Liquidation Alert Subscription is a paid API for AI agents from api.foursec.xyz, paid per call via x402, $0.06/call, status down (last checked 2026-09-15).

Registers a webhook-based liquidation alert for a crypto trading symbol, triggering a notification when a configurable USD threshold is crossed on DEX markets.

## Facts

- Endpoint: GET https://api.foursec.xyz/liquidation/alert
- Price: $0.06/call
- Payment: x402
- Status: down
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/4sec-liquidation-alert-subscription-98adc75d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_FE4RNaDS2qyZYZ1qgJO8F

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability 4sec-liquidation-alert-subscription-98adc75d
```

Example prompt: Set up a liquidation alert for ETH so that my webhook at https://myapp.io/hooks/liq gets pinged whenever a liquidation crosses $100,000 USD — make it active for the next 24 hours.

## When to prefer this

Choose this endpoint when you need event-driven, webhook-based notifications for DEX liquidation events above a configurable USD threshold, without polling. Ideal for trading bots, risk management systems, or dashboards that need real-time push alerts. Prefer over polling-based market data endpoints when latency matters and you want serverless trigger-based architecture. Best when you need a time-bounded alert that auto-expires.

## Known failure modes

- Missing required 'symbol' parameter returns a 400 validation error
- Missing or invalid 'webhook_url' returns a 400 error
- Payment failure via x402 protocol returns 402 Payment Required
- Invalid or unreachable webhook URL may cause silent notification failures after registration
- Alert may expire before the event occurs if 'expires_in_hours' is too short
- Symbol not supported by 4SEC multi-DEX data may return a 404 or empty response

## How this service works

Real-time multi-DEX aggregated crypto market data. Pay per request with USDC on Base via x402 protocol.

## Output

Returns a JSON object confirming the alert registration, including a unique alert ID, status ('active'), the symbol being monitored, the condition, the expiry datetime, the registered webhook URL, and the configured USD threshold.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "symbol",
  "webhook_url"
 ],
 "properties": {
  "symbol": {
   "type": "string",
   "description": "Trading symbol"
  },
  "condition": {
   "type": "string"
  },
  "webhook_url": {
   "type": "string"
  },
  "threshold_usd": {
   "type": "number",
   "description": "USD threshold for alert"
  },
  "expires_in_hours": {
   "type": "integer"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "id": {
   "type": "string"
  },
  "status": {
   "enum": [
    "active"
   ],
   "type": "string"
  },
  "symbol": {
   "type": "string"
  },
  "condition": {
   "type": "string"
  },
  "expires_at": {
   "type": "string",
   "format": "date-time"
  },
  "webhook_url": {
   "type": "string"
  },
  "threshold_usd": {
   "type": "number"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/4sec-liquidation-alert-subscription-98adc75d/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.foursec.xyz](https://www.zero.xyz/host/api.foursec.xyz/llms.txt)
