verifystack-x402-mcp
Official# 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.
- **Live Endpoint Root:** `https://x402-crypto-math-api.verifystack.workers.dev`
- **x402scan Registry:** [x402scan.com/server/6f29bbaa-8a3a-40d8-971e-059a789d3019](https://www.x402scan.com/server/6f29bbaa-8a3a-40d8-971e-059a789d3019)
- **TryPoncho Merchant Playground:** [tryponcho.com/m/x402-crypto-math-api.verifystack.workers.dev](https://tryponcho.com/m/x402-crypto-math-api.verifystack.workers.dev)
- **OpenAPI 3.1 Spec:** `https://x402-crypto-math-api.verifystack.workers.dev/openapi.json`
- **Discovery Manifest:** `https://x402-crypto-math-api.verifystack.workers.dev/.well-known/x402`
- **LLM Crawler Index:** `https://x402-crypto-math-api.verifystack.workers.dev/llms.txt`
---
## Paid Endpoints (Base Mainnet USDC)
| Method | Endpoint | Price (USDC) | Description |
| :--- | :--- | :--- | :--- |
| `GET` | `/api/live-funding-arb` | **$0.01** | Live 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.008** | Live 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.005** | Live 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.005** | EVM transaction decoder & calldata firewall resolving selectors via **OpenChain + EVM RPC** and flagging unlimited ERC-20/NFT approvals. |
| `POST` | `/api/domain-intel` | **$0.004** | Domain 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.004** | Universal 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.005** | Web-to-LLM Markdown & metadata extractor: strips ads, scripts, and navigation boilerplate, returning compact Markdown + token estimate (60s cache). |
| `POST` | `/api/wallet-profile` | **$0.008** | Multichain 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.008** | Pre-trade token security & liquidity risk audit combining **GoPlus Security**, **Honeypot.is**, and **DexScreener** (`base`, `ethereum`, `arbitrum`, `bsc`, `polygon`, `solana`). |
| `POST` | `/api/verify-signature` | **$0.005** | Deterministic 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.005** | Exact arbitrage net profit, break-even spread, and APR after fees, slippage, transfer gas, and funding. |
| `POST` | `/api/liquidation-sim` | **$0.005** | Isolated-margin liquidation price, distance-to-liquidation %, risk/reward, and half-Kelly collateral sizing. |
---
## Example Responses
### 1. `GET /api/live-funding-arb?limit=2`
```json
{
"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`
```json
{
"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:
```json
{
"mcpServers": {
"verifystack-x402": {
"command": "npx",
"args": ["-y", "verifystack-x402-mcp"],
"env": {
"X402_BUYER_KEY": "0xYOUR_BASE_BUYER_PRIVATE_KEY"
}
}
}
}
```
Or clone and run locally:
```bash
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](./examples/README.md) for all ready-to-run templates:
- **Python (`x402[httpx,evm]`):** [examples/python-x402-quickstart.py](./examples/python-x402-quickstart.py)
- **Autonomous AI Agent Workflow (5 tools):** [examples/agent-workflow.mjs](./examples/agent-workflow.mjs)
- **4-Layer Pre-Trade Security Gatekeeper:** [examples/pretrade-safety-gate.mjs](./examples/pretrade-safety-gate.mjs)
- **Automated Yield & Arb Monitor Loop:** [examples/arb-monitor-loop.mjs](./examples/arb-monitor-loop.mjs)
- **MCP Client Configs (Claude, Cursor, Windsurf):** [examples/mcp-configs.json](./examples/mcp-configs.json)
- **Minimal Node.js Quickstart:** [examples/quickstart.mjs](./examples/quickstart.mjs)
```bash
X402_BUYER_KEY="0xYOUR_BASE_BUYER_PRIVATE_KEY" node examples/agent-workflow.mjs
```
Inspect payment requirements directly with `curl`:
```bash
curl -i https://x402-crypto-math-api.verifystack.workers.dev/api/live-funding-arb
```
TDQS
Scored across 12 tools
Most tools have clearly distinct targets (domain, wallet, token, transaction, URL, signature, yields, prediction markets). There is some thematic overlap among the arbitrage tools: live_funding_arb scans funding rates, prediction_markets includes cross-venue arbitrage divergences, and arb_net_profit is a profit calculator, which could require a moment of thought to select correctly.
All tools use the same verifystack_ prefix and snake_case, which is highly predictable. The semantic pattern is mixed, however: some names are noun phrases (domain_intel, wallet_profile, token_safety) while others are verb phrases (decode_tx, clean_url, verify_signature).
Twelve tools is a well-scoped set for a crypto/DeFi intelligence API bundle. Each tool covers a distinct capability, and the count stays comfortably within a manageable range without obvious redundancy.
The surface covers a broad range of crypto intelligence workflows: domain trust, funding arbitrage, prediction markets, DeFi yields, transaction decoding, web research, URL cleaning, wallet profiling, token safety, signature verification, and risk simulation. Minor gaps exist, such as no explicit price/quote tool or portfolio tracking, but core investigative and risk-assessment workflows are well represented.