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)

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

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

2. Purchase a Report

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

{
  "id": "c6d36398-a0c8-4c21-9aa4-1d1d9084a820",
  "transaction": "0x1234...abcd",
  "title": "AI & Crypto Twitter Space",
  "date": "2025-01-15",
  "length": "01:23:45",
  "listeners": 1234,
  "participants": {
    "hosts": [{ "display_name": "Host", "screen_name": "host_handle" }],
    "speakers": [{ "display_name": "Speaker", "screen_name": "speaker_handle" }]
  },
  "content": {
    "report": {
      "format": "markdown",
      "content": "## Key Insights\
- Insight 1\
- Insight 2\
\
## Hot Takes\
> \"Quote\" — **Speaker** (00:15:30)\
\
## Market Sentiment\
**Overall:** Bullish"
    },
    "transcript": {
      "format": "markdown",
      "content": "**Speaker** [00:01:26 - 00:01:49]\
> Spoken text here..."
    }
  }
}

Endpoints

Important Notes

• Purchase endpoint uses GET, not POST
• Payment is USDC on Base Mainnet only (eip155:8453)
• Save responses — repeat access requires repurchase
• No authentication or accounts required

Agent Use Cases

• Trading signals: Extract sentiment and alpha from live market discussions
• Research synthesis: Cross-reference insights across multiple Spaces
• Network mapping: Build speaker graphs from participant data
• Trend detection: Track project mentions and sentiment over time
• Quote attribution: Source specific claims to named speakers with timestamps

Integration

For code examples with Coinbase AgentKit and @x402/fetch, see references/INTEGRATION.md.

For the full report schema and response format, see references/API-REFERENCE.md.

Roadmap

Clawdio is in early release with a curated catalog of AI and crypto Twitter Spaces. Coming soon:

• Analyze any Space — Submit any Twitter Spaces link to generate artifacts on demand
• Massive catalog — 10,000+ browseable Spaces across crypto, AI, tech, and markets
• Semantic search — Find Spaces by topic, speaker, project, or sentiment
• Real-time ingestion — Live Spaces processed as they happen

Built by VAIL — Voice AI Layer