{"uid":"cap_FE4RNaDS2qyZYZ1qgJO8F","slug":"4sec-liquidation-alert-subscription-98adc75d","name":"4SEC Liquidation Alert Subscription","description":"Real-time multi-DEX aggregated crypto market data. Pay per request with USDC on Base via x402 protocol.","url":"https://api.foursec.xyz/liquidation/alert","method":"GET","headers":{},"bodySchema":{"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"}}},"responseSchema":{"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"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.06","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"down","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.06/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.06","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.06","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_RXXS5mfYyeWXNXOhiD5v6","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.06","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Registers a webhook-based liquidation alert for a crypto trading symbol, triggering a notification when a configurable USD threshold is crossed on DEX markets.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"DeFi trading bot liquidation guard","prompt":"Register a liquidation alert for WBTC on 4SEC — send a POST to https://tradingbot.io/hooks/liq whenever a liquidation event hits above $500,000, and keep it active for the next 48 hours."},{"title":"Portfolio risk notification","prompt":"I want to be alerted if there's a big liquidation on SOL exceeding $250,000 — ping my webhook at https://alerts.myapp.com/sol whenever that happens, and set the alert to expire in 12 hours."},{"title":"Short-term event monitoring during volatile market","prompt":"Set up a 6-hour liquidation monitor for PEPE with a $10,000 threshold and send hits to https://dashboard.cryptodesk.io/webhook — I need to watch for large liquidations while the market is pumping."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T19:26:13.338Z","isFirstParty":false}