{
  "schema_version": "1.0",
  "name": "SignGate Agent Risk Utility Workflows",
  "description": "Workflow-first bundles that tell AI agents which x402 risk utilities to buy before payment, signing, routing, or chain-data access.",
  "origin": "https://base-agent-preflight.bytoken2023.workers.dev",
  "openapi_url": "https://base-agent-preflight.bytoken2023.workers.dev/openapi.json",
  "registry_url": "https://base-agent-preflight.bytoken2023.workers.dev/registry.json",
  "endpoints_txt_url": "https://base-agent-preflight.bytoken2023.workers.dev/endpoints.txt",
  "workflows": [
    {
      "id": "ai-buyer-before-paying-x402-api",
      "goal": "Let an autonomous agent decide whether to pay an unknown x402 API.",
      "sequence": [
        "x402-origin-due-diligence",
        "x402-resource-compare",
        "x402-endpoint-preflight",
        "x402-server-trust",
        "agent-payment-guard"
      ],
      "escalation": "Use human review when endpoint metadata is malformed, seller activity is concentrated, or Payment Guard returns REVIEW/BLOCK.",
      "estimated_max_price_usdc": "0.045",
      "operations": [
        {
          "id": "x402-origin-due-diligence",
          "method": "GET",
          "path": "/v1/x402/x402/origin-due-diligence",
          "price_usdc": "$0.01",
          "buy_when": "Before an autonomous buyer spends on an x402scan origin or a newly discovered x402 server.",
          "returns": "Origin/resource count, seller/payment consistency, metadata quality, due-diligence risk score, and recommended next checks.",
          "example_url": "https://base-agent-preflight.bytoken2023.workers.dev/v1/x402/x402/origin-due-diligence?server_url=https%3A%2F%2Fwww.x402scan.com%2Fserver%2Fb0ce6f4e-73e9-431d-b23c-814ac89cc77b&seller=0x94F751f04b98507D31b500b7Ed50bE68A1514873&resources=42&txns=42&buyers=3"
        },
        {
          "id": "x402-resource-compare",
          "method": "GET",
          "path": "/v1/x402/x402/resource-compare",
          "price_usdc": "$0.01",
          "buy_when": "When an agent has multiple x402 resources or servers that could satisfy the same task and needs a ranked choice.",
          "returns": "Ranked resource candidates, decoded price/payment metadata, risk flags, budget fit, and selection rationale.",
          "example_url": "https://base-agent-preflight.bytoken2023.workers.dev/v1/x402/x402/resource-compare?resources=https%3A%2F%2Fbase-agent-preflight.bytoken2023.workers.dev%2Fv1%2Fx402%2Fbase%2Falpha-risk%2Chttps%3A%2F%2Fbase-agent-preflight.bytoken2023.workers.dev%2Fv1%2Fx402%2Fbase%2Ftoken-alpha-snapshot&budget_usdc=0.02"
        },
        {
          "id": "x402-endpoint-preflight",
          "method": "GET",
          "path": "/v1/x402/web/endpoint-preflight",
          "price_usdc": "$0.005",
          "buy_when": "Before paying an unknown x402 endpoint, especially when the buyer is an autonomous agent.",
          "returns": "Decoded payment requirements, payTo, network, amount, metadata validity, and malformed/unsafe flags.",
          "example_url": "https://base-agent-preflight.bytoken2023.workers.dev/v1/x402/web/endpoint-preflight?url=https%3A%2F%2Fx402.twit.sh%2Ftweets%2Fby%2Fid%3Fid%3D1110302988"
        },
        {
          "id": "x402-server-trust",
          "method": "GET",
          "path": "/v1/x402/x402/server-trust",
          "price_usdc": "$0.01",
          "buy_when": "When an AI buyer is comparing x402 API servers or deciding whether marketplace activity looks credible.",
          "returns": "Server trust score, buyer concentration risk, micro-payment/ranking risk, freshness, chain coverage, seller enrichment, and decision hint.",
          "example_url": "https://base-agent-preflight.bytoken2023.workers.dev/v1/x402/x402/server-trust?server_url=https%3A%2F%2Fbase-agent-preflight.bytoken2023.workers.dev&seller=0x94F751f04b98507D31b500b7Ed50bE68A1514873&volume_usdc=109300&txns=9500000&buyers=626&latest_seen_hours=2&chains=base"
        },
        {
          "id": "agent-payment-guard",
          "method": "GET",
          "path": "/v1/x402/payment-guard/evaluate",
          "price_usdc": "$0.01",
          "buy_when": "Before an autonomous agent spends through x402 and needs a policy decision, budget enforcement, and audit trail.",
          "returns": "ALLOW/REVIEW/BLOCK decision, risk score, policy/budget state, reasons, evidence, signed decision token, and reservation metadata.",
          "example_url": "https://base-agent-preflight.bytoken2023.workers.dev/v1/x402/payment-guard/evaluate?url=https%3A%2F%2Fx402.twit.sh%2Ftweets%2Fby%2Fid%3Fid%3D1110302988&session_id=demo-session&request_id=demo-request-1&max_single_usdc=0.10&session_budget_usdc=1.00&daily_budget_usdc=5.00"
        }
      ]
    },
    {
      "id": "wallet-or-token-kyt-preflight",
      "goal": "Screen an address or token before payment, onboarding, copytrading, or contract interaction.",
      "sequence": [
        "public-wallet-risk-lookup",
        "base-address-preflight",
        "bcs-address-labels",
        "base-wallet-counterparty",
        "evm-transaction-intent"
      ],
      "escalation": "Buy the label/counterparty steps only when the first preflight returns medium/high risk or the value at risk is material.",
      "estimated_max_price_usdc": "0.150",
      "operations": [
        {
          "id": "public-wallet-risk-lookup",
          "method": "GET",
          "path": "/v1/x402/address-risk/lookup",
          "price_usdc": "$0.10",
          "buy_when": "When an agent, KYT workflow, VASP, or payment backend needs to screen one wallet before onboarding, payout, or interaction.",
          "returns": "Hit/no-hit, risk score, risk level, labels, sanctions/scam/ransomware/stablecoin blacklist categories, confidence, source keys, and evidence URLs.",
          "example_url": "https://base-agent-preflight.bytoken2023.workers.dev/v1/x402/address-risk/lookup?chain=ETH&address=0x94F751f04b98507D31b500b7Ed50bE68A1514873"
        },
        {
          "id": "base-address-preflight",
          "method": "GET",
          "path": "/v1/x402/base/address-preflight",
          "price_usdc": "$0.02",
          "buy_when": "Before paying, onboarding, allowlisting, or routing a Base address into an automated workflow.",
          "returns": "Risk score, risk level, identity type, scam/reputation flags, verification status, recent transfer summary, and decision hint.",
          "example_url": "https://base-agent-preflight.bytoken2023.workers.dev/v1/x402/base/address-preflight?address=0x94F751f04b98507D31b500b7Ed50bE68A1514873"
        },
        {
          "id": "bcs-address-labels",
          "method": "GET",
          "path": "/v1/x402/bcs/labels",
          "price_usdc": "$0.02",
          "buy_when": "When an agent needs an address label or entity hint from BlockchainSecurity/MistTrack-backed data.",
          "returns": "Upstream BlockchainSecurity label response, request id, credit headers, provenance, and upstream envelope.",
          "example_url": "https://base-agent-preflight.bytoken2023.workers.dev/v1/x402/bcs/labels?chain=ethereum&address=0x28c6c06298d514db089934071355e5743bf21d60&sources=all"
        },
        {
          "id": "base-wallet-counterparty",
          "method": "GET",
          "path": "/v1/x402/base/wallet-counterparty",
          "price_usdc": "$0.005",
          "buy_when": "When a risk agent needs to know who a wallet has recently interacted with before a higher-cost enrichment.",
          "returns": "Ranked counterparties, interaction counts, transfer context, and concentration signals.",
          "example_url": "https://base-agent-preflight.bytoken2023.workers.dev/v1/x402/base/wallet-counterparty?address=0x94F751f04b98507D31b500b7Ed50bE68A1514873"
        },
        {
          "id": "evm-transaction-intent",
          "method": "GET",
          "path": "/v1/x402/base/transaction-intent",
          "price_usdc": "$0.005",
          "buy_when": "Before an agent signs EVM calldata, approves a spender, or submits an unknown transaction.",
          "returns": "Decoded selector, token transfer/approval intent, unlimited-spend flags, unknown selector warnings, and decision hint.",
          "example_url": "https://base-agent-preflight.bytoken2023.workers.dev/v1/x402/base/transaction-intent?to=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913&data=0x095ea7b300000000000000000000000094f751f04b98507d31b500b7ed50be68a1514873ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff&value=0"
        }
      ]
    },
    {
      "id": "kyt-or-aml-local-dataset-import",
      "goal": "Import source-attributed wallet risk intelligence into a KYT, AML, VASP, wallet-security, or payment-risk system.",
      "sequence": [
        "public-wallet-risk-sample",
        "public-wallet-risk-snapshot",
        "public-wallet-risk-delta",
        "public-wallet-risk-lookup",
        "bcs-address-risk-score",
        "bcs-fund-trace"
      ],
      "escalation": "Use BCS risk score or fund trace only for addresses that hit the public feed, handle high-value flows, or require investigation evidence.",
      "estimated_max_price_usdc": "598.745",
      "operations": [
        {
          "id": "public-wallet-risk-sample",
          "method": "GET",
          "path": "/v1/x402/address-risk/sample",
          "price_usdc": "$0.005",
          "buy_when": "When a buyer or agent wants to inspect the dataset schema, provenance fields, evidence URLs, and label format before buying the full snapshot.",
          "returns": "A small paid JSON sample from the hosted wallet-risk dataset plus manifest counts, schema hints, and next recommended paid resources.",
          "example_url": "https://base-agent-preflight.bytoken2023.workers.dev/v1/x402/address-risk/sample?limit=5"
        },
        {
          "id": "public-wallet-risk-snapshot",
          "method": "GET",
          "path": "/v1/x402/address-risk/snapshot",
          "price_usdc": "$499.00",
          "buy_when": "When a customer wants the complete current wallet-risk intelligence file for local KYT/AML screening or internal enrichment.",
          "returns": "Full JSONL snapshot of active wallet-risk labels with source attribution, confidence, evidence URLs, manifest hashes, and schema metadata.",
          "example_url": "https://base-agent-preflight.bytoken2023.workers.dev/v1/x402/address-risk/snapshot?"
        },
        {
          "id": "public-wallet-risk-delta",
          "method": "GET",
          "path": "/v1/x402/address-risk/delta",
          "price_usdc": "$99.00",
          "buy_when": "When a customer already has a snapshot and wants the latest batch delta without redownloading the whole dataset.",
          "returns": "JSONL batch delta with new/changed labels, on-chain blacklist events, batch metadata, source attribution, and evidence.",
          "example_url": "https://base-agent-preflight.bytoken2023.workers.dev/v1/x402/address-risk/delta?batch_key=2026-W27"
        },
        {
          "id": "public-wallet-risk-lookup",
          "method": "GET",
          "path": "/v1/x402/address-risk/lookup",
          "price_usdc": "$0.10",
          "buy_when": "When an agent, KYT workflow, VASP, or payment backend needs to screen one wallet before onboarding, payout, or interaction.",
          "returns": "Hit/no-hit, risk score, risk level, labels, sanctions/scam/ransomware/stablecoin blacklist categories, confidence, source keys, and evidence URLs.",
          "example_url": "https://base-agent-preflight.bytoken2023.workers.dev/v1/x402/address-risk/lookup?chain=ETH&address=0x94F751f04b98507D31b500b7Ed50bE68A1514873"
        },
        {
          "id": "bcs-address-risk-score",
          "method": "GET",
          "path": "/v1/x402/bcs/address-risk",
          "price_usdc": "$0.15",
          "buy_when": "Before onboarding, paying, accepting deposits from, or routing funds to an Ethereum or Tron address.",
          "returns": "BlockchainSecurity behavior-based risk score, risk level, triggered suspicious behavior patterns, evidence, request id, and credit headers.",
          "example_url": "https://base-agent-preflight.bytoken2023.workers.dev/v1/x402/bcs/address-risk?blockchain=tron&address=TMuA6YqfCeX8EhbfYEg5y7S4DqzSJireY9&symbols=usdt%2Cusdc"
        },
        {
          "id": "bcs-fund-trace",
          "method": "GET",
          "path": "/v1/x402/bcs/trace",
          "price_usdc": "$0.49",
          "buy_when": "When an investigator or KYT workflow needs multi-hop inbound or outbound fund-flow paths from a starting address.",
          "returns": "Expanded multi-hop fund-flow paths, related transactions, configured trace direction/depth/filter metadata, request id, and provenance.",
          "example_url": "https://base-agent-preflight.bytoken2023.workers.dev/v1/x402/bcs/trace?blockchain=tron&address=TMuA6YqfCeX8EhbfYEg5y7S4DqzSJireY9&direction=out&depth=2&limit=50"
        }
      ]
    },
    {
      "id": "stablecoin-payout-screening",
      "goal": "Check whether a payout or recipient wallet appears in sanctions, scam, ransomware, or stablecoin issuer blacklist intelligence.",
      "sequence": [
        "public-wallet-risk-sample",
        "public-wallet-risk-lookup",
        "bcs-wallet-overview",
        "bcs-address-classify",
        "bcs-address-risk-score"
      ],
      "escalation": "Block or require manual review when sanctions, stablecoin blacklist, ransomware, or high-confidence scam evidence is present.",
      "estimated_max_price_usdc": "0.435",
      "operations": [
        {
          "id": "public-wallet-risk-sample",
          "method": "GET",
          "path": "/v1/x402/address-risk/sample",
          "price_usdc": "$0.005",
          "buy_when": "When a buyer or agent wants to inspect the dataset schema, provenance fields, evidence URLs, and label format before buying the full snapshot.",
          "returns": "A small paid JSON sample from the hosted wallet-risk dataset plus manifest counts, schema hints, and next recommended paid resources.",
          "example_url": "https://base-agent-preflight.bytoken2023.workers.dev/v1/x402/address-risk/sample?limit=5"
        },
        {
          "id": "public-wallet-risk-lookup",
          "method": "GET",
          "path": "/v1/x402/address-risk/lookup",
          "price_usdc": "$0.10",
          "buy_when": "When an agent, KYT workflow, VASP, or payment backend needs to screen one wallet before onboarding, payout, or interaction.",
          "returns": "Hit/no-hit, risk score, risk level, labels, sanctions/scam/ransomware/stablecoin blacklist categories, confidence, source keys, and evidence URLs.",
          "example_url": "https://base-agent-preflight.bytoken2023.workers.dev/v1/x402/address-risk/lookup?chain=ETH&address=0x94F751f04b98507D31b500b7Ed50bE68A1514873"
        },
        {
          "id": "bcs-wallet-overview",
          "method": "GET",
          "path": "/v1/x402/bcs/wallet-overview",
          "price_usdc": "$0.08",
          "buy_when": "When an agent needs a compact activity and balance profile for an address before deciding whether deeper investigation is worth buying.",
          "returns": "Balances, receipt/payment counts, first and last activity timing, selected asset scope, request id, and provenance.",
          "example_url": "https://base-agent-preflight.bytoken2023.workers.dev/v1/x402/bcs/wallet-overview?blockchain=tron&address=TMuA6YqfCeX8EhbfYEg5y7S4DqzSJireY9&symbols=usdt%2Cusdc"
        },
        {
          "id": "bcs-address-classify",
          "method": "GET",
          "path": "/v1/x402/bcs/address-classify",
          "price_usdc": "$0.10",
          "buy_when": "When an agent needs likely entity type classification for one or many addresses before enrichment or compliance review.",
          "returns": "ML-predicted address type, confidence score, upstream response envelope, request id, and provenance.",
          "example_url": "https://base-agent-preflight.bytoken2023.workers.dev/v1/x402/bcs/address-classify?blockchain=tron&addresses=TMuA6YqfCeX8EhbfYEg5y7S4DqzSJireY9"
        },
        {
          "id": "bcs-address-risk-score",
          "method": "GET",
          "path": "/v1/x402/bcs/address-risk",
          "price_usdc": "$0.15",
          "buy_when": "Before onboarding, paying, accepting deposits from, or routing funds to an Ethereum or Tron address.",
          "returns": "BlockchainSecurity behavior-based risk score, risk level, triggered suspicious behavior patterns, evidence, request id, and credit headers.",
          "example_url": "https://base-agent-preflight.bytoken2023.workers.dev/v1/x402/bcs/address-risk?blockchain=tron&address=TMuA6YqfCeX8EhbfYEg5y7S4DqzSJireY9&symbols=usdt%2Cusdc"
        }
      ]
    },
    {
      "id": "trading-bot-fast-filter",
      "goal": "Keep bot checks cheap while preserving a path to deeper review.",
      "sequence": [
        "base-alpha-risk-context",
        "base-token-exit-risk",
        "base-token-alpha-snapshot",
        "base-new-pool-risk",
        "base-dex-market-monitor"
      ],
      "escalation": "Stop at the 0.003 USDC filter for low-value candidates; continue only for high-alpha or suspicious tokens.",
      "estimated_max_price_usdc": "0.017",
      "operations": [
        {
          "id": "base-alpha-risk-context",
          "method": "GET",
          "path": "/v1/x402/base/alpha-risk",
          "price_usdc": "$0.003",
          "buy_when": "As a cheap first-pass screen before copying, buying, or interacting with a Base wallet or token.",
          "returns": "Risk score, alpha score, trade bias, wallet/token context, machine tags, and next action.",
          "example_url": "https://base-agent-preflight.bytoken2023.workers.dev/v1/x402/base/alpha-risk?subject=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913&kind=auto"
        },
        {
          "id": "base-token-exit-risk",
          "method": "GET",
          "path": "/v1/x402/base/token-exit-risk",
          "price_usdc": "$0.003",
          "buy_when": "Before a trading bot enters or keeps a Base token position and needs to know whether exit liquidity or sellability looks fragile.",
          "returns": "Exit-risk score, liquidity depth, volume/liquidity ratio, sell pressure, pair-age context, flags, and bot action guidance.",
          "example_url": "https://base-agent-preflight.bytoken2023.workers.dev/v1/x402/base/token-exit-risk?token=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
        },
        {
          "id": "base-token-alpha-snapshot",
          "method": "GET",
          "path": "/v1/x402/base/token-alpha-snapshot",
          "price_usdc": "$0.003",
          "buy_when": "Before a bot decides whether a Base token has enough liquidity/activity to continue analysis.",
          "returns": "Liquidity, volume, buy/sell imbalance, risk flags, and trade bias.",
          "example_url": "https://base-agent-preflight.bytoken2023.workers.dev/v1/x402/base/token-alpha-snapshot?token=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
        },
        {
          "id": "base-new-pool-risk",
          "method": "GET",
          "path": "/v1/x402/base/new-pool-risk",
          "price_usdc": "$0.003",
          "buy_when": "Before buying a newly launched Base pool or letting a bot chase launch-stage liquidity.",
          "returns": "Pair age, liquidity, activity imbalance, contract flags, launch-stage risk score, and next action.",
          "example_url": "https://base-agent-preflight.bytoken2023.workers.dev/v1/x402/base/new-pool-risk?token=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
        },
        {
          "id": "base-dex-market-monitor",
          "method": "GET",
          "path": "/v1/x402/base/dex-market-monitor",
          "price_usdc": "$0.005",
          "buy_when": "Before a bot trades a Base token or when an agent needs live DEX liquidity and activity context.",
          "returns": "DEX pair, price, liquidity, volume, buys/sells, and market-risk signals.",
          "example_url": "https://base-agent-preflight.bytoken2023.workers.dev/v1/x402/base/dex-market-monitor?token=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
        }
      ]
    },
    {
      "id": "agent-tool-supply-chain",
      "goal": "Preflight a tool, API, dependency, or agent before an AI runtime imports or delegates to it.",
      "sequence": [
        "domain-trust-preflight",
        "openapi-spec-preflight",
        "a2a-agent-card-preflight",
        "npm-package-preflight",
        "pypi-package-preflight",
        "github-repository-health"
      ],
      "escalation": "Block or require review when package vulnerabilities, stale repos, unsafe domains, or mismatched agent endpoints appear.",
      "estimated_max_price_usdc": "0.030",
      "operations": [
        {
          "id": "domain-trust-preflight",
          "method": "GET",
          "path": "/v1/x402/web/domain-trust-preflight",
          "price_usdc": "$0.005",
          "buy_when": "Before an agent trusts a domain, follows a hosted API, or sends users to a web destination.",
          "returns": "DNS, DNSSEC, mail, CNAME, RDAP registration age/expiration, and trust signals.",
          "example_url": "https://base-agent-preflight.bytoken2023.workers.dev/v1/x402/web/domain-trust-preflight?domain=github.com"
        },
        {
          "id": "openapi-spec-preflight",
          "method": "GET",
          "path": "/v1/x402/web/openapi-preflight",
          "price_usdc": "$0.005",
          "buy_when": "Before an AI runtime imports, calls, or pays for a public API described by OpenAPI.",
          "returns": "OpenAPI validity, server URLs, authentication declarations, operation coverage, content fingerprint, and warnings.",
          "example_url": "https://base-agent-preflight.bytoken2023.workers.dev/v1/x402/web/openapi-preflight?url=https%3A%2F%2Fbase-agent-preflight.bytoken2023.workers.dev%2Fopenapi.json"
        },
        {
          "id": "a2a-agent-card-preflight",
          "method": "GET",
          "path": "/v1/x402/agent/a2a-card-preflight",
          "price_usdc": "$0.005",
          "buy_when": "Before one agent delegates work to another public A2A agent.",
          "returns": "Agent Card discovery, skill/provider/authentication details, endpoint consistency, and unsafe URL flags.",
          "example_url": "https://base-agent-preflight.bytoken2023.workers.dev/v1/x402/agent/a2a-card-preflight?url=https%3A%2F%2Fbase-agent-preflight.bytoken2023.workers.dev"
        },
        {
          "id": "npm-package-preflight",
          "method": "GET",
          "path": "/v1/x402/software/npm-package-preflight",
          "price_usdc": "$0.005",
          "buy_when": "Before a coding agent installs or recommends an npm package.",
          "returns": "Package metadata, maintenance signals, license, dependencies, deprecation, and OSV vulnerability summary.",
          "example_url": "https://base-agent-preflight.bytoken2023.workers.dev/v1/x402/software/npm-package-preflight?package=express&version=4.18.2"
        },
        {
          "id": "pypi-package-preflight",
          "method": "GET",
          "path": "/v1/x402/software/pypi-package-preflight",
          "price_usdc": "$0.005",
          "buy_when": "Before a coding agent installs or recommends a PyPI package.",
          "returns": "PyPI metadata, release age, yanked status, Python requirements, dependencies, license, and OSV vulnerabilities.",
          "example_url": "https://base-agent-preflight.bytoken2023.workers.dev/v1/x402/software/pypi-package-preflight?package=requests&version=latest"
        },
        {
          "id": "github-repository-health",
          "method": "GET",
          "path": "/v1/x402/software/github-repository-health",
          "price_usdc": "$0.005",
          "buy_when": "Before an agent depends on a GitHub repository, library, template, or integration.",
          "returns": "Maintenance, release, archive, license, issue, popularity, and repository health signals.",
          "example_url": "https://base-agent-preflight.bytoken2023.workers.dev/v1/x402/software/github-repository-health?owner=cloudflare&repo=workers-sdk"
        }
      ]
    }
  ]
}