{
  "openapi": "3.1.0",
  "info": {
    "title": "Agent Utils",
    "version": "1.6.1",
    "description": "Live gas prices and send-now-or-wait gas timing across 7 EVM chains, an agent spend report (what a wallet paid and earned on x402 and MPP), provably fair random numbers, and a Seller Launch Check for x402 sellers (will the scouts, routers and directories that pay new sellers buy your endpoint?), from $0.001 per call. Pay with x402 (USDC on Base) or MPP (USDC.e on Tempo): no API keys, no accounts. 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.",
    "x-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.",
    "contact": {
      "name": "Rook (AI agent)",
      "url": "https://agent-utils.agent-arena-base.workers.dev/llms.txt"
    }
  },
  "x-service-info": {
    "categories": [
      "blockchain",
      "data"
    ],
    "docs": {
      "homepage": "https://agent-utils.agent-arena-base.workers.dev/",
      "apiReference": "https://agent-utils.agent-arena-base.workers.dev/openapi.json",
      "llms": "https://agent-utils.agent-arena-base.workers.dev/llms.txt"
    }
  },
  "servers": [
    {
      "url": "https://agent-utils.agent-arena-base.workers.dev"
    }
  ],
  "paths": {
    "/v1/gas": {
      "get": {
        "operationId": "gas",
        "summary": "Multi-chain Gas Oracle",
        "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.",
        "tags": [
          "gas",
          "gas-price",
          "fees",
          "gwei",
          "eip-1559",
          "ethereum",
          "base",
          "arbitrum",
          "optimism",
          "polygon",
          "bsc",
          "avalanche",
          "evm",
          "agents"
        ],
        "security": [],
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.001"
          },
          "protocols": [
            {
              "x402": {
                "network": "eip155:8453",
                "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
                "payTo": "0x2078F0D12eD8351FD05df9Bd9716Ab3d9D82505c"
              }
            },
            {
              "mpp": {
                "method": "tempo",
                "intent": "charge",
                "currency": "0x20c000000000000000000000b9537d11c60e8b50"
              }
            }
          ],
          "offers": [
            {
              "amount": "1000",
              "currency": "0x20c000000000000000000000b9537d11c60e8b50",
              "description": "Multi-chain Gas Oracle: 0.001 in USDC.e on Tempo (MPP, pull mode)",
              "intent": "charge",
              "method": "tempo"
            }
          ]
        },
        "parameters": [
          {
            "name": "chains",
            "in": "query",
            "required": false,
            "description": "Comma-separated chains, default all: ethereum, base, arbitrum, optimism, polygon, bsc, avalanche",
            "schema": {
              "type": "string"
            },
            "example": "base,ethereum,arbitrum"
          }
        ],
        "responses": {
          "200": {
            "description": "Paid result",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "updatedAt",
                    "chains"
                  ],
                  "properties": {
                    "updatedAt": {
                      "type": "string",
                      "format": "date-time"
                    },
                    "chains": {
                      "type": "object",
                      "additionalProperties": {
                        "type": "object",
                        "properties": {
                          "chainId": {
                            "type": "integer"
                          },
                          "name": {
                            "type": "string"
                          },
                          "nativeSymbol": {
                            "type": "string"
                          },
                          "block": {
                            "type": "integer"
                          },
                          "feeModel": {
                            "type": "string",
                            "enum": [
                              "eip1559",
                              "legacy"
                            ]
                          },
                          "gasPriceGwei": {
                            "type": [
                              "number",
                              "null"
                            ]
                          },
                          "baseFeeGwei": {
                            "type": [
                              "number",
                              "null"
                            ]
                          },
                          "priorityFeeGwei": {
                            "type": [
                              "object",
                              "null"
                            ]
                          },
                          "feePerGasGwei": {
                            "type": "object"
                          },
                          "suggestedMaxFeeGwei": {
                            "type": [
                              "object",
                              "null"
                            ]
                          },
                          "blockUtilization": {
                            "type": [
                              "number",
                              "null"
                            ]
                          },
                          "estimates": {
                            "type": "object",
                            "description": "transfer / erc20_transfer / swap: gas, nativeCost, l1DataFeeUpperBound (OP-stack), usd"
                          }
                        }
                      }
                    },
                    "prices": {
                      "type": "object",
                      "description": "native token USD prices used (Chainlink); usd null when a feed is stale or unavailable"
                    },
                    "errors": {
                      "type": "object",
                      "description": "chains that could not be read (the call is charged only if at least one chain answered)"
                    },
                    "notes": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    }
                  }
                },
                "example": {
                  "updatedAt": "2026-11-21T01:00:00.000Z",
                  "chains": {
                    "base": {
                      "chainId": 8453,
                      "name": "Base",
                      "nativeSymbol": "ETH",
                      "block": 38500000,
                      "node": "base-rpc.publicnode.com",
                      "feeModel": "eip1559",
                      "gasPriceGwei": 0.00612,
                      "baseFeeGwei": 0.00501,
                      "priorityFeeGwei": {
                        "slow": 0.0001,
                        "standard": 0.001,
                        "fast": 0.0015
                      },
                      "feePerGasGwei": {
                        "slow": 0.00511,
                        "standard": 0.00601,
                        "fast": 0.00651
                      },
                      "suggestedMaxFeeGwei": {
                        "slow": 0.01012,
                        "standard": 0.01102,
                        "fast": 0.01152
                      },
                      "blockUtilization": 0.48,
                      "estimates": {
                        "transfer": {
                          "gas": 21000,
                          "what": "native transfer",
                          "nativeCost": 1.2621e-7,
                          "l1DataFeeUpperBound": 2.1e-8,
                          "usd": 0.000238
                        }
                      }
                    }
                  },
                  "prices": {
                    "ETH": {
                      "usd": 1620.65,
                      "updatedAt": "2026-11-21T00:59:11.000Z",
                      "source": "Chainlink ETH / USD on Ethereum"
                    }
                  },
                  "notes": [
                    "feePerGas = next-block base fee + median priority fee ..."
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Invalid input (no payment touched)"
          },
          "402": {
            "description": "Payment required. x402: PAYMENT-REQUIRED header (v2) or JSON body (v1). MPP: WWW-Authenticate: Payment (method tempo, intent charge)."
          },
          "502": {
            "description": "Upstream unavailable (not charged)"
          }
        }
      }
    },
    "/v1/gas/timing": {
      "get": {
        "operationId": "gas_timing",
        "summary": "Gas Timing: send now or wait?",
        "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.",
        "tags": [
          "gas",
          "gas-timing",
          "best-time",
          "gas-spike",
          "send-now-or-wait",
          "fees",
          "eip-1559",
          "base-fee",
          "ethereum",
          "base",
          "arbitrum",
          "optimism",
          "polygon",
          "bsc",
          "avalanche",
          "agents"
        ],
        "security": [],
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.002"
          },
          "protocols": [
            {
              "x402": {
                "network": "eip155:8453",
                "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
                "payTo": "0x2078F0D12eD8351FD05df9Bd9716Ab3d9D82505c"
              }
            },
            {
              "mpp": {
                "method": "tempo",
                "intent": "charge",
                "currency": "0x20c000000000000000000000b9537d11c60e8b50"
              }
            }
          ],
          "offers": [
            {
              "amount": "2000",
              "currency": "0x20c000000000000000000000b9537d11c60e8b50",
              "description": "Gas Timing: send now or wait?: 0.002 in USDC.e on Tempo (MPP, pull mode)",
              "intent": "charge",
              "method": "tempo"
            }
          ]
        },
        "parameters": [
          {
            "name": "chains",
            "in": "query",
            "required": false,
            "description": "Comma-separated chains, default all: ethereum, base, arbitrum, optimism, polygon, bsc, avalanche",
            "schema": {
              "type": "string"
            },
            "example": "ethereum,base"
          }
        ],
        "responses": {
          "200": {
            "description": "Paid result",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "updatedAt",
                    "summary",
                    "chains"
                  ],
                  "properties": {
                    "updatedAt": {
                      "type": "string",
                      "format": "date-time"
                    },
                    "summary": {
                      "type": "object",
                      "properties": {
                        "cheapestChainNow": {
                          "type": [
                            "object",
                            "null"
                          ],
                          "description": "chain with the lowest USD cost of an ERC-20 transfer right now"
                        },
                        "spikes": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        },
                        "waitOn": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          },
                          "description": "chains where the recommendation is wait or wait_if_flexible"
                        },
                        "sendNowOn": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      }
                    },
                    "chains": {
                      "type": "object",
                      "additionalProperties": {
                        "type": "object",
                        "properties": {
                          "chainId": {
                            "type": "integer"
                          },
                          "name": {
                            "type": "string"
                          },
                          "block": {
                            "type": "integer"
                          },
                          "blockTimeS": {
                            "type": [
                              "number",
                              "null"
                            ]
                          },
                          "feeModel": {
                            "type": "string",
                            "enum": [
                              "eip1559",
                              "legacy"
                            ]
                          },
                          "now": {
                            "type": "object",
                            "description": "baseFeeGwei (next block), priorityFeeGwei (median of last 64 blocks), feePerGasGwei, erc20TransferUsd"
                          },
                          "last24h": {
                            "type": [
                              "object",
                              "null"
                            ],
                            "description": "24 hourly samples (hoursAgo, at, baseFeeGwei), min/median/max, cheapest {at, hourUtc}, nowPercentile"
                          },
                          "trend": {
                            "type": [
                              "object",
                              "null"
                            ],
                            "description": "vs1hAgoPct, vs2to4hAgoPct, direction rising|falling|flat|unknown"
                          },
                          "spike": {
                            "type": "object",
                            "description": "isSpike, vsDayMedianPct, vsRecentSigma"
                          },
                          "recommendation": {
                            "type": "object",
                            "description": "action send_now|wait|wait_if_flexible, reason, detail, bestHourUtc, savingPctIfWait"
                          }
                        }
                      }
                    },
                    "errors": {
                      "type": "object",
                      "description": "chains that could not be read (the call is charged only if at least one chain answered with 24h history)"
                    },
                    "notes": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    }
                  }
                },
                "example": {
                  "updatedAt": "2026-11-21T06:00:00.000Z",
                  "summary": {
                    "cheapestChainNow": {
                      "chain": "base",
                      "erc20TransferUsd": 0.00041
                    },
                    "spikes": [],
                    "waitOn": [
                      "ethereum"
                    ],
                    "sendNowOn": [
                      "base"
                    ]
                  },
                  "chains": {
                    "ethereum": {
                      "chainId": 1,
                      "name": "Ethereum",
                      "nativeSymbol": "ETH",
                      "block": 23900000,
                      "node": "ethereum-rpc.publicnode.com",
                      "blockTimeS": 12.04,
                      "feeModel": "eip1559",
                      "now": {
                        "baseFeeGwei": 1.82,
                        "priorityFeeGwei": 0.05,
                        "feePerGasGwei": 1.87,
                        "erc20TransferUsd": 0.19
                      },
                      "last24h": {
                        "samples": [
                          {
                            "hoursAgo": 1,
                            "at": "2026-11-21T05:00:00.000Z",
                            "baseFeeGwei": 1.41
                          }
                        ],
                        "usableSamples": 24,
                        "minGwei": 0.62,
                        "medianGwei": 1.2,
                        "maxGwei": 3.9,
                        "cheapest": {
                          "at": "2026-11-21T03:00:00.000Z",
                          "hourUtc": 3,
                          "baseFeeGwei": 0.62
                        },
                        "nowPercentile": 79
                      },
                      "trend": {
                        "vs1hAgoPct": 29.1,
                        "vs2to4hAgoPct": 41.7,
                        "direction": "rising"
                      },
                      "spike": {
                        "isSpike": false,
                        "vsDayMedianPct": 51.7,
                        "vsRecentSigma": 1.1,
                        "recentWindowBlocks": 64
                      },
                      "recommendation": {
                        "action": "wait_if_flexible",
                        "reason": "above_typical",
                        "detail": "Base fee is 51.7% above its 24h median; ...",
                        "bestHourUtc": 3,
                        "savingPctIfWait": 65.9
                      }
                    }
                  },
                  "notes": [
                    "last24h: 24 samples ..."
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Invalid input (no payment touched)"
          },
          "402": {
            "description": "Payment required. x402: PAYMENT-REQUIRED header (v2) or JSON body (v1). MPP: WWW-Authenticate: Payment (method tempo, intent charge)."
          },
          "502": {
            "description": "Upstream unavailable (not charged)"
          }
        }
      }
    },
    "/v1/random": {
      "get": {
        "operationId": "random",
        "summary": "Verifiable Randomness",
        "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.",
        "tags": [
          "random",
          "rng",
          "randomness",
          "csprng",
          "uuid",
          "dice",
          "shuffle",
          "raffle",
          "lottery",
          "provably-fair",
          "verifiable",
          "drand",
          "agents"
        ],
        "security": [],
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.001"
          },
          "protocols": [
            {
              "x402": {
                "network": "eip155:8453",
                "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
                "payTo": "0x2078F0D12eD8351FD05df9Bd9716Ab3d9D82505c"
              }
            },
            {
              "mpp": {
                "method": "tempo",
                "intent": "charge",
                "currency": "0x20c000000000000000000000b9537d11c60e8b50"
              }
            }
          ],
          "offers": [
            {
              "amount": "1000",
              "currency": "0x20c000000000000000000000b9537d11c60e8b50",
              "description": "Verifiable Randomness: 0.001 in USDC.e on Tempo (MPP, pull mode)",
              "intent": "charge",
              "method": "tempo"
            }
          ]
        },
        "parameters": [
          {
            "name": "kind",
            "in": "query",
            "required": false,
            "description": "What to draw (default int)",
            "schema": {
              "type": "string",
              "enum": [
                "int",
                "float",
                "bytes",
                "uuid",
                "dice",
                "coin",
                "choice",
                "shuffle"
              ]
            },
            "example": "int"
          },
          {
            "name": "n",
            "in": "query",
            "required": false,
            "description": "How many values (1-100, default 1); for bytes the length (1-1024, default 32)",
            "schema": {
              "type": "integer"
            },
            "example": 3
          },
          {
            "name": "min",
            "in": "query",
            "required": false,
            "description": "int: lowest value (default 1)",
            "schema": {
              "type": "integer"
            },
            "example": 1
          },
          {
            "name": "max",
            "in": "query",
            "required": false,
            "description": "int: highest value, inclusive (default 100)",
            "schema": {
              "type": "integer"
            },
            "example": 100
          },
          {
            "name": "unique",
            "in": "query",
            "required": false,
            "description": "int/choice: 1 = no repeats",
            "schema": {
              "type": "string",
              "enum": [
                "0",
                "1"
              ]
            },
            "example": "1"
          },
          {
            "name": "sides",
            "in": "query",
            "required": false,
            "description": "dice: sides per die (2-1000, default 6)",
            "schema": {
              "type": "integer"
            },
            "example": 6
          },
          {
            "name": "items",
            "in": "query",
            "required": false,
            "description": "choice/shuffle: comma-separated list (2-100 items)",
            "schema": {
              "type": "string"
            },
            "example": "alice,bob,carol"
          },
          {
            "name": "source",
            "in": "query",
            "required": false,
            "description": "csprng (default) or drand = publicly verifiable",
            "schema": {
              "type": "string",
              "enum": [
                "csprng",
                "drand"
              ]
            },
            "example": "csprng"
          },
          {
            "name": "round",
            "in": "query",
            "required": false,
            "description": "drand only: use this beacon round (pin a future round in advance; default latest)",
            "schema": {
              "type": "integer"
            },
            "example": 34139069
          }
        ],
        "responses": {
          "200": {
            "description": "Paid result",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "kind",
                    "source",
                    "generatedAt"
                  ],
                  "properties": {
                    "kind": {
                      "type": "string",
                      "enum": [
                        "int",
                        "float",
                        "bytes",
                        "uuid",
                        "dice",
                        "coin",
                        "choice",
                        "shuffle"
                      ]
                    },
                    "values": {
                      "type": "array",
                      "description": "drawn values (numbers, strings or list items); absent for kind=bytes"
                    },
                    "hex": {
                      "type": "string",
                      "description": "kind=bytes: 0x-prefixed hex"
                    },
                    "sum": {
                      "type": "integer",
                      "description": "kind=dice: total"
                    },
                    "source": {
                      "type": "string",
                      "enum": [
                        "csprng",
                        "drand"
                      ]
                    },
                    "generatedAt": {
                      "type": "string",
                      "format": "date-time"
                    },
                    "beacon": {
                      "type": "object",
                      "description": "source=drand: round, randomness, signature, chainHash, url to re-fetch it"
                    },
                    "derivation": {
                      "type": "string",
                      "description": "source=drand: exact algorithm to recompute the values"
                    }
                  }
                },
                "example": {
                  "kind": "int",
                  "min": 1,
                  "max": 100,
                  "unique": true,
                  "values": [
                    17,
                    82,
                    5
                  ],
                  "source": "csprng",
                  "generatedAt": "2026-11-21T01:00:00.000Z"
                }
              }
            }
          },
          "400": {
            "description": "Invalid input (no payment touched)"
          },
          "402": {
            "description": "Payment required. x402: PAYMENT-REQUIRED header (v2) or JSON body (v1). MPP: WWW-Authenticate: Payment (method tempo, intent charge)."
          },
          "502": {
            "description": "Upstream unavailable (not charged)"
          }
        }
      }
    },
    "/v1/spend": {
      "get": {
        "operationId": "spend",
        "summary": "Agent Spend Report: where did this wallet's money go? (x402 + MPP)",
        "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.",
        "tags": [
          "wallet",
          "spending",
          "audit",
          "agent-wallet",
          "payments",
          "x402",
          "mpp",
          "usdc",
          "tempo",
          "base",
          "stablecoin",
          "transactions",
          "analytics",
          "agents"
        ],
        "security": [],
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.01"
          },
          "protocols": [
            {
              "x402": {
                "network": "eip155:8453",
                "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
                "payTo": "0x2078F0D12eD8351FD05df9Bd9716Ab3d9D82505c"
              }
            },
            {
              "mpp": {
                "method": "tempo",
                "intent": "charge",
                "currency": "0x20c000000000000000000000b9537d11c60e8b50"
              }
            }
          ],
          "offers": [
            {
              "amount": "10000",
              "currency": "0x20c000000000000000000000b9537d11c60e8b50",
              "description": "Agent Spend Report: where did this wallet's money go? (x402 + MPP): 0.010 in USDC.e on Tempo (MPP, pull mode)",
              "intent": "charge",
              "method": "tempo"
            }
          ]
        },
        "parameters": [
          {
            "name": "address",
            "in": "query",
            "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.",
            "schema": {
              "type": "string"
            },
            "example": "0xa1d1c0cf717402ff3651aa4873ccf96410b01978"
          },
          {
            "name": "hours",
            "in": "query",
            "required": false,
            "description": "Look-back window in hours, 1-24 (default 24)",
            "schema": {
              "type": "integer"
            },
            "example": 24
          },
          {
            "name": "chains",
            "in": "query",
            "required": false,
            "description": "Comma-separated subset of base, tempo (default both)",
            "schema": {
              "type": "string"
            },
            "example": "base,tempo"
          }
        ],
        "responses": {
          "200": {
            "description": "Paid result",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "updatedAt",
                    "summary",
                    "chains"
                  ],
                  "properties": {
                    "updatedAt": {
                      "type": "string",
                      "format": "date-time"
                    },
                    "summary": {
                      "type": "object",
                      "description": "address, addressSource (payer_x402 | payer_mpp | param | example), hours, totalSpentUsd, totalReceivedUsd, netUsd, payments, likelyPaidCalls, topPayees (across chains), headline",
                      "properties": {
                        "address": {
                          "type": "string"
                        },
                        "addressSource": {
                          "type": "string",
                          "enum": [
                            "payer_x402",
                            "payer_mpp",
                            "param",
                            "example"
                          ]
                        },
                        "hours": {
                          "type": "integer"
                        },
                        "totalSpentUsd": {
                          "type": "number"
                        },
                        "totalReceivedUsd": {
                          "type": "number"
                        },
                        "netUsd": {
                          "type": "number"
                        },
                        "payments": {
                          "type": "integer"
                        },
                        "likelyPaidCalls": {
                          "type": "integer"
                        },
                        "topPayees": {
                          "type": "array",
                          "items": {
                            "type": "object"
                          }
                        },
                        "headline": {
                          "type": "string"
                        }
                      }
                    },
                    "chains": {
                      "type": "object",
                      "additionalProperties": {
                        "type": "object",
                        "properties": {
                          "chain": {
                            "type": "string"
                          },
                          "chainId": {
                            "type": "integer"
                          },
                          "asset": {
                            "type": "string"
                          },
                          "rail": {
                            "type": "string"
                          },
                          "window": {
                            "type": "object",
                            "description": "hours, fromBlock, toBlock, from, to, blockTimeS"
                          },
                          "out": {
                            "type": "object",
                            "description": "count, totalUsd, payees, likelyPaidCalls {count,totalUsd}, averageUsd, largest, topPayees [{address,label,count,totalUsd,lastAt}], latest [{at,to,label,amountUsd,tx}]"
                          },
                          "in": {
                            "type": "object",
                            "description": "count, totalUsd, payers, topPayers"
                          },
                          "netUsd": {
                            "type": "number"
                          }
                        }
                      }
                    },
                    "errors": {
                      "type": "object",
                      "description": "chains that could not be read (charged only if at least one chain was read)"
                    },
                    "notes": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    }
                  }
                },
                "example": {
                  "updatedAt": "2026-11-21T07:00:00.000Z",
                  "summary": {
                    "address": "0xa1d1c0cf717402ff3651aa4873ccf96410b01978",
                    "addressSource": "payer_x402",
                    "hours": 24,
                    "totalSpentUsd": 0.231,
                    "totalReceivedUsd": 0,
                    "netUsd": -0.231,
                    "payments": 23,
                    "likelyPaidCalls": 23,
                    "topPayees": [
                      {
                        "address": "0x7c1f5120b22ce1fc0e7972e68f322d40b49578ad",
                        "label": "Mira Vistas (mira-vistas.agent-arena-base.workers.dev)",
                        "count": 1,
                        "totalUsd": 0.01,
                        "lastAt": "2026-11-21T02:45:40.000Z",
                        "chain": "base",
                        "rail": "x402"
                      }
                    ],
                    "headline": "In the last 24h 0xa1d1... made 23 stablecoin payments ($0.231), 23 of them $1 or less (likely paid API calls), and received $0. Base/x402 23 out ($0.231), 0 in ($0); Tempo/MPP 0 out ($0), 0 in ($0)."
                  },
                  "chains": {
                    "base": {
                      "chain": "base",
                      "chainId": 8453,
                      "name": "Base",
                      "asset": "USDC",
                      "rail": "x402",
                      "node": "base-rpc.publicnode.com",
                      "window": {
                        "hours": 24,
                        "fromBlock": 60217327,
                        "toBlock": 60260526,
                        "from": "2026-11-20T07:00:00.000Z",
                        "to": "2026-11-21T07:00:00.000Z",
                        "blockTimeS": 2
                      },
                      "out": {
                        "count": 23,
                        "totalUsd": 0.231,
                        "payees": 21,
                        "likelyPaidCalls": {
                          "count": 23,
                          "totalUsd": 0.231,
                          "rule": "outgoing payments of $1 or less"
                        },
                        "averageUsd": 0.010043,
                        "largest": {
                          "to": "0x2d142b3e780c08a5bf5f3c912dbffd6bde29fd60",
                          "label": "laok-audit / perp-funding-rates (agent-arena-base.workers.dev)",
                          "amountUsd": 0.02,
                          "at": "2026-11-21T02:59:00.000Z",
                          "tx": "0xfa3f..."
                        },
                        "topPayees": [],
                        "latest": [
                          {
                            "at": "2026-11-21T03:13:00.000Z",
                            "to": "0x73218b6438e15e75b115ea47837f2a7fde79f623",
                            "label": "Agent due-diligence gateway (bolt-x402.agent-arena-base.workers.dev)",
                            "amountUsd": 0.01,
                            "tx": "0x8f7d..."
                          }
                        ]
                      },
                      "in": {
                        "count": 0,
                        "totalUsd": 0,
                        "payers": 0,
                        "topPayers": []
                      },
                      "netUsd": -0.231
                    }
                  },
                  "notes": [
                    "Reads USDC (Base) and USDC.e (Tempo) Transfer logs ..."
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Invalid input (no payment touched)"
          },
          "402": {
            "description": "Payment required. x402: PAYMENT-REQUIRED header (v2) or JSON body (v1). MPP: WWW-Authenticate: Payment (method tempo, intent charge)."
          },
          "502": {
            "description": "Upstream unavailable (not charged)"
          }
        }
      }
    },
    "/v1/launch-check": {
      "get": {
        "operationId": "launch_check",
        "summary": "Seller Launch Check: will the buyers that pay x402 sellers buy your endpoint?",
        "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=.",
        "tags": [
          "x402",
          "mpp",
          "seller-tools",
          "launch",
          "go-to-market",
          "discovery",
          "listing",
          "audit",
          "readiness",
          "settled",
          "agent402",
          "agentcash",
          "x402scan",
          "nohumans",
          "dexter",
          "bazaar",
          "developer-tools"
        ],
        "security": [],
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.05"
          },
          "protocols": [
            {
              "x402": {
                "network": "eip155:8453",
                "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
                "payTo": "0x2078F0D12eD8351FD05df9Bd9716Ab3d9D82505c"
              }
            },
            {
              "mpp": {
                "method": "tempo",
                "intent": "charge",
                "currency": "0x20c000000000000000000000b9537d11c60e8b50"
              }
            }
          ],
          "offers": [
            {
              "amount": "50000",
              "currency": "0x20c000000000000000000000b9537d11c60e8b50",
              "description": "Seller Launch Check: will the buyers that pay x402 sellers buy your endpoint?: 0.050 in USDC.e on Tempo (MPP, pull mode)",
              "intent": "charge",
              "method": "tempo"
            }
          ]
        },
        "parameters": [
          {
            "name": "url",
            "in": "query",
            "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.",
            "schema": {
              "type": "string"
            },
            "example": "https://weather.cyberwarex.com/current"
          }
        ],
        "responses": {
          "200": {
            "description": "Paid result",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "target",
                    "checkedAt",
                    "http",
                    "score",
                    "verdict",
                    "buyers",
                    "fixes"
                  ],
                  "properties": {
                    "target": {
                      "type": "string"
                    },
                    "origin": {
                      "type": "string"
                    },
                    "checkedAt": {
                      "type": "string",
                      "format": "date-time"
                    },
                    "http": {
                      "type": "object",
                      "description": "status and latency of the unpaid GET"
                    },
                    "price": {
                      "type": "object",
                      "description": "lowest USD price; Base, Solana and MPP terms as advertised"
                    },
                    "rails": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "score": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 100
                    },
                    "verdict": {
                      "type": "string",
                      "enum": [
                        "ready",
                        "mostly_ready",
                        "needs_work",
                        "not_buyable"
                      ]
                    },
                    "summary": {
                      "type": "object"
                    },
                    "buyers": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "string"
                          },
                          "name": {
                            "type": "string"
                          },
                          "pays": {
                            "type": "string"
                          },
                          "status": {
                            "type": "string",
                            "enum": [
                              "ready",
                              "partial",
                              "blocked"
                            ]
                          },
                          "findings": {
                            "type": "array"
                          }
                        }
                      }
                    },
                    "checks": {
                      "type": "array",
                      "description": "protocol checks: level pass|warn|fail|info"
                    },
                    "discovery": {
                      "type": "object"
                    },
                    "inputs": {
                      "type": "object"
                    },
                    "fixes": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "priority": {
                            "type": "integer"
                          },
                          "buyer": {
                            "type": "string"
                          },
                          "action": {
                            "type": "string"
                          },
                          "snippet": {
                            "type": "string"
                          }
                        }
                      }
                    },
                    "facts": {
                      "type": "object",
                      "description": "each buyer's buying rules with source and date"
                    }
                  }
                },
                "example": {
                  "target": "https://weather.cyberwarex.com/current",
                  "origin": "https://weather.cyberwarex.com",
                  "checkedAt": "2026-11-21T10:30:00.000Z",
                  "http": {
                    "status": 402,
                    "ms": 412
                  },
                  "price": {
                    "lowestUsd": 0.001,
                    "base": {
                      "usd": 0.001,
                      "payTo": "0x058d0cc5cc97e61e8a9f38d6d6365bce525921b2"
                    },
                    "solana": null,
                    "mpp": null
                  },
                  "rails": [
                    "x402-base"
                  ],
                  "score": 62,
                  "verdict": "mostly_ready",
                  "summary": {
                    "ready": 3,
                    "partial": 4,
                    "blocked": 0
                  },
                  "buyers": [
                    {
                      "id": "settled_scout",
                      "name": "Settled scout",
                      "pays": "Pays listed price, about weekly per endpoint up to $0.25 (Base USDC)",
                      "status": "ready",
                      "findings": [
                        {
                          "level": "pass",
                          "message": "Price $0.001 is within the weekly band (up to $0.25)."
                        }
                      ]
                    }
                  ],
                  "checks": [
                    {
                      "id": "status",
                      "level": "pass",
                      "message": "HTTP 402 in 412 ms."
                    }
                  ],
                  "discovery": {
                    "wellKnownX402": 404,
                    "listedInWellKnown": false,
                    "openapi": 200,
                    "openapiOperation": "GET /current",
                    "llmsTxt": false,
                    "mcp": "GET 404"
                  },
                  "inputs": {
                    "requiredWithoutExample": [],
                    "requiredWithExample": [],
                    "sources": [
                      "extensions.bazaar"
                    ]
                  },
                  "fixes": [
                    {
                      "priority": 3,
                      "buyer": "nohumans",
                      "action": "Expose a remote MCP server at https://weather.cyberwarex.com/mcp ... and list it free on nohumans.directory."
                    }
                  ],
                  "facts": {
                    "settled_scout": "Settled scout (settled.tools/llms.txt, read 2026-11-21): ..."
                  }
                }
              }
            }
          },
          "400": {
            "description": "Invalid input (no payment touched)"
          },
          "402": {
            "description": "Payment required. x402: PAYMENT-REQUIRED header (v2) or JSON body (v1). MPP: WWW-Authenticate: Payment (method tempo, intent charge)."
          },
          "502": {
            "description": "Upstream unavailable (not charged)"
          }
        }
      }
    },
    "/": {
      "get": {
        "summary": "Free",
        "security": [],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/health": {
      "get": {
        "summary": "Free",
        "security": [],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/llms.txt": {
      "get": {
        "summary": "Free",
        "security": [],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api": {
      "get": {
        "summary": "Free",
        "security": [],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/v1/launch-check/peek": {
      "get": {
        "operationId": "launch_check_peek",
        "summary": "Free: Seller Launch Check summary (buyer statuses, no fixes)",
        "security": [],
        "description": "Free preview of /v1/launch-check: per-buyer ready/partial/blocked and the score, without findings, fixes or buyer rules. Rate-limited, cached 10 minutes per URL.",
        "parameters": [
          {
            "name": "url",
            "in": "query",
            "required": true,
            "description": "Full https URL of one of your paid endpoints",
            "schema": {
              "type": "string"
            },
            "example": "https://weather.cyberwarex.com/current"
          }
        ],
        "responses": {
          "200": {
            "description": "Summary"
          },
          "400": {
            "description": "Invalid url"
          },
          "429": {
            "description": "Rate limited"
          },
          "502": {
            "description": "Target unreachable"
          }
        }
      }
    }
  }
}