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#

bash

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?"}'

json

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

bash

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:

json

{
  "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:

SkillCostWhat you getprice-oracle-data1 credit ($0.001)Real-time price, 24h change, volume, market captrending-tokens-data2 credits ($0.002)Top trending tokens by volume and social buzzwhale-tracker-data2 credits ($0.002)Large holder movements, net flow, holder changesdefi-yield-data2 credits ($0.002)DeFi yield opportunities, APY, TVL, risk tierbash

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:

bash

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

bash

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

bash

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:

bash

# 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 again to discover the right endpoints.

Verify Data (optional)#

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

bash

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 (0.5 credits), standard (2 credits), deep (5 credits).

All Endpoints#

Free (no auth needed)#

EndpointWhat it doesGET /v1/marketplace/skillsBrowse the skill catalogGET /v1/marketplace/skills/:idSkill details, input schema, pricingGET /v1/soma/:did/trustCheck any agent's verification historyGET /v1/soma/:did/verdictsRecent verification verdicts for an agentGET /.well-known/soma.jsonClawNet's cryptographic identity

Requires API key (but no credit cost)#

EndpointWhat it doesPOST /v1/discoverSemantic search for skills by topicGET /v1/estimate?query=...Preview cost before running a queryGET /v1/balanceCheck your credit balance

Paid (API key or x402)#

EndpointCostWhat it doesPOST /v1/orchestrate2+ creditsNatural language query across 13,000+ sourcesGET /v1/skills/:id/query1-2 creditsQuery a data skill (structured JSON)POST /v1/skills/:id/invokevariesInvoke a skill directly with variablesPOST /v1/manifest0.5-5 creditsCross-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:

SourceEndpointsBuilt-in registry274 curatedClawAPIsDynamic providers402index15,000+ community directoryCoinbase BazaarOfficial x402 discoveryZauthPre-verified (only WORKING status)DexterFacilitator marketplacex402list17,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):

text

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#

CodeStatusMeaningINSUFFICIENT_CREDITS402Out of credits — buy more or use x402INVALID_API_KEY401Bad or missing API keyRATE_LIMITED429Too many requests — wait and retrySOURCE_ERROR502Upstream data source failed — try again