{"uid":"cap_7PZe9Y4ADA9CsfgKC55Fj","slug":"2s-fred-series-watcher-economic-indicator-threshold-alert-4699a707","name":"2s FRED Series Watcher — Economic Indicator Threshold Alert","description":"The (most) everything API: 575+ pay-per-call endpoints for AI agents — ground-truth data, a full AI gateway, and agent infrastructure (storage, queues, watchers). USDC via x402, no signup, no API keys, and upto billing: pay actual usage, not the quote.","url":"https://2s.io/api/watchers/fred-series?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"label":{"type":"string","maxLength":64,"description":"Optional free-text tag."},"payload":{"type":"object","description":"Arbitrary JSON echoed back in every callback.","additionalProperties":{}},"maxFires":{"type":"integer","maximum":1000,"minimum":1,"description":"Stop after this many callbacks (default 1)."},"seriesId":{"type":"string","maxLength":64,"minLength":1,"description":"FRED series id, e.g. DGS10, UNRATE, CPIAUCSL, FEDFUNDS."},"threshold":{"type":"number","description":"The series value to cross, e.g. 5 (for DGS10 = 5% 10yr yield)."},"callbackUrl":{"type":"string","maxLength":2048,"description":"Signed event POSTed here (verify X-2s-Signature). Any http(s) URL."},"conditionType":{"enum":["above","below"],"type":"string","description":"Fire when the latest value goes above or below the threshold."},"expiresInSeconds":{"type":"integer","maximum":7776000,"minimum":60,"description":"Active window in seconds (default 30d, max 90d)."}}},"responseSchema":{"type":"json","schema":{"type":"object","required":["ok","items","total","source"],"properties":{"ok":{"enum":[true],"type":"boolean"},"items":{"type":"array","items":{"type":"object","additionalProperties":{}}},"total":{"type":"integer","nullable":true,"description":"Total matching rows upstream; null when unknown."},"source":{"type":"object","required":["provider","url","license"],"properties":{"url":{"type":"string"},"license":{"type":"string"},"provider":{"type":"string"}},"additionalProperties":false}},"additionalProperties":false},"example":{"ok":true,"items":[{}],"total":1,"source":{"url":"example","license":"example","provider":"example"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.125","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":{"p10Cents":"12.5000","medianCents":"12.5000","p90Cents":"12.5000","minCents":"12.5000","maxCents":"12.5000","p95Cents":"12.5000","sampleCount":1,"varies":false,"failureChargeRate":1},"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.125/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.125","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.125","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_TKWbrwRSe5jcDlWh5rS-K","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.125","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Creates a webhook-based watcher that fires a callback when a FRED economic data series crosses a specified threshold value (above or below).","exampleAgentPrompt":"Set up a FRED watcher on the DGS10 series that POSTs to https://hooks.myapp.com/fred-alert when the 10-year Treasury yield goes above 5.0 — fire up to 3 times and keep it active for 60 days.","exampleUseCases":[{"title":"Treasury yield breach alert for bond desk","prompt":"Watch the DGS10 FRED series and POST to https://alerts.mybonddesk.com/webhook when the 10-year yield goes above 4.75% — let it fire up to 5 times over the next 90 days and tag it 'bond-desk-q3'."},{"title":"Unemployment rate dip trigger for hiring model","prompt":"Monitor the UNRATE FRED series and call back https://hr.myplatform.io/trigger when unemployment falls below 4.0% — fire just once and expire after 30 days."},{"title":"Fed funds rate cut detector for trading bot","prompt":"Set up a watcher on FEDFUNDS that sends a POST to https://trading.mybot.io/fed-event whenever the federal funds rate drops below 5.0%, with a max of 10 fires and active for 60 days."}],"resultDescription":"Returns a JSON object confirming the watcher was registered, including the watcher record(s) in an items array, a total count, an ok:true flag, and source attribution (provider, URL, license). Once active, the watcher POSTs a signed callback event to the specified URL each time the FRED series breaches the threshold, including an X-2s-Signature header for verification and the optional echo payload.","failureModes":["Invalid FRED series ID returns an error or empty result","Callback URL unreachable causes silent callback failure (no retry guarantee)","Threshold never crossed within expiry window — watcher expires without firing","maxFires exceeded — watcher self-deactivates after limit is reached","expiresInSeconds out of range (< 60 or > 7776000) causes validation error","Malformed conditionType enum value causes request rejection","Missing required fields (seriesId, threshold, conditionType, callbackUrl) returns 400","Payment failure via x402 prevents watcher creation"],"whenToPreferThis":"Use this endpoint when you need event-driven, webhook-based alerts on FRED macroeconomic series (Treasury yields, unemployment, CPI, fed funds rate, etc.) rather than polling for data yourself. It is ideal for trading systems, economic dashboards, hiring models, or any automated pipeline that must react to a specific economic threshold being crossed. Prefer this over polling the FRED data endpoints directly when you want push-based notification with signature verification, configurable fire limits, and built-in expiry — without managing a cron job or scheduler yourself.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T18:40:04.201Z","isFirstParty":false,"canonicalSlug":"2s-fred-series-watcher-economic-indicator-threshold-alert-4699a707"}