# Agent Desk API: Event Facts

> Agent Desk API: Event Facts is a paid API for AI agents from deskfeed.dev, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-14).

Returns verified, categorized market-moving crypto events (liquidations, macro, regulation, etc.) tagged to BTC/ETH with source, publisher, timestamp, and original link

## Facts

- Endpoint: GET https://deskfeed.dev/v1/events?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agent-desk-api-event-facts-3419e9f6
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_5rUbSZQs6Dvn3cW3Fc5Vq

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 agent-desk-api-event-facts-3419e9f6
```

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

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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.

## Request schema (JSON Schema)

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

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agent-desk-api-event-facts-3419e9f6/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from deskfeed.dev](https://www.zero.xyz/host/deskfeed.dev/llms.txt)