Quickstart

Get your first simulation result in under 5 minutes. No blockchain expertise needed. Works on Avalanche Fuji and Arbitrum Sepolia for free.

# Circle Agent Wallet Policy Pre-Check Hook (x402 Authorized)
curl -X POST https://api.arbisimguard.com/api/v1/circle/policy-check \
  -H "Content-Type: application/json" \
  -H "X-402-Payment: x402 0xYourAgentWallet:0.001:0xSig" \
  -d '{
    "walletId": "circle_agent_wallet_01",
    "network": "arbitrum-one",
    "transaction": {
      "to": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
      "data": "0xa9059cbb...",
      "value": "0x0"
    }
  }'

Step 1 — Get an API key or use Circle x402 Nanopayments

Go to the API Keys page and click "Create key". Alternatively, send an X-402-Payment header with any request to pay per call in USDC gaslessly.

ask_free_a1b2_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Store this key safely — it is only shown once.

Step 2 — Run your first simulation

This call simulates a token transaction on Arbitrum One. Nothing real happens — it is an ephemeral fork simulation:

curl -X POST https://api.arbisimguard.com/api/v1/simulate \
  -H "Content-Type: application/json" \
  -H "X-API-Key: ask_free_a1b2_..." \
  -d '{
    "network": "arbitrum-one",
    "agent_address": "0x0000000000000000000000000000000000000001",
    "transactions": [
      {
        "to":    "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
        "data":  "0xa9059cbb...",
        "value": "0"
      }
    ],
    "max_slippage_tolerance": 0.5
  }'

Step 3 — Read the response

You will get back a structured safety report:

{
  "status": "APPROVED",
  "checks": {
    "would_revert": false,
    "price_impact_too_high": false,
    "frontrun_detected": false,
    "risky_allowance": false
  },
  "gas_cost": "0.00002132 ETH",
  "verdict": "SAFE — proceed"
}

If any check fires, the status becomes REJECTED and the verdict explains why in plain English.

Step 4 — Connect to your agent (optional)

If you use Claude Desktop, OpenClaw, or Cursor, install the Circle CLI skill or add this to your MCP config:

{
  "mcpServers": {
    "arbisim-guard": {
      "command": "node",
      "args": ["./gateway/dist/index.js", "--mcp"],
      "env": { "GATEWAY_API_KEY": "ask_free_a1b2_..." }
    }
  }
}

Your agent can now say: "Simulate a USDC transfer on Arbitrum and abort if gas or slippage exceeds safety limits."

What next?