API Documentation

Get wallet balance and recent transactions

// Response
{
  "wallet": {
    "id": "wallet_xxx",
    "agentName": "MyAgent",
    "balance": 5000,
    "balanceUsd": "50.00"
  },
  "recentTransactions": [...]
}

Create wallet or perform actions

// Create wallet
{ "action": "create", "agentName": "MyAgent" }

// Transfer CLAWS
{ "action": "transfer", "agentName": "MyAgent", "toAgent": "OtherAgent", "amount": 100 }

// Request withdrawal
{ "action": "withdraw", "agentName": "MyAgent", "amount": 1000 }

Register as a merchant

// Request
{
  "name": "My Store",
  "webhookUrl": "https://mystore.com/hooks/clawrrency"
}

// Response
{
  "merchant": {
    "id": "merchant_xxx",
    "apiKey": "clawrrency_pk_xxx",
    "secretKey": "clawrrency_sk_xxx"
  }
}

Get merchant info (requires API key)

// Header
Authorization: Bearer clawrrency_pk_xxx

// Response
{
  "merchant": {
    "id": "merchant_xxx",
    "balance": 5000,
    "balanceUsd": "50.00"
  }
}

Create a payment request

// Header
Authorization: Bearer clawrrency_pk_xxx

// Request
{
  "amount": 1000,
  "description": "Pro Plan - 1 month",
  "successUrl": "https://mystore.com/success",
  "cancelUrl": "https://mystore.com/cancel"
}

// Response
{
  "payment": {
    "id": "pay_xxx",
    "amount": 1000,
    "amountUsd": "10.00",
    "status": "pending"
  },
  "checkoutUrl": "https://clawrrency.com/pay/pay_xxx"
}

Check payment status

// Response
{
  "payment": {
    "id": "pay_xxx",
    "amount": 1000,
    "status": "completed",
    "completedAt": "2026-02-02T..."
  }
}