# Octodamus Webhook Subscription

> Octodamus Webhook Subscription is a paid API for AI agents from api.octodamus.com, paid per call via x402, $5/call, status unknown (last checked 2026-09-14).

Subscribe an HTTPS endpoint to receive real-time Octodamus market signal events (new signals, resolved signals, Polymarket edges) via webhook POST callbacks.

## Facts

- Endpoint: POST https://api.octodamus.com/v2/webhooks/subscribe
- Price: $5/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/octodamus-webhook-subscription-25358a78
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_NQD3GY52C2ICNqtsqshlr

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability octodamus-webhook-subscription-25358a78 -d '<json body>'
```

Example prompt: 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.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/octodamus-webhook-subscription-25358a78/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.octodamus.com](https://www.zero.xyz/host/api.octodamus.com/llms.txt)