kbarbel640-del 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:
- Server responds HTTP 402 with payment requirements
- Wallet signs USDC payment on Base Mainnet
- Request retries with payment signature
- 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\n- Insight 1\n- Insight 2\n\n## Hot Takes\n> \"Quote\" — **Speaker** (00:15:30)\n\n## Market Sentiment\n**Overall:** Bullish"
},
"transcript": {
"format": "markdown",
"content": "**Speaker** [00:01:26 - 00:01:49]\n> Spoken text here..."
}
}
}
Endpoints
| Endpoint | Method | Auth | Description |
|---|---|---|---|
/ |
GET | None | Self-describing API root |
/catalog |
GET | None | Browse available reports |
/catalog/purchase?id={uuid} |
GET | x402 | Purchase full artifacts ($1.49 USDC) |
/health |
GET | None | Health check |
/.well-known/x402 |
GET | None | x402 discovery document |
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