Docs/API Reference

API Reference

The Claw0x Gateway exposes a single endpoint for calling any skill. All billing, routing, and error handling is managed for you.

Base URL

https://api.claw0x.com

Authentication

All requests require an API key in the Authorization header. Generate a key from your Dashboard → API Keys.

Authorization: Bearer atom_YOUR_API_KEY

Keys are prefixed with atom_ and shown only once at creation time. Store securely.

Call a Skill

POST /v1/call

Request Body

{
  "skill_id": "scrape",   // Skill slug or UUID
  "input": {                        // Skill-specific parameters
    "url": "https://example.com"
  }
}

Example Request

curl -X POST https://api.claw0x.com/v1/call \
  -H "Authorization: Bearer atom_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "skill_id": "scrape",
    "input": {
      "url": "https://news.ycombinator.com"
    }
  }'

Success Response (200)

{
  "success": true,
  "data": {
    "title": "Hacker News",
    "items": [...]
  },
  "metadata": {
    "skill_id": "scrape",
    "response_time_ms": 210,
    "price_paid": 0.005
  }
}

Error Codes

All errors return a JSON body with success: false and an error message.

{
  "success": false,
  "error": "Insufficient balance. Please top up your wallet."
}

401

Unauthorized

Invalid or missing API key. Check your Authorization header.

402

Payment Required

Insufficient USDC balance. Add funds to continue.

404

Not Found

Skill does not exist. Check the skill_id slug.

429

Too Many Requests

Rate limit exceeded. Wait before retrying or contact support for higher limits.

502

Skill Error

The skill backend failed. You are not charged for failed calls.

Pricing & Billing

Pay-Per-Call

Each skill has a fixed price per call, typically $0.001 – $0.50. You only pay for successful calls.

Atomic Billing

USDC is deducted from your balance instantly after each successful call. No subscriptions, no monthly fees.

Zero Cost on Failure

If a skill returns a 5xx error, you are not charged. The cost field in metadata will be 0.

Platform Fee

10% platform fee is included in the displayed price. Sellers receive 90% of each call's revenue.

Need to add funds? See the Wallet Funding Guide for 3 deposit methods.

Rate Limits

Default100 calls/min

Per-skill limitVaries by skill

Need higher limits? Contact support@claw0x.com.

Next Steps

SDKs — Use a client library instead of raw HTTP

Quick Start — End-to-end walkthrough in 5 minutes

Browse Skills — Find the right skill for your use case