{"uid":"cap_iLaRGnOod7QdGBr5OUGqU","slug":"token-price-alert-c87a2e3f","name":"Token Price Alert","description":"Pay once to register a price-threshold alert on any Base token. Supply target price, direction (above/below), and an https webhook URL. A polling cron (daily by default; configurable to ~minutes) checks DexScreener and POSTs your webhook when it crosses. Expires after 30 days. Or omit the webhook and poll with check=<id>: the verdict is THRESHOLD_MET, ok, FIRED, or unknown when the price feed could not be read.","url":"https://402.com.tr/api/x402/price-alert","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"pathParams":{"type":"object"},"queryParams":{"type":"object","required":["token","threshold","direction"],"properties":{"check":{"type":"string","description":"Or: alert id to poll its status"},"token":{"type":"string","description":"Token address"},"webhook":{"type":"string","description":"Webhook URL (optional — omit to poll)"},"direction":{"type":"string","description":"Direction (above/below)"},"threshold":{"type":"string","description":"Price threshold (USD)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","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":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_A5rJftERixh0wDzssqt7J","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Registers a price-threshold alert on a Base token that polls DexScreener and POSTs a webhook when the price crosses above or below a specified USD target.","exampleAgentPrompt":"Set up a price alert for Base token 0x4ed4E862860beD51a9570b96d89aF5E1B0Efefed — notify my webhook at https://myapp.example.com/hooks/price when it goes above $0.05.","exampleUseCases":[{"title":"Buy-the-dip trigger for DCA bot","prompt":"Register a price alert for Base token 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 — when the price drops below $0.98 send a POST to https://mybot.example.com/dca-trigger so my agent can execute a buy."},{"title":"Take-profit webhook for trading agent","prompt":"Set a price alert on Base token 0x4200000000000000000000000000000000000006 — fire my webhook at https://signals.example.com/take-profit when it crosses above $3500, direction above."},{"title":"Check status of existing price alert","prompt":"Can you poll the status of my price alert with ID alert_abc123 to see if it's still active or has already triggered?"}],"resultDescription":"On registration: a confirmation with an alert ID, expiry timestamp (30 days), and polling interval. On status poll: current alert state (pending/triggered/expired). When the threshold is crossed: a POST is sent to the registered webhook URL with token address, threshold, direction, current price, and timestamp.","failureModes":["Invalid or non-Base token address returns an error","Webhook URL is not a valid HTTPS URL — rejected at registration","Threshold not a valid USD number — parse error","Direction value not 'above' or 'below' — validation failure","Alert expires after 30 days without triggering if price never crosses","Webhook endpoint unreachable at trigger time — notification may be lost","DexScreener data unavailable for illiquid tokens — polling may fail silently"],"whenToPreferThis":"Choose this endpoint when you need event-driven price notifications for Base tokens without running your own polling infrastructure. Ideal for trading bots, DCA agents, or alert systems that need to react to price crossings asynchronously via webhook. Best suited for tokens with DexScreener coverage on Base; not appropriate for CEX-listed assets or non-Base chains.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:44:00.011Z","isFirstParty":false}