{
  "openapi": "3.1.0",
  "info": {
    "title": "Omnichain Pre-Trade Contract & Token Verifier (x402 v2 + MCP)",
    "version": "4.0.0",
    "description": "7-chain pre-trade smart contract bytecode, SPL/Token-2022 authority & multi-DEX liquidity risk oracle across Base (8453), Solana, Ethereum (1), Arbitrum (42161), Optimism (10), Polygon (137), and BNB Smart Chain (56). Instant x402 v2 settlement in Base USDC or BSC USDC.",
    "contact": {
      "name": "Omnichain Verifier Ops",
      "email": "agents@piggybank-verifier.org",
      "url": "https://piggybank.loth2023ys.workers.dev"
    }
  },
  "servers": [
    {
      "url": "https://piggybank.loth2023ys.workers.dev"
    }
  ],
  "paths": {
    "/v1/payable": {
      "post": {
        "summary": "Pre-Payment Payability Verification for x402 Sellers and BNB Chain ERC-8004 Agents (up to 25 targets)",
        "description": "x402 has no chargebacks, so every dollar of buyer risk has to be resolved before signing. This checks up to 25 seller URLs and returns, per URL, whether it is genuinely payable right now: it probes GET and POST, reads payment terms from BOTH the JSON body and the base64 PAYMENT-REQUIRED response header, and rejects offers that name a zero address or price at zero. Most directories list URLs; this tells you which ones will actually take your money and on which channel the terms arrive.",
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.010000"
          },
          "protocols": [
            {
              "x402": {}
            }
          ]
        },
        "responses": {
          "200": {
            "description": "Verified on-chain risk verdict & multi-DEX liquidity intelligence payload",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "402": {
            "description": "Payment Required (x402 v2 Base Mainnet USDC + BNB Chain USDC)"
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "urls": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "maxItems": 25,
                    "description": "Seller URLs to verify."
                  },
                  "agents": {
                    "type": "array",
                    "items": {
                      "type": "integer"
                    },
                    "maxItems": 25,
                    "description": "BNB Chain ERC-8004 agent ids to verify. Resolved from the registry, then their advertised endpoints are probed."
                  }
                },
                "required": []
              }
            }
          }
        }
      }
    },
    "/v1/exec/transfer": {
      "post": {
        "summary": "Sponsored USDC Transfer Execution on Base (EIP-3009 relay, gas paid by us)",
        "description": "Executes a transfer you have already signed. Submit an EIP-3009 transferWithAuthorization for Base USDC; this service broadcasts it and pays the gas, so your own wallet needs no ETH. Strictly non-custodial: the sender, recipient, amount and nonce are committed inside your signature, so the relay cannot redirect funds, change the amount, or replay the authorization. Returns the confirmed Base transaction receipt with gas actually consumed.",
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.050000"
          },
          "protocols": [
            {
              "x402": {}
            }
          ]
        },
        "responses": {
          "200": {
            "description": "Verified on-chain risk verdict & multi-DEX liquidity intelligence payload",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "402": {
            "description": "Payment Required (x402 v2 Base Mainnet USDC + BNB Chain USDC)"
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "chain": {
                    "type": "string",
                    "enum": [
                      "base"
                    ],
                    "default": "base"
                  },
                  "authorization": {
                    "type": "object",
                    "properties": {
                      "from": {
                        "type": "string"
                      },
                      "to": {
                        "type": "string"
                      },
                      "value": {
                        "type": "string",
                        "description": "USDC base units (6 decimals). Max 250000000 = 250 USDC per relay."
                      },
                      "validAfter": {
                        "type": "string"
                      },
                      "validBefore": {
                        "type": "string"
                      },
                      "nonce": {
                        "type": "string",
                        "description": "32 random bytes, hex."
                      }
                    },
                    "required": [
                      "from",
                      "to",
                      "value",
                      "validBefore",
                      "nonce"
                    ]
                  },
                  "signature": {
                    "type": "object",
                    "properties": {
                      "v": {
                        "type": "integer"
                      },
                      "r": {
                        "type": "string"
                      },
                      "s": {
                        "type": "string"
                      }
                    },
                    "required": [
                      "v",
                      "r",
                      "s"
                    ]
                  }
                },
                "required": [
                  "authorization",
                  "signature"
                ]
              }
            }
          }
        }
      }
    },
    "/v1/rwa/stocks": {
      "get": {
        "summary": "Live BNB Chain Tokenized US Stocks & Commodity Fair-Value + Best-Pool Smart Router Feed",
        "description": "Real-time Wall Street institutional bid/ask fair-value prices decoded from on-chain Metric OMM Q64.64 oracles plus live PancakeSwap V3, Uniswap V3, and 3-pool triangular spreads across NVDAB, TSLAB, AAPLB, SPCXB, QQQB, GOOGLB, MSFTB, METAB, BABAB, MSTRB, SPYB, GMEB, NFLXB, CRCLB, and SLVon - with live pool routing data only. This endpoint returns no executable calldata.",
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.005000"
          },
          "protocols": [
            {
              "x402": {}
            }
          ]
        },
        "responses": {
          "200": {
            "description": "Verified on-chain risk verdict & multi-DEX liquidity intelligence payload",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "402": {
            "description": "Payment Required (x402 v2 Base Mainnet USDC + BNB Chain USDC)"
          }
        },
        "parameters": [
          {
            "name": "symbol",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "amountUsd",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ]
      }
    },
    "/v1/defi/disperse-builder": {
      "get": {
        "summary": "Multi-Wallet Native & ERC-20 Batch Disperse Transaction Builder (Base & BNB Chain)",
        "description": "Builds a gas-optimized multi-recipient payout plan: either a list of native transfers or a single Multicall3 aggregate3 batch of ERC20 transfer() calls. Returns calldata only - this service never signs or broadcasts.",
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.090000"
          },
          "protocols": [
            {
              "x402": {}
            }
          ]
        },
        "responses": {
          "200": {
            "description": "Verified on-chain risk verdict & multi-DEX liquidity intelligence payload",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "402": {
            "description": "Payment Required (x402 v2 Base Mainnet USDC + BNB Chain USDC)"
          }
        },
        "parameters": [
          {
            "name": "chain",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "token",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "recipients",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "amountsWei",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ]
      }
    },
    "/v1/verdict": {
      "get": {
        "summary": "Omnichain Pre-Trade Smart Contract & Token Verdict (7 Chains: Base, Solana, ETH, Arb, OP, Polygon, BSC)",
        "description": "Flagship 7-chain pre-trade safety verdict for AI trading agents across Base (Uniswap V2/V3 + Aerodrome), Solana (SPL + Token-2022 extensions + holder concentration), Ethereum, Arbitrum, Optimism, Polygon, and BNB Smart Chain (PancakeSwap V2/V3). Supports chain=auto cross-chain discovery & impostor clone detection, bytecode proxy/mint/blacklist scanning, and $100/$1,000 slippage impact.",
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.150000"
          },
          "protocols": [
            {
              "x402": {}
            }
          ]
        },
        "responses": {
          "200": {
            "description": "Verified on-chain risk verdict & multi-DEX liquidity intelligence payload",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "402": {
            "description": "Payment Required (x402 v2 Base Mainnet USDC + BNB Chain USDC)"
          }
        },
        "parameters": [
          {
            "name": "address",
            "in": "query",
            "required": true,
            "description": "Target 0x EVM token/contract address OR Base58 Solana mint address.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "chain",
            "in": "query",
            "required": false,
            "description": "Target network: auto (default), base (8453), solana, bsc (56), ethereum (1), arbitrum (42161), optimism (10), or polygon (137).",
            "schema": {
              "type": "string",
              "default": "auto"
            }
          },
          {
            "name": "ref",
            "in": "query",
            "required": false,
            "description": "Optional 0x referrer address for automatic 20% CREATE2 vault revenue split on Base (8453) or BSC (56).",
            "schema": {
              "type": "string"
            }
          }
        ]
      }
    },
    "/v1/token-audit": {
      "get": {
        "summary": "Deep Bytecode, Proxy, Mint Authority & Token-2022 Forensics Audit",
        "description": "Deep bytecode & authority audit across Base, Solana (SPL & Token-2022 PermanentDelegate / TransferFeeConfig / FreezeAuthority), Ethereum, Arbitrum, Optimism, Polygon, and BNB Chain: EIP-1967/Beacon proxy detection, selfdestruct/delegatecall opcodes, hidden mint/tax/blacklist selectors, and ownership status.",
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.100000"
          },
          "protocols": [
            {
              "x402": {}
            }
          ]
        },
        "responses": {
          "200": {
            "description": "Verified on-chain risk verdict & multi-DEX liquidity intelligence payload",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "402": {
            "description": "Payment Required (x402 v2 Base Mainnet USDC + BNB Chain USDC)"
          }
        },
        "parameters": [
          {
            "name": "address",
            "in": "query",
            "required": true,
            "description": "Target 0x EVM contract address or Base58 Solana mint address.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "chain",
            "in": "query",
            "required": false,
            "description": "Target chain slug or numeric chainId (default: auto).",
            "schema": {
              "type": "string",
              "default": "auto"
            }
          },
          {
            "name": "ref",
            "in": "query",
            "required": false,
            "description": "Optional 0x partner wallet for 20% CREATE2 revenue share.",
            "schema": {
              "type": "string"
            }
          }
        ]
      }
    },
    "/v1/liquidity": {
      "get": {
        "summary": "Multi-DEX Liquidity Depth, Pool Discovery & Exact Trade Slippage Simulator",
        "description": "Queries Uniswap V2 + Uniswap V3 + Aerodrome + PancakeSwap V2/V3 + Velodrome + QuickSwap + Solana Raydium/Meteora live liquidity, USD depth, and exact slippage for any custom tradeUsd size across all 7 supported chains.",
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.090000"
          },
          "protocols": [
            {
              "x402": {}
            }
          ]
        },
        "responses": {
          "200": {
            "description": "Verified on-chain risk verdict & multi-DEX liquidity intelligence payload",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "402": {
            "description": "Payment Required (x402 v2 Base Mainnet USDC + BNB Chain USDC)"
          }
        },
        "parameters": [
          {
            "name": "address",
            "in": "query",
            "required": true,
            "description": "Target 0x EVM token address or Base58 Solana mint address.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "chain",
            "in": "query",
            "required": false,
            "description": "Target chain slug or numeric chainId (default: auto).",
            "schema": {
              "type": "string",
              "default": "auto"
            }
          },
          {
            "name": "tradeUsd",
            "in": "query",
            "required": false,
            "description": "Simulated USD trade size for slippage impact.",
            "schema": {
              "type": "string",
              "default": "500"
            }
          },
          {
            "name": "ref",
            "in": "query",
            "required": false,
            "description": "Optional 0x partner wallet for 20% CREATE2 revenue share.",
            "schema": {
              "type": "string"
            }
          }
        ]
      }
    },
    "/v1/governance-audit": {
      "get": {
        "summary": "Token Supply Distribution, Dead-Address Burn Ratio & Owner Privilege Audit",
        "description": "Verifies circulating vs burned token supply (0xdead + 0x0000 on EVM; SPL top-10 holder concentration & mint/freeze authorities on Solana) and exact administrative control surface across all 7 supported networks.",
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.100000"
          },
          "protocols": [
            {
              "x402": {}
            }
          ]
        },
        "responses": {
          "200": {
            "description": "Verified on-chain risk verdict & multi-DEX liquidity intelligence payload",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "402": {
            "description": "Payment Required (x402 v2 Base Mainnet USDC + BNB Chain USDC)"
          }
        },
        "parameters": [
          {
            "name": "address",
            "in": "query",
            "required": true,
            "description": "Target 0x EVM token address or Base58 Solana mint address.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "chain",
            "in": "query",
            "required": false,
            "description": "Target chain slug or numeric chainId (default: auto).",
            "schema": {
              "type": "string",
              "default": "auto"
            }
          },
          {
            "name": "ref",
            "in": "query",
            "required": false,
            "description": "Optional 0x partner wallet for 20% CREATE2 revenue share.",
            "schema": {
              "type": "string"
            }
          }
        ]
      }
    },
    "/v1/batch": {
      "post": {
        "summary": "Omnichain Batch Portfolio & Watchlist Verifier (Up to 5 Tokens Across Mixed Chains)",
        "description": "Audits up to 5 tokens in parallel across ANY mix of Base, Solana, Ethereum, Arbitrum, Optimism, Polygon, and BNB Smart Chain in a single atomic x402 payment.",
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.200000"
          },
          "protocols": [
            {
              "x402": {}
            }
          ]
        },
        "responses": {
          "200": {
            "description": "Verified on-chain risk verdict & multi-DEX liquidity intelligence payload",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "402": {
            "description": "Payment Required (x402 v2 Base Mainnet USDC + BNB Chain USDC)"
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "addresses": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "maxItems": 5,
                    "description": "Up to 5 EVM 0x addresses and/or Base58 Solana mint addresses."
                  },
                  "chain": {
                    "type": "string",
                    "default": "auto",
                    "description": "Default chain or 'auto' for per-address cross-chain detection."
                  }
                },
                "required": [
                  "addresses"
                ]
              }
            }
          }
        }
      }
    }
  }
}