Repository avatar
Monitoring
v0.3.0
active

verifystack-x402

io.github.verifystack-dev/verifystack-x402

12 pay-per-request web research, DeFi yields, prediction market, calldata & wallet tools via x402.

Documentation

VerifyStack x402 — Crypto Intelligence & Verification API for AI Agents

Real-time cross-exchange funding rate arbitrage scanner, multi-source pre-trade token security audit, and deterministic EVM/Solana signature & risk APIs monetized natively via HTTP 402 (x402) USDC micropayments on Base Mainnet (eip155:8453).

No API keys. No subscriptions. Agents pay per request using standard PAYMENT-REQUIRED / PAYMENT-SIGNATURE headers.


Paid Endpoints (Base Mainnet USDC)

MethodEndpointPrice (USDC)Description
GET/api/live-funding-arb$0.01Live cross-exchange perp funding arbitrage across Hyperliquid, dYdX v4, and Gate.io normalized to hourly spreads & gross APR (20s cache). Query: ?symbol=BTC&limit=15&minApr=10
GET/api/prediction-markets$0.008Live prediction market scanner & cross-venue arbitrage finder across Polymarket, Kalshi, and Manifold Markets (30s cache). Query: ?q=bitcoin&platform=all&minLiquidity=1000&limit=20
GET/api/defi-yields$0.005Live DeFi yield & stablecoin APY scanner powered by DefiLlama: filters by chain/symbol/TVL & scores organic Base APY vs reward emissions (60s cache).
POST/api/decode-tx$0.005EVM transaction decoder & calldata firewall resolving selectors via OpenChain + EVM RPC and flagging unlimited ERC-20/NFT approvals.
POST/api/domain-intel$0.004Domain anti-phishing & trust profiler using Cloudflare DoH (A/MX/SPF/DMARC), RDAP domain age, and HTTPS security headers (60s cache).
GET/api/web-research$0.004Universal tech, news & academic search across HackerNews, GitHub, arXiv, and Wikipedia with zero API keys (60s cache). Query: ?q=x402&sources=all&limit=5
POST/api/clean-url$0.005Web-to-LLM Markdown & metadata extractor: strips ads, scripts, and navigation boilerplate, returning compact Markdown + token estimate (60s cache).
POST/api/wallet-profile$0.008Multichain EVM wallet counterparty & gas profiler across Base, Ethereum, Arbitrum, Optimism, and Polygon (native/USDC balances, EOA vs contract, nonce activity, live gas fees; 20s cache).
POST/api/token-safety$0.008Pre-trade token security & liquidity risk audit combining GoPlus Security, Honeypot.is, and DexScreener (base, ethereum, arbitrum, bsc, polygon, solana).
POST/api/verify-signature$0.005Deterministic signature verifier for evm_personal (EIP-191), evm_eip712, evm_erc1271 (live on-chain Smart Wallet RPC), and ed25519 (Solana Base58/Hex/Base64).
POST/api/arb-net-profit$0.005Exact arbitrage net profit, break-even spread, and APR after fees, slippage, transfer gas, and funding.
POST/api/liquidation-sim$0.005Isolated-margin liquidation price, distance-to-liquidation %, risk/reward, and half-Kelly collateral sizing.

Example Responses

1. GET /api/live-funding-arb?limit=2

{
  "updatedAt": "2026-11-16T15:01:42.964Z",
  "sourcesSucceeded": ["hyperliquid", "dydx", "gateio"],
  "totalOpportunities": 101,
  "opportunities": [
    {
      "symbol": "INIT",
      "longExchange": "hyperliquid",
      "shortExchange": "gateio",
      "longHourlyRatePct": -0.157644,
      "shortHourlyRatePct": -0.0764,
      "hourlySpreadPct": 0.081244,
      "aprGrossPercent": 711.7,
      "longMarkPrice": 0.099624,
      "shortMarkPrice": 0.09947,
      "priceSpreadBps": -15.46,
      "estimatedBreakEvenDays": 0.1
    }
  ]
}

2. POST /api/token-safety

{
  "chain": "base",
  "address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
  "symbol": "USDC",
  "name": "USD Coin",
  "riskScore": 0,
  "verdict": "LOW_RISK",
  "sourcesUsed": ["honeypot_is", "dexscreener"],
  "security": {
    "isHoneypot": false,
    "buyTaxPercent": 0,
    "sellTaxPercent": 0
  },
  "market": {
    "priceUsd": 1.000078,
    "liquidityUsd": 86196.87,
    "volume24hUsd": 1488.85,
    "dexId": "alien-base"
  }
}

Use via MCP (Claude Desktop, Cursor, AI Agents)

Zero-install via npx (once published on npm) or from a local clone:

{
  "mcpServers": {
    "verifystack-x402": {
      "command": "npx",
      "args": ["-y", "verifystack-x402-mcp"],
      "env": {
        "X402_BUYER_KEY": "0xYOUR_BASE_BUYER_PRIVATE_KEY"
      }
    }
  }
}

Or clone and run locally:

git clone https://github.com/verifystack-dev/verifystack-x402.git
cd verifystack-x402
npm install

Code Examples (Python, Node.js, Trading & Agent Bots)

See examples/README.md for all ready-to-run templates:

X402_BUYER_KEY="0xYOUR_BASE_BUYER_PRIVATE_KEY" node examples/agent-workflow.mjs

Inspect payment requirements directly with curl:

curl -i https://x402-crypto-math-api.verifystack.workers.dev/api/live-funding-arb
NPM
verifystack-x402-mcp
Install Command
npm install verifystack-x402-mcp