{"uid":"cap_25emIJZ8b6s_0ZDCduo6o","slug":"market-intelligence-api-alert-subscription-webhook-push-01417dbb","name":"Market Intelligence API – Alert Subscription (Webhook Push)","description":"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.","url":"https://api.marketintelligenceapi.com/api/v1/alerts/subscriptions?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"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}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.5","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.5/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.5","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.5","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_3ycZB4x0mo6QxYQJe8kpG","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.5","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"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.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Crypto trading bot signal feed","prompt":"Subscribe my trading bot at https://bot.myserver.io/webhooks to receive unusual_flow and decision_change alerts for BTCUSD and ETHUSD for the next 7 days — only send me signals with materiality 4 or higher so I'm not flooded with noise."},{"title":"DeFi token risk monitoring","prompt":"Set up a push alert subscription to https://defi-monitor.myapp.com/hooks that watches for token_risk_change and stablecoin_depeg events on these Base chain tokens: 0xabc123 and 0xdef456 — I want real-time webhook pings rather than polling for the whole week."},{"title":"Material news alerting for tokenized stocks","prompt":"Create a webhook subscription sending news alerts to https://newsdesk.mytradingco.com/inbound for the symbols TSLA and NVDA, categories stocks and filings, minimum materiality 5, so my team gets pushed notifications the moment material news drops."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-14T18:48:58.045Z","isFirstParty":false,"canonicalSlug":"market-intelligence-api-alert-subscription-webhook-push-01417dbb"}