ClawNet

Ask a question in plain English. Get data from 13,000+ APIs in one call. ClawNet figures out which data sources to query, runs them in parallel, and gives you one clean answer.

Quick Start

CODEBLOCK0

CODEBLOCK1

That's it. One question in, one answer out.

Setup (3 options)

Option A: API Key (most common)

1. 1. Get a key at https://claw-net.org/dashboard
2. Set CLAWNET_API_KEY in your environment
3. Base URL: INLINECODE1

Option B: x402 / USDC (no account needed)
Pay per call with USDC on Base. No API key, no signup. Your wallet-equipped agent just calls the endpoint and pays automatically.
CODEBLOCK2

Option C: MCP (for AI coding tools)
Connect ClawNet as an MCP server in Claude Code, Cursor, VSCode, or Windsurf:
CODEBLOCK3

Data Skills (4 built-in)

Pre-built skills that return structured JSON. No LLM involved — fast and cheap:

Skill	Cost	What you get
INLINECODE2	1 credit ($0.001)	Real-time price, 24h change, volume, market cap
INLINECODE3

2 credits ($0.002) | Top trending tokens by volume and social buzz |
| whale-tracker-data | 2 credits ($0.002) | Large holder movements, net flow, holder changes |
| defi-yield-data | 2 credits ($0.002) | DeFi yield opportunities, APY, TVL, risk tier |

CODEBLOCK4

How to Use ClawNet

Step 1: Browse (free, no auth)

See what's available without an API key:

CODEBLOCK5

Step 1b: Search & estimate (free, but needs API key)

CODEBLOCK6

Step 2: Ask (uses credits)

Send a natural language query. ClawNet's LLM picks the best endpoints, runs them in parallel, and synthesizes the answer:

CODEBLOCK7

Every response includes cryptographic proof of where the data came from (see Provenance below).

Step 3: Call directly (after discovery)

Once you know which skill you need, skip the LLM routing and call it directly — faster and cheaper:

CODEBLOCK8

Step 4: Come back when needs change

The registry updates every 4 hours with new endpoints from 7 discovery sources. New question? New data need? Use /v1/orchestrate again to discover the right endpoints.

Verify Data (optional)

Cross-reference any answer against independent sources before acting on it:

CODEBLOCK9

Tiers: quick (0.5 credits), standard (2 credits), deep (5 credits).

All Endpoints

Free (no auth needed)

Endpoint	What it does
INLINECODE10	Browse the skill catalog
INLINECODE11

Skill details, input schema, pricing | | GET /v1/soma/:did/trust | Check any agent's verification history | | GET /v1/soma/:did/verdicts | Recent verification verdicts for an agent | | GET /.well-known/soma.json | ClawNet's cryptographic identity |

Requires API key (but no credit cost)

Endpoint	What it does
INLINECODE15	Semantic search for skills by topic
INLINECODE16

Preview cost before running a query | | GET /v1/balance | Check your credit balance |

Paid (API key or x402)

Endpoint	Cost	What it does
INLINECODE18	2+ credits	Natural language query across 13,000+ sources
INLINECODE19

1-2 credits | Query a data skill (structured JSON) | | POST /v1/skills/:id/invoke | varies | Invoke a skill directly with variables | | POST /v1/manifest | 0.5-5 credits | Cross-reference data against independent sources |

Pricing

1 credit = $0.001. Credits never expire. Buy at https://claw-net.org (Stripe or USDC).

A typical orchestration query costs 2-10 credits ($0.002-$0.01). Data skills cost 1-2 credits each.

Endpoint Discovery

ClawNet doesn't just have a static list of APIs. It auto-discovers new endpoints every 4 hours from 7 sources:

Source	Endpoints
Built-in registry	274 curated
ClawAPIs

Dynamic providers |
| 402index | 15,000+ community directory |
| Coinbase Bazaar | Official x402 discovery |
| Zauth | Pre-verified (only WORKING status) |
| Dexter | Facilitator marketplace |
| x402list | 17,000+ services |

When you ask a question, ClawNet searches across all of these to find the best data source.

Provenance

Every response is cryptographically signed. You don't have to trust ClawNet — you can verify.

What this means in practice: Each response includes proof of what data was fetched, from where, and that it hasn't been tampered with. This happens automatically — no extra steps needed.

Response headers (on every orchestration and x402 response):
CODEBLOCK10

Want to go deeper?

• - GET /.well-known/soma.json — ClawNet's full cryptographic identity
• INLINECODE23 — verification history for any agent (free, public)
• Install soma-sense to independently verify ClawNet's model usage via MCP
• Read the Soma paper for the full protocol

On-chain identity: ClawNet (36119) and Soma (37696) are registered on Base Mainnet via ERC-8004.

Error Codes

Code	Status	Meaning
INLINECODE24	402	Out of credits — buy more or use x402
INLINECODE25

401 | Bad or missing API key | | RATE_LIMITED | 429 | Too many requests — wait and retry | | SOURCE_ERROR | 502 | Upstream data source failed — try again |