# aiworker-data Brief

> aiworker-data Brief is a paid API for AI agents from aiworker.duckdns.org, paid per call via x402, $0.1/call, status unknown (last checked 2026-09-14).

Generates a 150-500 word sourced brief on any topic in Markdown, with paragraph-level citations and verbatim key-fact quotes verified against fetched pages.

## Facts

- Endpoint: POST https://aiworker.duckdns.org/v1/brief/topic
- Price: $0.1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/aiworker-data-brief-1e02a847
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_-7VlAJOoAZ0fVDPUsVIX3

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 aiworker-data-brief-1e02a847 -d '<json body>'
```

Example prompt: Give me a sourced brief on 'Base layer 2 stablecoin liquidity' — up to 300 words, with paragraph citations and verbatim key-fact quotes — pulling from https://defillama.com/stablecoins and https://base.org/ecosystem as extra sources.

## When to prefer this

Choose this endpoint when you need a verifiably sourced, citation-rich brief rather than a raw LLM answer — especially when you want to supply your own authoritative URLs and need every key claim backed by a verbatim quote found in the actual page text. It is ideal for research digests, due diligence summaries, and agent-generated reports where hallucination risk must be minimized. Prefer alternatives if you need real-time data, structured data extraction, or a plain-text scrape without synthesis.

## Known failure modes

- Source URL is inaccessible or returns non-200 — that source is skipped or marked ok:false
- Topic is empty or exceeds 200 characters — request rejected
- No verifiable verbatim quotes found — key_facts array may be empty
- All provided URLs are unreachable — brief may rely solely on Wikipedia
- max_words out of range (below 150 or above 500) — validation error
- Payment not included or insufficient — 402 Payment Required

## How this service works

Deterministic-first data for agents, paid per call in USDC over x402 v2: DeFi yields, Base token and wallet cards, Polymarket odds and backtests, news, fact checks, cited briefs. 20 routes, $0.005-$1

## Output

A JSON object containing: a Markdown brief (150-500 words) where every paragraph cites its source pages by ID; an array of key_facts each with a verbatim quote and the URL it was found in; a sources array listing each fetched page with its title and character count; token usage counts; word count; and a disclaimer. Only quotes found verbatim in the fetched pages are included.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "topic": {
   "type": "string",
   "maxLength": 200,
   "minLength": 1,
   "description": "the topic to brief, as a phrase of at most 200 characters; not a url"
  },
  "sources": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "maxItems": 5,
   "description": "up to 5 public https urls to brief from, in addition to Wikipedia"
  },
  "max_words": {
   "type": "integer",
   "maximum": 500,
   "minimum": 150,
   "description": "maximum words in the brief; default 300"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "model": "mimo-v2.5",
  "route": "POST /v1/brief/topic",
  "topic": "Base layer 2 stablecoin liquidity",
  "sources": [
   {
    "id": "1",
    "ok": true,
    "url": "https://example.com/report",
    "kind": "buyer",
    "chars": 7400,
    "title": "Report"
   },
   {
    "id": "2",
    "ok": true,
    "url": "https://en.wikipedia.org/wiki/Base_(network)",
    "kind": "wikipedia",
    "chars": 8000,
    "title": "Base (network)"
   }
  ],
  "version": 1,
  "brief_md": "Base is an Ethereum layer two network incubated by Coinbase [2]. Stablecoin liquidity on it grew through 2026 [1].",
  "key_facts": [
   {
    "fact": "Base is an Ethereum layer two network.",
    "quote": "Base is an Ethereum layer two network incubated by Coinbase",
    "source_url": "https://en.wikipedia.org/wiki/Base_(network)"
   }
  ],
  "max_words": 300,
  "tokens_in": 5200,
  "disclaimer": "Sourced from the pages listed; not advice.",
  "tokens_out": 640,
  "word_count": 18
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/aiworker-data-brief-1e02a847/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from aiworker.duckdns.org](https://www.zero.xyz/host/aiworker.duckdns.org/llms.txt)