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

curl -X POST https://api.claw-net.org/v1/orchestrate \
  -H "X-API-Key: $CLAWNET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "What is the price of SOL right now?"}'

{
  "answer": "SOL is currently trading at $148.23, up 3.2% in 24h. Volume: $2.1B...",
  "costBreakdown": { "creditsUsed": 8, "costUsd": 0.008 },
  "metadata": { "stepsExecuted": 3, "totalDurationMs": 1240 }
}

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

Setup (3 options)

Option A: API Key (most common)

1. Get a key at https://claw-net.org/dashboard
2. Set

   CLAWNET_API_KEY

   in your environment
3. Base URL:

   https://api.claw-net.org

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.

POST https://api.claw-net.org/x402/orchestrate
POST https://api.claw-net.org/x402/skills/{id}

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

{
  "mcpServers": {
    "clawnet": {
      "command": "npx",
      "args": ["tsx", "src/mcp/server.ts"],
      "env": { "CLAWNET_API_KEY": "your_key", "CLAWNET_BASE_URL": "https://api.claw-net.org" }
    }
  }
}

Data Skills (4 built-in)

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

price-oracle-data

trending-tokens-data

whale-tracker-data

defi-yield-data

curl "https://api.claw-net.org/v1/skills/price-oracle-data/query?token=SOL" \
  -H "X-API-Key: $CLAWNET_API_KEY"

How to Use ClawNet

Step 1: Browse (free, no auth)

See what's available without an API key:

# Browse the skill catalog
GET /v1/marketplace/skills

# Check a specific skill's input format and pricing
GET /v1/marketplace/skills/price-oracle-data

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

# Semantic search for skills by topic
POST /v1/discover  {"query": "solana token prices"}

# Preview cost before running a query
GET /v1/estimate?query=What is SOL worth?

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:

POST /v1/orchestrate  {"query": "Compare SOL vs ETH performance this week"}

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:

# With API key
POST /v1/skills/price-oracle-data/invoke  {"variables": {"token": "SOL"}}

# With USDC (no API key needed)
POST /x402/skills/price-oracle-data  {"variables": {"token": "SOL"}}

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

Verify Data (optional)

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

curl -X POST https://api.claw-net.org/v1/manifest \
  -H "X-API-Key: $CLAWNET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"tier": "standard", "verify": {"claims": [{"type": "price", "subject": "SOL", "value": 148.23}]}}'

Tiers:

quick

standard

deep

All Endpoints

Free (no auth needed)

GET /v1/marketplace/skills

GET /v1/marketplace/skills/:id

GET /v1/soma/:did/trust

GET /v1/soma/:did/verdicts

GET /.well-known/soma.json

Requires API key (but no credit cost)

POST /v1/discover

GET /v1/estimate?query=...

GET /v1/balance

Paid (API key or x402)

POST /v1/orchestrate

GET /v1/skills/:id/query

POST /v1/skills/:id/invoke

POST /v1/manifest

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:

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):

X-Soma-Protocol: soma/1.0
X-Soma-Data-Hash: <hash of the response data>
X-Soma-Signature: <cryptographic signature>
X-Soma-Model-Verified: true
X-Soma-Discovery: /.well-known/soma.json

Want to go deeper?

• GET /.well-known/soma.json

  — ClawNet's full cryptographic identity

• GET /v1/soma/:did/trust

  — 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

INSUFFICIENT_CREDITS

INVALID_API_KEY

RATE_LIMITED

SOURCE_ERROR