# Market Intelligence API – Alert Subscription (Webhook Push)

> Market Intelligence API – Alert Subscription (Webhook Push) is a paid API for AI agents from api.marketintelligenceapi.com, paid per call via x402, $0.5/call, status unknown (last checked 2026-10-14).

Creates a 7-day webhook subscription that pushes up to 200 signed alert deliveries to your HTTPS URL for crypto/stock market intelligence events including trade-flow anomalies, funding extremes, material news, and token risk changes.

## Facts

- Endpoint: POST https://api.marketintelligenceapi.com/api/v1/alerts/subscriptions?utm_source=zero.xyz
- Price: $0.5/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/market-intelligence-api-alert-subscription-webhook-push-01417dbb
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_25emIJZ8b6s_0ZDCduo6o

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 market-intelligence-api-alert-subscription-webhook-push-01417dbb -d '<json body>'
```

Example prompt: Set up a 7-day webhook subscription to https://my-trading-bot.example.com/alerts for unusual_flow, funding_extreme, and decision_change events on ETHUSD and BTCUSD, with a minimum materiality of 4, so I get pushed signals instead of having to poll.

## When to prefer this

Choose this endpoint when you need real-time push-based market intelligence without continuous polling — ideal for trading bots, automated risk monitors, or news-driven agents that must react within seconds to market events. Prefer this over polling endpoints when you want event-driven architecture, need to track up to 5 specific on-chain tokens or 25 symbols simultaneously, or when you want to receive Hyperliquid funding extremes or material news with a configurable materiality filter. The 7-day prepaid pack with up to 200 deliveries makes it cost-efficient for active monitoring windows.

## Known failure modes

- Invalid or unreachable HTTPS callback URL returns validation error
- Exceeding 5 watched tokens or 25 symbols returns schema validation error
- Unsupported event type enum value returns 422 unprocessable entity
- Payment failure or insufficient USDC balance (x402) prevents subscription creation
- Webhook delivery failures to the provided URL count against the 200-delivery quota
- Subscription expiry after 7 days stops all deliveries without renewal
- Invalid chain identifier for token address returns validation error

## How this service works

Crypto and stock alerts by webhook: one POST buys a 7-day pack of up to 200 signed deliveries to your HTTPS URL. Events: decision_change, unusual_flow, funding_extreme (Hyperliquid), material news, token_risk_change for up to 5 watched tokens, sec_filing (new Form 4, 8-K, 144, 13D/G of your tickers). Filter by symbols and forms. Use to get pushed instead of polling.

## Output

Returns a subscription confirmation object for a 7-day alert pack entitling up to 200 signed webhook POST deliveries to the provided HTTPS URL. Each delivered event is cryptographically signed and contains event type, symbol or token, signal details, and materiality score. Supported event types include decision_change, unusual_flow, funding_extreme (Hyperliquid), news, token_risk_change, and stablecoin_depeg.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "url": {
   "type": "string",
   "format": "uri",
   "description": "Public HTTPS URL that receives the signed POSTs"
  },
  "events": {
   "type": "array",
   "items": {
    "enum": [
     "decision_change",
     "unusual_flow",
     "funding_extreme",
     "news",
     "token_risk_change",
     "stablecoin_depeg",
     "sec_filing",
     "prediction_market_move"
    ],
    "type": "string"
   },
   "minItems": 1
  },
  "tokens": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "address"
    ],
    "properties": {
     "chain": {
      "enum": [
       "base",
       "ethereum",
       "arbitrum",
       "optimism",
       "polygon",
       "solana"
      ],
      "type": "string"
     },
     "address": {
      "type": "string"
     }
    }
   },
   "maxItems": 5,
   "description": "For token_risk_change: {address, chain}"
  },
  "symbols": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "maxItems": 25,
   "description": "Only these symbols (empty = all)"
  },
  "categories": {
   "type": "array",
   "items": {
    "enum": [
     "crypto",
     "stocks",
     "europe",
     "policy",
     "filings"
    ],
    "type": "string"
   }
  },
  "description": {
   "type": "string",
   "maxLength": 200
  },
  "minMateriality": {
   "type": "integer",
   "default": 4,
   "maximum": 5,
   "minimum": 1
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/market-intelligence-api-alert-subscription-webhook-push-01417dbb/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.marketintelligenceapi.com](https://www.zero.xyz/host/api.marketintelligenceapi.com/llms.txt)