{"uid":"cap_NQD3GY52C2ICNqtsqshlr","slug":"octodamus-webhook-subscription-25358a78","name":"Octodamus Webhook Subscription","description":"Octodamus is an AI market intelligence oracle for finance, investing, NYSE equities, and Bitcoin. Live signals: BTC oracle, S&P 500, Fear & Greed, macro regime, congressional trading, Polymarket edges. 27 data feeds. Free API — 500 req/day.","url":"https://api.octodamus.com/v2/webhooks/subscribe","method":"POST","headers":{},"bodySchema":{"type":"object","required":["url"],"properties":{"url":{"type":"string","description":"HTTPS endpoint to POST events to"},"events":{"type":"string","description":"Comma-separated: signal.new, signal.resolved, polymarket.new"}}},"responseSchema":{},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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":"$5/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"5","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"5","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_1oWxUOwUyzeF1pvf_GhIt","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"5","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Subscribe an HTTPS endpoint to receive real-time Octodamus market signal events (new signals, resolved signals, Polymarket edges) via webhook POST callbacks.","exampleAgentPrompt":"Set up a webhook on Octodamus so that whenever a new Bitcoin signal or a new Polymarket edge is published, it gets POSTed to https://myserver.example.com/market-hooks — subscribe to both signal.new and polymarket.new events.","exampleUseCases":[{"title":"Automate trading bot signal alerts","prompt":"Register my trading bot endpoint at https://bot.myapp.io/signals to receive live Octodamus signals the moment they fire — I want to catch every new S&P 500 and BTC oracle signal so the bot can react instantly without polling."},{"title":"Push congressional trading alerts to Slack","prompt":"Set up a webhook to https://hooks.myplatform.com/congress-trades so my app gets notified in real time whenever Octodamus publishes a new congressional trading signal — I want to pipe those straight into our Slack alert channel."},{"title":"Stream Polymarket edges to dashboard","prompt":"Subscribe my dashboard backend at https://dashboard.myfintech.com/octodamus-feed to receive Octodamus Polymarket edge events as soon as they're detected — push the polymarket.new callbacks there so we can display live edges without constantly hitting the API."}],"resultDescription":"A subscription confirmation (likely a subscription ID or acknowledgment) indicating the webhook URL has been registered to receive the specified event types. Going forward, the registered HTTPS endpoint will receive POST callbacks whenever the selected events (signal.new, signal.resolved, polymarket.new) fire on Octodamus's platform.","failureModes":["Invalid or unreachable webhook URL — returns error if the HTTPS endpoint cannot be validated","Missing required 'url' field — returns 400 bad request","Invalid event type strings — unrecognized event names in comma-separated list","Payment failure — x402 payment of $5 USDC not completed, subscription not created","Duplicate subscription — re-registering same URL for same events may conflict or silently succeed"],"whenToPreferThis":"Use this endpoint when you need real-time push delivery of Octodamus market signals to your own server or application, rather than polling the API repeatedly. Ideal for event-driven architectures, trading bots, or alert systems that need to react immediately to new BTC oracle signals, S&P 500 signals, or Polymarket edges without polling.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:36:51.241Z","isFirstParty":false}