{"uid":"cap_5kvxPQMCkxjScY_W_y5uS","slug":"api-seerium-xyz-976bc072","name":"Seerium News Catalyst to Prediction-Market Links Feed","description":"Crypto and prediction market intelligence through x402.","url":"https://api.seerium.xyz/v1/pulse/catalysts","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","properties":{"limit":{"type":"number","minimum":1,"description":"Optional maximum news catalyst to prediction-market links to return."},"source":{"type":"string","description":"Optional news provider or prediction-market source filter."},"tickers":{"type":"string","description":"Optional comma-separated crypto tickers such as BTC,ETH,SOL."},"minConfidence":{"type":"number","minimum":0,"description":"Optional minimum catalyst link confidence."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"data":{"criteria":{"limit":3,"source":null,"tickers":[],"minConfidence":null},"returned":1,"catalysts":[{"id":"pulse:headline_1","news":{"id":"headline_1","tags":["news","crypto"],"status":"fresh","summary":"Macro-sensitive crypto headlines from cached pulse sources.","tickers":["BTC"],"headline":"Bitcoin volatility rises ahead of CPI print","provider":"coindesk","publishedAt":"2026-03-25T11:58:00.000Z"},"impact":{"url":"https://polymarket.com/event/will-btc-close-above-110k-this-week","score":0.92,"source":"polymarket","spread":0.02,"yesAsk":0.49,"yesBid":0.47,"urgency":"soon","question":"Will BTC close above $110k this week?","liquidity":390000,"volume24h":1200000,"confidence":0.88,"marketSlug":"will-btc-close-above-110k-this-week","hoursToClose":61.5,"matchedTokens":["BTC","bitcoin"],"probabilityMidpoint":0.48},"reasons":["matchedTokens=BTC,bitcoin","linkConfidence=0.88","urgency=soon"],"catalystScore":84.2,"freshnessMinutes":4.5}],"totalLinkedItems":10},"meta":{"requestId":"req_example_123","updatedAt":"2026-03-25T11:59:30.000Z","freshnessMs":30000,"generatedAt":"2026-03-25T12:00:00.000Z"},"product":{"id":"pulse-catalysts","name":"Prediction Market Catalyst Signals","path":"/v1/pulse/catalysts","price":"$0.1000","method":"GET","accepts":[{"payTo":"0x81832eEDe3a4ad96CB3D7cA09977636D912fd3D5","price":"$0.1000","scheme":"exact","network":"eip155:8453"},{"payTo":"2h752kAbb9z1jpdSzqMEYg9JHv6TPJ6T2BfAJMyjLFtZ","price":"$0.1000","scheme":"exact","network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"}],"networks":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"]},"service":"seerium-x402-api"}},"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"limit":5,"tickers":"BTC,ETH","minConfidence":0.5}}},"response":{"data":{"criteria":{"limit":5,"source":null,"tickers":["BTC","ETH"],"minConfidence":0.5},"returned":0,"catalysts":[],"totalLinkedItems":15},"meta":{"returned":0,"requestId":"9a5753b0-da02-4384-822d-fe47aade86ab","updatedAt":"2026-06-18T04:54:45.724Z","freshnessMs":369977,"generatedAt":"2026-06-18T05:00:55.701Z","matchedCatalysts":0,"totalLinkedItems":15},"product":{"id":"pulse-catalysts","name":"Prediction Market Catalyst Signals","path":"/v1/pulse/catalysts","price":"$0.0060","method":"GET","accepts":[{"payTo":"0x81832eEDe3a4ad96CB3D7cA09977636D912fd3D5","price":"$0.0060","scheme":"exact","network":"eip155:8453"},{"payTo":"2h752kAbb9z1jpdSzqMEYg9JHv6TPJ6T2BfAJMyjLFtZ","price":"$0.0060","scheme":"exact","network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"}],"networks":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"]},"service":"seerium-x402-api"}},"exampleRequest":{"limit":5,"tickers":"BTC,ETH","minConfidence":0.5},"tags":["x402"],"displayCostAmount":"0.006","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.006/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_YRgR4ZkqMhtZGcqYYwM3C","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.1","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns ranked, confidence-scored links between breaking news catalysts and related prediction markets, with freshness, urgency, liquidity, and probability context for crypto tickers.","exampleAgentPrompt":"Pull me the top 10 ranked news catalyst links to prediction markets for BTC, ETH, and SOL right now — only return ones with a confidence above 0.7, using Seerium's pulse catalysts feed.","exampleUseCases":[{"title":"Monitor active prediction market moves","prompt":"I need to know which breaking news events are driving the biggest prediction market reactions right now for crypto. Show me the highest-confidence catalyst links with urgency indicators so I can spot which markets are actually moving because of real news."},{"title":"Find high-conviction arbitrage opportunities","prompt":"Pull catalyst-to-market links where there's a big gap between fresh news confidence and current market probability — I'm looking for high-liquidity prediction markets where the probability hasn't caught up to the news catalyst yet."},{"title":"Track macro events impacting crypto","prompt":"Give me all the recent macro news catalysts linked to Bitcoin and Ethereum prediction markets, sorted by freshness and confidence. I want to see which major economic or regulatory events are actively connected to probability shifts in the markets right now."}],"resultDescription":"A ranked list of news catalyst-to-prediction-market link objects, each containing the catalyst headline, associated prediction market, confidence score, freshness indicator, urgency level, liquidity context, and current probability — filtered and sorted according to the query parameters provided.","failureModes":["Invalid ticker symbol returns empty results or 400 error","minConfidence value outside 0–1 range triggers schema validation error","Unknown source filter returns no results","limit below minimum (1) returns error","Payment not attached or insufficient USDC triggers 402 Payment Required","No catalysts currently matching filters returns empty array"],"whenToPreferThis":"Use this endpoint when you need to connect real-world news events to prediction market opportunities with confidence and urgency scoring — especially for crypto-focused catalysts (BTC, ETH, SOL) where you want ranked, actionable links rather than raw news or raw market data separately.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:53:23.001Z","isFirstParty":false}