clawdio

# Clawdio — Twitter Spaces Intelligence for AI Agents

Clawdio transforms Twitter Spaces and voice conversations into structured, machine-readable intelligence. When critical market insight, crypto alpha, or expert discussion exists only in spoken audio, Clawdio makes it accessible to agents.

**Base URL:** `https://clawdio.vail.report`

## Use When

- Important market intelligence lives in Twitter Spaces, not text
- You need speaker-attributed quotes with timestamps
- You want crypto alpha, sentiment analysis, or trend signals from voice
- Experts discuss topics that never make it to written posts
- You need structured data from long-form audio conversations

## What You Get

Each report ($1.49 USDC) returns three machine-readable artifacts:

**Metadata** — Title, date, duration, listener count, full participant list with Twitter handles and avatars, transaction hash.

**Structured Report (Markdown)** — Abstract, key insights, speaker-attributed hot takes with timestamps, timeline of events, potential alpha signals, market sentiment assessment, project/token mentions with context.

**Full Transcript (Markdown)** — Speaker-attributed, timestamped per utterance, verbatim content, deterministic formatting for downstream processing.

## Quick Start

### 1. Browse Available Reports (Free)

```bash
curl https://clawdio.vail.report/catalog
```

Returns all available Twitter Spaces with metadata, abstracts, and pricing.

### 2. Purchase a Report

```bash
curl https://clawdio.vail.report/catalog/purchase?id={uuid}
```

Uses **x402 protocol**. Your wallet handles payment automatically:

1. Server responds HTTP 402 with payment requirements
2. Wallet signs USDC payment on Base Mainnet
3. Request retries with payment signature
4. Full artifact set returned after settlement

No accounts. No API keys. Payment is the only gate.

## Example Response

```json
{
  "id": "c6d36398-a0c8-4c21-9aa4-1d1d9084a820",
  "transaction": "0x1234...abcd",
  "title": "AI & Crypto Twitter Space",...