The crypto payment API your AI agent calls itself

A keyless HTTP API built for agents. Give a destination wallet address and get back a shareable payment link, an embeddable button, and an agent-readable dashboard, in one call. No account, no dashboard, no API key. Non-custodial: funds settle straight to the address you provide. Base URL: https://shieldz.cash

# Reusable tip jar (the payer picks the amount)
GET https://shieldz.cash/api/v1/tip-jars?to=0xWALLET&title=Buy+me+a+coffee&amounts=1,5,20

# Fixed-amount payment link
GET https://shieldz.cash/api/v1/links?to=0xWALLET&amount=25&chain=BASE&asset=USDC

1Create a payment link

POST /api/v1/links, a one-time invoice for a fixed amount.

curl https://shieldz.cash/api/v1/links \
  -H "Content-Type: application/json" \
  -d '{
    "settlement": { "chain": "BASE", "asset": "USDC", "address": "0xYourWallet…" },
    "amount_usd_cents": 2500,
    "memo": "Invoice #1234",
    "email": "[email protected]"
  }'

Required: settlement.address (a 0x EVM address) and amount_usd_cents ($1 to $100k). Optional: settlement.chain (Base, Arbitrum, Optimism, Polygon, Ethereum, default Base), settlement.asset (USDC or USDT, default USDC), memo, email.

Response:

{
  "id": "I8DrmEZ_pFsmZqknbmZc",
  "status": "pending",
  "amount_usd_cents": 2500,
  "settlement": { "chain": "BASE", "asset": "USDC", "address": "0xYourWallet…" },
  "pay_url": "https://shieldz.cash/pay/I8DrmEZ_pFsmZqknbmZc",
  "manage_url": "https://shieldz.cash/a/8_ah9oJ4WcvZnJRTDxD-8xSjVUiPYcwA",
  "manage_token": "8_ah9oJ4WcvZnJRTDxD-8xSjVUiPYcwA",
  "embed": "<script src=\"https://shieldz.cash/embed/button.js\" data-href=\"https://shieldz.cash/pay/I8DrmEZ_pFsmZqknbmZc\" data-label=\"Pay\"></script>"
}

Send the payer to pay_url, or drop the embed snippet on any page. Keep manage_token, it is how you read status later.

No JSON body? Any tool that can build a URL can mint the same link with a plain GET: GET https://shieldz.cash/api/v1/links?to=0x…&amount=25&chain=BASE&asset=USDC. Same response, including the manage_token claim code. to and amount are hand-writable aliases.

2Create a tip jar

POST /api/v1/tip-jars, a reusable "pay what you want" page where the payer chooses the amount. Idempotent per wallet address: calling again updates the same jar.

curl https://shieldz.cash/api/v1/tip-jars \
  -H "Content-Type: application/json" \
  -d '{
    "settlement": { "chain": "BASE", "asset": "USDC", "address": "0xYourWallet…" },
    "title": "Buy me a coffee",
    "brand": "Acme Store",
    "description": "Support my open-source work",
    "suggested_amounts_usd_cents": [300, 500, 1000],
    "logo": "https://you.com/logo.png",
    "image_url": "https://you.com/hero.png",
    "accent": "#7c3aed",
    "social": { "website": "https://you.com", "x": "https://x.com/you" },
    "email": "[email protected]"
  }'

Optional: title, description, suggested_amounts_usd_cents (up to 8 preset buttons), and a custom slug.

White-label (all optional): image_url (a logo/hero image), accent (one #RRGGBB that themes the whole page and the checkout it leads to), and social (website, x, instagram, telegram, youtube). The page wears the creator's brand, and the accent carries through to the hosted checkout.

{
  "object": "tip_jar",
  "slug": "tip-10851092bec481a4",
  "url": "https://shieldz.cash/tip/tip-10851092bec481a4",
  "settlement": { "chain": "BASE", "asset": "USDC", "address": "0xYourWallet…" },
  "suggested_amounts_usd_cents": [300, 500, 1000],
  "manage_url": "https://shieldz.cash/a/8_ah9oJ4WcvZnJRTDxD-8xSjVUiPYcwA",
  "manage_token": "8_ah9oJ4WcvZnJRTDxD-8xSjVUiPYcwA"
}

Plain GET too: GET https://shieldz.cash/api/v1/tip-jars?to=0x…&title=Buy+me+a+coffee&amounts=1,5,20&accent=%237c3aed&image=https://you.com/logo.png&website=https://you.com&x=https://x.com/you mints the same white-labeled jar from a single URL, so even a fetch-only tool can do it. Prefer a form? Use the tip jar generator or the payment link generator, no code.

3Read the dashboard agent-readable

The manage_token resolves to a dashboard with no login. Two shapes from the same URL:

curl https://shieldz.cash/a/8_ah9oJ4WcvZnJRTDxD-8xSjVUiPYcwA.json

{
  "object": "link_account",
  "claimed": false,
  "email_on_file": true,
  "settlement": { "chain": "BASE", "asset": "USDC", "address": "0xYourWallet…" },
  "tip_jars": [
    { "slug": "tip-10851092bec481a4", "url": "https://shieldz.cash/tip/tip-10851092bec481a4", "title": "Buy me a coffee" }
  ],
  "totals": {
    "currency": "usd",
    "paid_count": 1, "paid_amount_usd_cents": 2500,
    "pending_count": 1, "pending_amount_usd_cents": 1000,
    "invoice_count": 2
  },
  "invoices": [
    { "id": "I8DrmEZ_pFsmZqknbmZc", "status": "paid", "amount_usd_cents": 2500,
      "paid_at": 1750000000000, "pay_url": "https://shieldz.cash/pay/I8DrmEZ_pFsmZqknbmZc" }
  ]
}

Hand off to a human claim

The optional email and the manage_token let an agent hand an account to its human owner. The owner signs in (wallet or email) and claims a full dashboard:

POST /api/v1/links/claim with Authorization: Bearer <session> and body { "manage_token": "…" }.

{
  "mcpServers": {
    "shieldz": { "url": "https://shieldz.cash/mcp" }
  }
}

{
  "mcpServers": {
    "shieldz": {
      "command": "npx",
      "args": ["-y", "@shieldz/mcp"]
    }
  }
}

{
  "type": "function",
  "function": {
    "name": "create_payment_link",
    "description": "Create a one-time crypto payment link. Funds settle non-custodially straight to the given wallet. No API key needed.",
    "parameters": {
      "type": "object",
      "properties": {
        "address":          { "type": "string",  "description": "0x EVM wallet address to settle to" },
        "amount_usd_cents": { "type": "integer", "description": "Amount in USD cents (100 to 10000000)" },
        "chain":            { "type": "string",  "enum": ["BASE","ARBITRUM","OPTIMISM","POLYGON","ETHEREUM"], "default": "BASE" },
        "asset":            { "type": "string",  "enum": ["USDC","USDT"], "default": "USDC" },
        "memo":             { "type": "string" }
      },
      "required": ["address", "amount_usd_cents"]
    }
  }
}