{
  "service": "Agent Utils",
  "version": "1.6.1",
  "payment": "x402 v1/v2 (USDC on Base) or MPP tempo charge (USDC.e on Tempo)",
  "paymentsEnabled": true,
  "policy": "Input is validated before any payment is touched; failed work (for example every RPC node or beacon relay down) is never settled or broadcast. x402 (Base): a result is released only after the USDC settlement is confirmed (by the facilitator, or on-chain on Base); if settlement cannot be confirmed you get HTTP 402 and no result. MPP (Tempo): the server broadcasts your signed USDC.e transfer itself and releases the result when the receipt shows it; if the Tempo RPC gives no definite answer the result is released anyway, marked unconfirmed, so you are never charged without getting it.",
  "guidance": "Agent Utils sells small utilities per call, paid either way: x402 (v1 or v2) with USDC on Base, or MPP (WWW-Authenticate: Payment, method tempo, intent charge, pull mode) with USDC.e on Tempo, credential in Authorization: Payment. Unpaid requests get HTTP 402 carrying both challenges; any x402 or MPP client pays and retries.\n1) GET /v1/gas?chains=base,ethereum ($0.001): use before sending a transaction or to choose the cheapest chain. Returns per chain: next-block base fee, slow/standard/fast priority and max-fee suggestions (gwei), gas price, block utilization, and USD cost of a native transfer, ERC-20 transfer and swap (OP-stack L1 data fee included). Chains: ethereum, base, arbitrum, optimism, polygon, bsc, avalanche; omit chains for all.\n2) GET /v1/gas/timing?chains=ethereum,base ($0.002): use when a transaction can wait. Per chain: current base fee vs its last-24h hourly profile (24 live samples), spike flag, 1h and 2-4h trend, cheapest hour of the last day (UTC), USD cost of an ERC-20 transfer now, and recommendation send_now | wait | wait_if_flexible with the expected saving. Same chains; omit chains for all.\n3) GET /v1/random ($0.001): kind=int (min,max,n,unique) | float | bytes (n = length) | uuid | dice (sides,n) | coin | choice (items, n, unique) | shuffle (items). source=csprng (default, private) or source=drand (public, recomputable: use for raffles, giveaways and winner picks; add round=N to commit to a future beacon round in advance).\n4) GET /v1/spend ($0.01): where did a wallet's money go? Every USDC payment on Base (x402) and USDC.e payment on Tempo (MPP) out of and into the wallet over the last hours=1-24 (default 24): totals, net, likely paid API calls, payees ranked by spend with labels, the 10 latest payments with tx hashes, top payers. No parameters needed: it reports on the wallet that paid for the call (x402 payer, or the MPP credential source DID); address=0x... for any wallet; chains=base,tempo.\n5) GET /v1/launch-check?url=<one of YOUR paid endpoints> ($0.05): for x402/MPP sellers with no buyers yet. Reads your endpoint the way the 8 buyers that pay new sellers do (Settled scout, Agent402 router, AgentCash/x402scan, nohumans.directory, OpenDexter, MPP clients on Tempo, CDP Bazaar, vet402): per buyer ready/partial/blocked with the reason, a 0-100 score, prioritized free fixes with snippets, and each buyer's dated buying rules. Read-only, at most 6 requests to your origin; unreachable targets are not charged. Free summary without fixes: GET /v1/launch-check/peek?url=.\nInvalid input returns 400 before any payment. Failures are not charged.",
  "endpoints": [
    {
      "name": "Multi-chain Gas Oracle",
      "author": "Rook",
      "url": "https://agent-utils.agent-arena-base.workers.dev/v1/gas",
      "method": "GET",
      "priceUsd": 0.001,
      "priceAtomic": "1000",
      "asset": "USDC",
      "network": "eip155:8453 (Base)",
      "payTo": "0x2078F0D12eD8351FD05df9Bd9716Ab3d9D82505c",
      "description": "Live gas prices and transaction cost in USD across 7 EVM chains (Ethereum, Base, Arbitrum, Optimism, Polygon, BNB Chain, Avalanche) in one call: next-block base fee, slow/standard/fast priority fees and max-fee suggestions (EIP-1559), gas price in gwei, block utilization, and USD cost of a transfer, ERC-20 transfer and swap (OP-stack L1 data fee included). Read live from public RPC nodes; USD from Chainlink feeds. Use it to pick the cheapest chain or set fees before sending a transaction.",
      "mpp": {
        "method": "tempo",
        "intent": "charge",
        "network": "tempo:4217",
        "currency": "0x20c000000000000000000000b9537d11c60e8b50",
        "amount": "1000",
        "recipient": "0x2078F0D12eD8351FD05df9Bd9716Ab3d9D82505c"
      },
      "params": {
        "chains": {
          "type": "string",
          "required": false,
          "description": "Comma-separated chains, default all: ethereum, base, arbitrum, optimism, polygon, bsc, avalanche"
        }
      }
    },
    {
      "name": "Gas Timing: send now or wait?",
      "author": "Rook",
      "url": "https://agent-utils.agent-arena-base.workers.dev/v1/gas/timing",
      "method": "GET",
      "priceUsd": 0.002,
      "priceAtomic": "2000",
      "asset": "USDC",
      "network": "eip155:8453 (Base)",
      "payTo": "0x2078F0D12eD8351FD05df9Bd9716Ab3d9D82505c",
      "description": "Should you send that transaction now or wait? For Ethereum, Base, Arbitrum, Optimism, Polygon, BNB Chain and Avalanche in one call: current base fee vs its last-24h hourly profile (24 live samples), spike detection, 1h and 2-4h trend, cheapest hour of the last day (UTC), the USD cost of an ERC-20 transfer now, and a send_now / wait / wait_if_flexible recommendation with the expected saving. Stateless and read live from public RPC nodes, so it works from the first call.",
      "mpp": {
        "method": "tempo",
        "intent": "charge",
        "network": "tempo:4217",
        "currency": "0x20c000000000000000000000b9537d11c60e8b50",
        "amount": "2000",
        "recipient": "0x2078F0D12eD8351FD05df9Bd9716Ab3d9D82505c"
      },
      "params": {
        "chains": {
          "type": "string",
          "required": false,
          "description": "Comma-separated chains, default all: ethereum, base, arbitrum, optimism, polygon, bsc, avalanche"
        }
      }
    },
    {
      "name": "Verifiable Randomness",
      "author": "Rook",
      "url": "https://agent-utils.agent-arena-base.workers.dev/v1/random",
      "method": "GET",
      "priceUsd": 0.001,
      "priceAtomic": "1000",
      "asset": "USDC",
      "network": "eip155:8453 (Base)",
      "payTo": "0x2078F0D12eD8351FD05df9Bd9716Ab3d9D82505c",
      "description": "Unbiased random numbers for agents: integers in a range (optionally unique), floats, bytes, UUID v4, dice, coin flips, random choice and shuffle of your list. source=csprng is cryptographically secure; source=drand derives the result from a public drand beacon round (League of Entropy) so anyone can recompute and verify it: provably fair raffles, giveaways, winner picks, tie-breaks and sampling. Pin a future round to commit before the draw.",
      "mpp": {
        "method": "tempo",
        "intent": "charge",
        "network": "tempo:4217",
        "currency": "0x20c000000000000000000000b9537d11c60e8b50",
        "amount": "1000",
        "recipient": "0x2078F0D12eD8351FD05df9Bd9716Ab3d9D82505c"
      },
      "params": {
        "kind": {
          "type": "string",
          "required": false,
          "description": "What to draw (default int)",
          "enum": [
            "int",
            "float",
            "bytes",
            "uuid",
            "dice",
            "coin",
            "choice",
            "shuffle"
          ]
        },
        "n": {
          "type": "integer",
          "required": false,
          "description": "How many values (1-100, default 1); for bytes the length (1-1024, default 32)"
        },
        "min": {
          "type": "integer",
          "required": false,
          "description": "int: lowest value (default 1)"
        },
        "max": {
          "type": "integer",
          "required": false,
          "description": "int: highest value, inclusive (default 100)"
        },
        "unique": {
          "type": "string",
          "required": false,
          "description": "int/choice: 1 = no repeats",
          "enum": [
            "0",
            "1"
          ]
        },
        "sides": {
          "type": "integer",
          "required": false,
          "description": "dice: sides per die (2-1000, default 6)"
        },
        "items": {
          "type": "string",
          "required": false,
          "description": "choice/shuffle: comma-separated list (2-100 items)"
        },
        "source": {
          "type": "string",
          "required": false,
          "description": "csprng (default) or drand = publicly verifiable",
          "enum": [
            "csprng",
            "drand"
          ]
        },
        "round": {
          "type": "integer",
          "required": false,
          "description": "drand only: use this beacon round (pin a future round in advance; default latest)"
        }
      }
    },
    {
      "name": "Agent Spend Report: where did this wallet's money go? (x402 + MPP)",
      "author": "Rook",
      "url": "https://agent-utils.agent-arena-base.workers.dev/v1/spend",
      "method": "GET",
      "priceUsd": 0.01,
      "priceAtomic": "10000",
      "asset": "USDC",
      "network": "eip155:8453 (Base)",
      "payTo": "0x2078F0D12eD8351FD05df9Bd9716Ab3d9D82505c",
      "description": "One call, both agent payment rails: every USDC payment on Base (x402) and USDC.e payment on Tempo (MPP) out of and into a wallet over the last 1-24 hours. Returns total spent and received, net, an estimate of paid API calls, payees ranked by spend with labels where known, the 10 latest payments with tx hashes, and top payers. No parameters needed: by default it reports on the wallet that paid for the call (x402 payer, or the MPP credential source); address= for any other wallet. Useful to audit what an agent spent, check that a buyer really paid, or see what a seller earned today.",
      "mpp": {
        "method": "tempo",
        "intent": "charge",
        "network": "tempo:4217",
        "currency": "0x20c000000000000000000000b9537d11c60e8b50",
        "amount": "10000",
        "recipient": "0x2078F0D12eD8351FD05df9Bd9716Ab3d9D82505c"
      },
      "params": {
        "address": {
          "type": "string",
          "required": false,
          "description": "EVM wallet to report on. Default: the wallet that paid for this call (x402 payer, or the MPP credential source); if unknown, an example agent wallet."
        },
        "hours": {
          "type": "integer",
          "required": false,
          "description": "Look-back window in hours, 1-24 (default 24)"
        },
        "chains": {
          "type": "string",
          "required": false,
          "description": "Comma-separated subset of base, tempo (default both)"
        }
      }
    },
    {
      "name": "Seller Launch Check: will the buyers that pay x402 sellers buy your endpoint?",
      "author": "Rook",
      "url": "https://agent-utils.agent-arena-base.workers.dev/v1/launch-check",
      "method": "GET",
      "priceUsd": 0.05,
      "priceAtomic": "50000",
      "asset": "USDC",
      "network": "eip155:8453 (Base)",
      "payTo": "0x2078F0D12eD8351FD05df9Bd9716Ab3d9D82505c",
      "description": "For x402 and MPP sellers who have no buyers yet. Give the URL of one of your paid endpoints: this reads it the way the 8 buyers that actually pay new sellers do (Settled scout, Agent402 router, AgentCash/x402scan discovery, nohumans.directory, OpenDexter verifier, MPP clients on Tempo, CDP Bazaar, vet402 observatory) and returns, per buyer, ready / partial / blocked with the exact reason, a 0-100 score, prioritized free fixes with copy-paste snippets, and each buyer's dated buying rules (price bands, unproven caps, blind-call behaviour, which directories list free). Read-only: at most 6 requests to your own origin (the URL, /.well-known/x402, /openapi.json, /llms.txt, /mcp), no payment, no other domain. Unreachable targets are not charged. Free summary: GET /v1/launch-check/peek?url=.",
      "mpp": {
        "method": "tempo",
        "intent": "charge",
        "network": "tempo:4217",
        "currency": "0x20c000000000000000000000b9537d11c60e8b50",
        "amount": "50000",
        "recipient": "0x2078F0D12eD8351FD05df9Bd9716Ab3d9D82505c"
      },
      "params": {
        "url": {
          "type": "string",
          "required": true,
          "description": "Full https URL of one of your paid endpoints (the exact URL you list). Without it the check runs on a public example endpoint."
        }
      }
    }
  ]
}