扫码联系在线客服Clawdio — Auditory Intelligence for AI Agents
Clawdio, powered by VAIL (Voice AI Layer), gives AI agents auditory perception by transforming long-form human audio into structured data, semantic reports, and machine-readable markdown.
Agents interact with an x402 payment-gated API to ingest spoken conversations as first-class inputs — just like text, price feeds, or alternative data sources.
Initial deployment focuses on AI and Crypto Twitter Spaces, where high-signal market intelligence exists primarily in voice.
Base URL: https://clawdio.vail.report
Protocol: x402
Network: Base Mainnet (eip155:8453)
Currency: USDC
Price: $1.49 per report
Requirements
You need an x402-compatible wallet funded with USDC on Base Mainnet. Compatible wallet providers include:
- Coinbase AgentKit with
x402ActionProvider() - Coinbase CDP SDK with
CdpEvmWalletProvider - Any wallet that supports the x402 protocol
The x402 payment is handled automatically via the PAYMENT-SIGNATURE header — your wallet provider manages the signing and settlement. You do not need to construct payment transactions manually.
Quick Start
Step 1: Understand the API
Visit the API root to get a self-describing overview:
curl https://clawdio.vail.report/
This returns the full API description, available endpoints, pricing, and purchase flow instructions.
Step 2: Browse the Catalog (Free)
curl https://clawdio.vail.report/catalog
No payment or authentication required. Returns all available products with metadata:
{
"products": [
{
"id": "c6d36398-a0c8-4c21-9aa4-1d1d9084a820",
"title": "AI & Crypto Twitter Space",
"abstract": "Analysis of a discussion covering...",
"date": "2025-01-15",
"length": "01:23:45",
"listeners": 1234,
"purchase": {
"url": "https://clawdio.vail.report/catalog/purchase?id=c6d36398-a0c8-4c21-9aa4-1d1d9084a820",
"method": "GET",
"protocol": "x402",
"price": "1.49 USDC"
}
}
],
"total": 15,
"purchase_instructions": {
"steps": [
"Select a product from the list above",
"Make an HTTP GET request to the product's purchase.url",
"Your x402-compatible wallet handles payment automatically",
"You receive the full artifact set (metadata + report + transcript)"
],
"important": "The purchase endpoint uses GET, not POST. Save the artifacts — repurchase is required for repeat access."
}
}
Step 3: Purchase a Report ($1.49 USDC)
curl https://clawdio.vail.report/catalog/purchase?id={uuid}
Important: This is a GET request, not POST.
On first request without payment, the server returns HTTP 402 Payment Required with a PAYMENT-REQUIRED header. Your x402 wallet automatically:
- Reads the payment requirements from the 402 response
- Signs a USDC payment on Base Mainnet
- Retries the request with the
PAYMENT-SIGNATUREheader - Receives the full content after payment settles
What You Get
Each purchase returns a JSON object with three artifact layers (metadata + report + transcript):
{
"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 Name",
"screen_name": "host_handle",
"avatar_url": "https://..."
}
],
"speakers": [
{
"display_name": "Speaker Name",
"screen_name": "speaker_handle",
"avatar_url": "https://..."
}
]
},
"content": {
"report": {
"format": "markdown",
"content": "## Abstract\n\nAnalysis of the Twitter Space...\n\n## Key Insights\n\n- ...\n\n## Hot Takes\n\n> \"Quote\" — **Speaker** (timestamp)\n\n## Timeline\n\n- ...\n\n## Potential Alpha\n\n- ...\n\n## Market Sentiment\n\n**Overall:** Bullish\n\n## Project Mentions\n\n- **Project**: Context"
},
"transcript": {
"format": "markdown",
"content": "# Transcript\n\n**Speaker 1** [00:01:26 - 00:01:49]\n> Spoken text here...\n\n**Speaker 2** [00:01:50 - 00:02:15]\n> Response text here..."
}
}
}
Artifact 1 — Metadata: Title, date, duration, listener count, full participant list with Twitter handles and avatars.
Artifact 2 — Report (Markdown): Structured analysis including abstract, key insights, hot takes with attribution, timeline of events, potential alpha, market sentiment, and project mentions.
Artifact 3 — Transcript (Markdown): Full speaker-attributed transcript with timestamps. Every utterance has speaker name, timestamp range, and verbatim content.
Report Schema
The report markdown contains these sections (when available):
| Section | Description | |---------|-------------| | Abstract | Summary paragraphs of the entire Space | | Key Insights | Bullet list of the most important takeaways | | Hot Takes | Notable quotes with speaker attribution and timestamps | | Timeline | Chronological events with significance notes | | Potential Alpha | Actionable intelligence and forward-looking signals | | Market Sentiment | Overall sentiment assessment with notes | | Project Mentions | Named projects/tokens discussed with context |
Complete Purchase Flow
Agent Clawdio Facilitator
| | |
| GET /catalog | |
|------------------------------>| |
| 200 OK (product list) | |
|<------------------------------| |
| | |
| GET /catalog/purchase?id=... | |
|------------------------------>| |
| 402 Payment Required | |
| (PAYMENT-REQUIRED header) | |
|<------------------------------| |
| | |
| [wallet signs USDC payment] | |
| | |
| GET /catalog/purchase?id=... | |
| (PAYMENT-SIGNATURE header) | |
|------------------------------>| |
| | verify + settle payment |
| |----------------------------->|
| | settlement confirmation |
| |<-----------------------------|
| 200 OK | |
| (full artifacts + tx hash) | |
|<------------------------------| |
Endpoints
| Endpoint | Method | Auth | Description |
|----------|--------|------|-------------|
| / | GET | None | Self-describing API root with full documentation |
| /catalog | GET | None | Browse all available products with metadata |
| /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 |
Using with Coinbase AgentKit
If you use Coinbase AgentKit, the x402 payment flow is fully automatic:
import { AgentKit, CdpEvmWalletProvider, walletActionProvider, x402ActionProvider } from "@coinbase/agentkit";
const walletProvider = await CdpEvmWalletProvider.configureWithWallet({
apiKeyId: process.env.CDP_API_KEY_ID,
apiKeySecret: process.env.CDP_API_KEY_SECRET,
walletSecret: process.env.CDP_WALLET_SECRET,
address: YOUR_WALLET_ADDRESS,
networkId: "base-mainnet",
});
const agentKit = await AgentKit.from({
walletProvider,
actionProviders: [walletActionProvider(), x402ActionProvider()],
});
// The agent can now browse and purchase from Clawdio automatically.
// Point it at https://clawdio.vail.report/ and it will self-discover the API.
Using with @x402/fetch
For direct programmatic access without AgentKit:
import { wrapFetch } from "@x402/fetch";
const x402Fetch = wrapFetch(globalThis.fetch, walletClient);
// Browse catalog (free)
const catalog = await fetch("https://clawdio.vail.report/catalog").then(r => r.json());
// Purchase a report (x402 handles payment automatically)
const report = await x402Fetch("https://clawdio.vail.report/catalog/purchase?id={uuid}")
.then(r => r.json());
Important Notes
- GET not POST: The purchase endpoint uses
GET. Do not send POST requests. - Base Mainnet only: Payment is in USDC on Base Mainnet (eip155:8453).
- Save your purchase: Artifacts are not stored for you. Repurchase is required for repeat access.
- No authentication: There are no API keys or accounts. Payment is the only gate.
Ideas for Agents
- Market intelligence: Analyze hot takes and sentiment for trading signals
- Research synthesis: Cross-reference insights across multiple Spaces
- Alpha extraction: Mine potential alpha section for actionable opportunities
- Network mapping: Build social graphs from participant lists across Spaces
- Trend detection: Track project mentions and sentiment over time
- Content curation: Quote and share notable insights on social platforms
Health Check
curl https://clawdio.vail.report/health
Returns: {"status": "ok"}
Built by VAIL — Voice AI Layer