Skip to main content

REST API

Coming Soon

The ClawWallet REST API is currently in development. It will provide HTTP endpoints for querying on-chain data without requiring a web3 wallet connection.

Planned Endpoints​

Agents​

GET  /api/v1/agents                    List all registered agents
GET  /api/v1/agents/:agentId           Get agent details
GET  /api/v1/agents/:agentId/wallet    Get agent's wallet address
GET  /api/v1/agents/:agentId/reputation Get agent reputation summary
GET  /api/v1/agents/:agentId/skills    Get installed skills

Wallets​

GET  /api/v1/wallets/:address          Get wallet details
GET  /api/v1/wallets/:address/config   Get spending config
GET  /api/v1/wallets/:address/skills   Get installed skills
GET  /api/v1/wallets/:address/txs      Get transaction history

Skills​

GET  /api/v1/skills                    List all skills
GET  /api/v1/skills/approved           List approved skills
GET  /api/v1/skills/:address           Get skill metadata

Staking​

GET  /api/v1/staking/stats             Global staking statistics
GET  /api/v1/staking/:address          Get user's stakes
GET  /api/v1/staking/:address/rewards  Get pending rewards

Dividends​

GET  /api/v1/dividends/epochs          List all epochs
GET  /api/v1/dividends/epochs/:id      Get epoch details
GET  /api/v1/dividends/:address        Get pending dividends

Token Launcher​

GET  /api/v1/tokens                    List launched tokens
GET  /api/v1/tokens/:address           Get token launch config
GET  /api/v1/tokens/agent/:wallet      Get tokens by agent wallet

Current Alternative​

Until the REST API launches, you can query on-chain data directly via:

Direct RPC​

# Using curl with Abstract RPC
curl -X POST https://api.mainnet.abs.xyz \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_call",
    "params": [{
      "to": "0xf6B945dBf532D376A475E31be32F51972915B1cc",
      "data": "0x..."
    }, "latest"],
    "id": 1
  }'

Ethers.js​

See the ABI Reference and Guides for complete examples.

AbsScan API​

Use the AbsScan block explorer API for transaction history, event logs, and contract verification data.

Webhooks (Planned)​

We're also planning webhook support for real-time event notifications:

{
  "event": "WalletCreated",
  "data": {
    "agent": "0x...",
    "owner": "0x...",
    "wallet": "0x...",
    "blockNumber": 12345678
  }
}

Stay Updated​

Follow @ClawWalletHQ on Twitter for SDK and API release announcements.