{"uid":"cap_5rUbSZQs6Dvn3cW3Fc5Vq","slug":"agent-desk-api-event-facts-3419e9f6","name":"Agent Desk API: Event Facts","description":"Verified market-moving events for crypto agents: headlines categorized (liquidations, macro, regulation and more) and tagged to BTC/ETH, each with source, publisher, timestamp, original link, and a trust tier distinguishing primary official sources from aggregated headlines. Filter by symbol, category, and count. Fresh every 15 minutes.","url":"https://deskfeed.dev/v1/events?utm_source=zero.xyz","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":"integer","default":10,"maximum":50,"minimum":1,"description":"Max events to return"},"symbol":{"type":"string","description":"Filter events by symbol, e.g. BTCUSDT"},"category":{"type":"string","description":"Filter by category (e.g. LIQUIDATION, MACRO, REGULATION)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["as_of","data_age_seconds","availability","source_status","events","disclaimer"],"properties":{"as_of":{"type":"string","description":"Observation time (ISO 8601 UTC)"},"events":{"type":"array","description":"Deduplicated event facts (newest first)"},"disclaimer":{"type":"string","description":"Informational-use notice"},"availability":{"type":"string","description":"Pipeline availability state (e.g. AVAILABLE)"},"source_status":{"type":"array","description":"Per-source ingestion status records"},"data_age_seconds":{"type":"integer","description":"Age of upstream data in seconds"}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_MjoHqSYrQcjmirfJ9HX0N","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns verified, categorized market-moving crypto events (liquidations, macro, regulation, etc.) tagged to BTC/ETH with source, publisher, timestamp, and original link","exampleAgentPrompt":"Pull the latest 20 crypto market-moving events from Agent Desk filtered to BTCUSDT, focusing on REGULATION and MACRO categories, and show me the headline, source, and timestamp for each.","exampleUseCases":[{"title":"Real-time liquidation monitoring for BTC","prompt":"Fetch the 10 most recent liquidation events for BTCUSDT from Agent Desk so I can see if there have been any major forced sells in the last few hours."},{"title":"Macro news briefing for crypto agent","prompt":"Get me the latest 15 macro category events tagged to crypto from Agent Desk, including the publisher and original link for each one, so my trading agent can factor in macro conditions."},{"title":"Regulation event feed for ETH compliance alerts","prompt":"Pull up to 25 regulation events for ETHUSDT from Agent Desk — I need the headline, timestamp, and source URL for each so I can track any new policy developments affecting Ethereum."}],"resultDescription":"A list of crypto market events, each containing: the event headline, category label (e.g. LIQUIDATION, MACRO, REGULATION), associated symbol (e.g. BTCUSDT, ETHUSDT), source name, publisher, ISO timestamp, and a link to the original article or announcement. Up to 50 events per call, filterable by symbol and category.","failureModes":["Invalid category string returns empty result or 400 error","Symbol not recognized returns no results","Limit exceeds maximum of 50, causing validation error","Payment not processed (x402 protocol failure) returns 402 Payment Required","No events available in given category/symbol combination returns empty array","Rate limiting or service unavailability returns 5xx error"],"whenToPreferThis":"Choose this endpoint when an agent needs structured, pre-categorized, verified crypto market events (not raw news scraping) tagged to specific symbols like BTC or ETH. Ideal when the agent needs reliable source attribution, timestamps, and original links alongside headlines. Prefer over generic news APIs when crypto-specific categorization (LIQUIDATION, MACRO, REGULATION) is important for downstream trading or risk logic.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-14T06:35:18.285Z","isFirstParty":false,"canonicalSlug":"agent-desk-api-event-facts-3419e9f6"}