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:

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:

1. Reads the payment requirements from the 402 response 2. Signs a USDC payment on Base Mainnet 3. Retries the request with the PAYMENT-SIGNATURE header 4. 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\nOverall: Bullish\n\n## Project Mentions\n\n- Project: Context"
    },
    "transcript": {
      "format": "markdown",
      "content": "# Transcript\n\nSpeaker 1 [00:01:26 - 00:01:49]\n> Spoken text here...\n\nSpeaker 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

Ideas for Agents

Health Check

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

Returns: {"status": "ok"}

Built by VAIL — Voice AI Layer

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:

1. Reads the payment requirements from the 402 response 2. Signs a USDC payment on Base Mainnet 3. Retries the request with the PAYMENT-SIGNATURE header 4. 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\nOverall: Bullish\n\n## Project Mentions\n\n- Project: Context"
    },
    "transcript": {
      "format": "markdown",
      "content": "# Transcript\n\nSpeaker 1 [00:01:26 - 00:01:49]\n> Spoken text here...\n\nSpeaker 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.