Developer Tools

API Documentation

Build powerful onchain analytics tools with the ClawScrap API. Full REST and WebSocket support with comprehensive data across 7+ chains.

Quick Start

Get up and running in under 2 minutes

1. Get your API key from the dashboard:

curl -X POST https://api.clawscrap.io/v1/auth/key \
-H 'Authorization: Bearer YOUR_TOKEN'

2. Make your first API call:

curl https://api.clawscrap.io/v1/whales/movements \
?chain=eth&min_value=100000 \
-H "X-API-Key: YOUR_KEY"

3. Example response:

{
  "status": "ok",
  "data": [{
    "wallet": "0x1a2b...",
    "action": "buy",
    "token": "PEPE",
    "value": "$2.4M",
    "chain": "eth",
    "timestamp": "2024-01-15T10:30:00Z"
  }]
}

API Capabilities

Low Latency

Sub-100ms response times on all endpoints with global edge caching.

Rate Limiting

Generous rate limits: 100 req/min free, 1000 req/min on Pro, unlimited on Enterprise.

Multi-Chain

Ethereum, BSC, Polygon, Arbitrum, Base, Optimism, and Avalanche supported.

Real-Time WebSocket

Subscribe to live events via WebSocket for instant whale movement notifications.

Historical Data

Access up to 2 years of historical on-chain data for backtesting and analysis.

Webhooks

Set up webhooks to receive push notifications for any on-chain event.

Authentication

All API requests require authentication via an API key. Include your key in the request header:

// Header
X-API-Key: clawscrap_live_xxxxxxxxxxxxxxxxxxxx

🔒 Security Note: Never expose your API key in client-side code. Always make API calls from your backend server. Rotate keys regularly via the dashboard.

Endpoints Reference

GET/api/v1/wallets/{address}/activity

Get full activity history for a wallet including transfers, swaps, and contract interactions.

Parameters

address (string) — Wallet address

chain (string) — Chain ID (eth, bsc, polygon, arbitrum, base)

limit (int) — Max results (default 50, max 500)

GET/api/v1/tokens/{address}/analytics

Get comprehensive analytics for a token: holders, volume, liquidity, and smart money flow.

Parameters

address (string) — Token contract address

chain (string) — Chain ID

timeframe (string) — 1h, 4h, 24h, 7d, 30d

GET/api/v1/whales/movements

Real-time feed of whale wallet movements across all supported chains.

Parameters

min_value (int) — Minimum USD value (default $100k)

chain (string) — Filter by chain

type (string) — buy, sell, transfer

POST/api/v1/alerts/create

Create a custom alert for wallet activity, token price movements, or whale transactions.

Parameters

wallet (string) — Target wallet address

threshold (int) — USD value threshold

channel (string) — telegram, discord, xmtp, webhook

GET/api/v1/tokens/trending

Get currently trending tokens ranked by ClawScore, volume spike, and smart money activity.

Parameters

chain (string) — Filter by chain

timeframe (string) — 1h, 4h, 24h

min_score (int) — Minimum ClawScore (0-100)

GET/api/v1/dex/trades

Stream of all DEX trades across supported chains with decoded swap details.

Parameters

pair (string) — Token pair address

chain (string) — Chain ID

min_value (int) — Minimum trade value in USD

Official SDKs

Drop-in client libraries for popular languages.

JavaScript/TypeScriptPythonGoRustRuby