{"uid":"cap_J02QrZQy-SsfXvXImtY-F","slug":"4sec-price-alert-setup-7d7e894e","name":"4SEC Price Alert Setup","description":"Real-time multi-DEX aggregated crypto market data. Pay per request with USDC on Base via x402 protocol.","url":"https://api.foursec.xyz/price-alert","method":"GET","headers":{},"bodySchema":{"type":"object","required":["symbol","condition","webhook_url"],"properties":{"symbol":{"type":"string","description":"Token symbol (uppercase)"},"condition":{"type":"string","description":"Alert trigger condition"},"webhook_url":{"type":"string"},"agent_wallet":{"type":"string","description":"EVM (0x...) or Solana (base58) wallet address"},"target_price":{"type":"number","description":"Price level to trigger the alert"},"expires_in_hours":{"type":"integer","description":"Alert TTL in hours (max 168)"}}},"responseSchema":{"type":"object","properties":{"id":{"type":"string"},"status":{"enum":["active"],"type":"string"},"symbol":{"type":"string"},"condition":{"type":"object"},"expires_at":{"type":"string","format":"date-time"},"webhook_url":{"type":"string"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.04","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.04/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.04","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.04","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_KmmLhzn-szH321AT2Qb_u","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.04","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Creates a conditional price alert for a crypto token that fires a webhook when a specified price condition is met","exampleAgentPrompt":"Set a price alert for ETH that fires my webhook at https://myapp.com/hooks/eth when the price drops below $2,000 — make it expire in 24 hours.","exampleUseCases":[{"title":"DeFi bot entry point alert","prompt":"Set up a price alert for WBTC that hits my webhook at https://bot.mytrader.io/trigger when WBTC crosses above $70,000, and have it expire in 48 hours."},{"title":"Portfolio stop-loss notification","prompt":"I want an alert for SOL: if the price falls below $120, fire a POST to https://alerts.myportfolio.com/webhook — set it to expire in 72 hours."},{"title":"Short-lived arbitrage opportunity watcher","prompt":"Create a price alert for ARB token that notifies https://arb.myagent.xyz/hook when the condition is price_above and target is $1.50 — let it expire in 6 hours."}],"resultDescription":"Returns a JSON object with a unique alert ID, status 'active', the monitored symbol, a structured condition object, an expiry datetime, and the registered webhook URL confirming the alert was successfully created.","failureModes":["Missing required fields (symbol, condition, webhook_url) returns a 400 error","Invalid or unreachable webhook URL may be accepted but silently fail at trigger time","Alert TTL exceeding 168 hours will be rejected or clamped","Invalid wallet address format returns a validation error","Payment failure via x402 protocol prevents alert creation","Condition string not in expected format may cause parsing errors"],"whenToPreferThis":"Use this endpoint when you need asynchronous, event-driven price notifications for crypto tokens across DEXes — particularly when you want to avoid polling a price endpoint repeatedly. Ideal for agent workflows that need to react to market conditions without being active, or when you want to wire automated downstream actions (trades, notifications, logging) via webhook on a price trigger.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T15:27:48.818Z","isFirstParty":false}