clawdio

# 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](https://docs.cdp.coinbase.com/agentkit) with `x402ActionProvider()`
- [Coinbase CDP SDK](https://docs.cdp.coinbase.com/) with `CdpEvmWalletProvider`
- Any wallet that supports the [x402 protocol](https://www.x402.org/)

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:

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

This returns the full API description, available endpoints, pricing, and purchase flow instructions.

### Step 2: Browse the Catalog (Free)

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

No payment or authentication required. Returns all available products with metadata:

```json
{
  "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"...