{"uid":"cap_denv5KERhZCxG69zemiEu","slug":"halowerk-article-price-percentage-drop-detector-8a04c673","name":"HALOWERK Article Price Percentage Drop Detector","description":"Notify when a listed-price reduction reaches a chosen percentage; previous price must be positive. Uses an optional predicate extension of the proven Price-Callback motor. price_percentage_drop_decision records this exact rule; the rule executes BEFORE dispatch. Same public IPv4HTTPS pinned connections, robots checks,9s,1MiBHTML,at-most-once receipt/idempotency7days,failureschargedfalse. Caller supplies historical price and schedules polling.","url":"https://handel.halowerk.com/v1/price/articles/percentage-drop?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"url":{"type":"string","maxLength":2048},"previous":{"type":"object","required":["value","currency"],"properties":{"value":{"type":"number","maximum":1000000000,"minimum":0},"currency":{"type":"string","pattern":"^[A-Z]{3}$"}},"additionalProperties":false},"callback_url":{"type":"string","maxLength":2048},"drop_percent":{"type":"number","maximum":100,"exclusiveMinimum":0},"idempotency_key":{"type":"string","pattern":"^[A-Za-z0-9_-]+$","maxLength":128,"minLength":32}}},"responseSchema":{"type":"json"},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.007","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.007/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.007","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.007","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_MLryksg7eTgS67q97g37a","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.007","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches a product article's current price from a URL and calculates whether it has dropped by a specified percentage compared to a previously known price","exampleAgentPrompt":"Check whether the product at https://shop.example.com/articles/red-sneakers has dropped by at least 15% compared to its previous price of 89.99 USD, and let me know the result.","exampleUseCases":[{"title":"Flash sale price drop alert","prompt":"The product at https://www.store.com/items/blue-jacket was 120.00 EUR last week — has it dropped by at least 20% since then? Check it now."},{"title":"Competitor price monitoring","prompt":"I previously saw this competitor article at https://competitor.com/products/widget priced at 45.50 USD. Tell me if it has dropped by 10% or more."},{"title":"Deal validation before purchase","prompt":"Before I buy, check if https://retailer.com/en/product/headphones has gone down by at least 25% from the 199.99 GBP price I recorded last month."}],"resultDescription":"A JSON response indicating whether the article's current price has dropped by the specified percentage relative to the provided previous price, likely including the current price, the calculated drop percentage, and a boolean or signal confirming whether the threshold was met.","failureModes":["URL is unreachable or returns non-200 response — endpoint may return an error or empty result","Article page does not contain a parseable price — extraction fails","Currency mismatch between previous price and current scraped price","drop_percent must be greater than 0 and at most 100 — validation error if out of range","previous.value must be between 0 and 1,000,000,000 — error if exceeded","idempotency_key too short (min 32 chars) or contains invalid characters","Payment failure via x402 protocol prevents request from being processed"],"whenToPreferThis":"Use this endpoint when you need to programmatically detect price drops on specific article URLs against a previously known price and percentage threshold — especially in automated deal-detection pipelines, price alert workflows, or shopping agents. Prefer this over generic scraping when you want a structured, paid-per-call service with idempotency support and optional callback for async notification.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-10T12:37:25.757Z","isFirstParty":false,"canonicalSlug":"halowerk-article-price-percentage-drop-detector-8a04c673"}