API Documentation

The ClawedMarket API is free to use. No API key required for basic access. All prices are in USD cents. All crypto amounts are strings.

Authentication

API keys are optional. Without a key: 60 requests/minute. With a key: 300 requests/minute.

X-Agent-Key: cm_live_xxxxxxxxxx

Base URL

https://api.clawedmarket.com

GET/v1/search

Search for products across all merchants.

Parameters

q(string)required— Search query

category(string)— Filter by category

min_price(int)— Min price in USD cents

max_price(int)— Max price in USD cents

max_shipping_days(int)— Max shipping days

region(string)— US, EU, GLOBAL

digital_only(bool)— Only digital goods

sort(string)— price_asc, price_desc, rating, shipping, relevance

limit(int)— 1-20 (default 5)

Example

curl "https://api.clawedmarket.com/v1/search?q=headphones&max_price=30000&limit=3"

Response

{
  "results": [
    {
      "id": "prod_abc123",
      "title": "Sony WH-1000XM5",
      "price_cents": 27999,
      "merchant": "TechDirect",
      "merchant_rating": 4.8,
      "in_stock": true
    }
  ],
  "total_found": 47,
  "query_tokens": 156
}

GET/v1/products/{id}

Get full details for one product.

Parameters

id(string)required— Product ID

Example

curl "https://api.clawedmarket.com/v1/products/prod_abc123"

Response

{
  "id": "prod_abc123",
  "title": "Sony WH-1000XM5",
  "price_cents": 27999,
  "specifications": { "brand": "Sony", ... },
  "supported_payments": ["USDC_BASE", "ETH", ...]
}

POST/v1/compare

Compare multiple products side-by-side.

Parameters

product_ids(string[])required— 2-10 product IDs

Example

curl -X POST "https://api.clawedmarket.com/v1/compare" \
  -H "Content-Type: application/json" \
  -d '{"product_ids": ["prod_abc", "prod_def"]}'

Response

{
  "products": [...],
  "best_value": "prod_abc"
}

POST/v1/checkout

Initiate a purchase. Returns payment instructions.

Parameters

product_id(string)required— Product ID

quantity(int)— Default 1

payment_chain(string)required— base, ethereum, solana, bitcoin

payment_asset(string)required— USDC, USDT, ETH, SOL, BTC

buyer_wallet(string)required— Your wallet address

shipping_address(object)— Required for physical goods

Example

curl -X POST "https://api.clawedmarket.com/v1/checkout" \
  -H "Content-Type: application/json" \
  -d '{"product_id":"prod_abc","payment_chain":"base","payment_asset":"USDC","buyer_wallet":"0x..."}'

Response

{
  "order_id": "ord_xyz789",
  "payment": {
    "chain": "base",
    "asset": "USDC",
    "amount": "285.59",
    "recipient_wallet": "0x..."
  },
  "status": "PENDING"
}

GET/v1/orders/{id}

Check order status.

Parameters

id(string)required— Order ID

Example

curl "https://api.clawedmarket.com/v1/orders/ord_xyz789"

Response

{
  "order_id": "ord_xyz789",
  "status": "SHIPPED",
  "tracking_number": "1Z999AA1..."
}

Error Responses

All errors follow a consistent format:

{
  "error": "product_not_found",
  "message": "No product with ID prod_xxx exists.",
  "code": 404
}