{ "openapi": "3.1.0", "info": { "title": "ArbiPulse — Cross-Market Arbitrage Intelligence API", "version": "1.0.0", "description": "The arbitrage layer for every market — 18 endpoints finding the same thing at two prices. Beyond-finance lanes: prediction-market cross-venue spreads (Polymarket×Kalshi), GPU compute rental arbitrage, AI inference token-price arbitrage, stablecoin parallel-rate premiums (capital-control FX), retail resale margin checks. Finance lanes: DeFi yield spreads, DEX/CEX differentials, perpetual funding-rate carry, sports surebets, ETF/NAV gaps, commodity regionals, statistical pairs. Pay-per-query via x402 USDC on Base mainnet.", "contact": { "name": "The Aslan Group LLC", "url": "https://pulsenetwork.theaslangroupllc.com", "email": "info@theaslangroupllc.com" }, "x-payment-protocol": "x402", "x-payment-network": "eip155:8453", "x-payment-asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "x-agent-use-case": "arbitrage-intelligence", "x-pulse-network": "https://pulsenetwork.vercel.app", "x-guidance": "# ArbiPulse API (x402 pay-per-call)\n\nThe arbitrage layer for every market. 18 endpoints finding the same thing at two prices — prediction-market cross-venue spreads (Polymarket×Kalshi), GPU compute rental arbitrage, AI inference token-price arbitrage, stablecoin parallel-rate premiums (capital-control FX), retail resale margin checks, plus the financial lanes: DeFi yield spreads, DEX/CEX differentials, perpetual funding rates, sports surebets, ETF/NAV gaps, commodity regionals, statistical pairs. Deterministic math, live venue tabl\n\nBase URL: https://arbipulse.theaslangroupllc.com\n\n## Payment\nAll paid endpoints use the x402 protocol (HTTP 402): USDC on Base mainnet (eip155:8453). No API keys, no accounts, no subscriptions — pay per call.\n\n## Agent workflow\n1. Request the endpoint. Unpaid requests receive a 402 challenge with exact price and pay-to details (the challenge is returned before request validation).\n2. Settle with any x402 client (agentcash fetch, x402-fetch, x402-axios) and retry with the X-PAYMENT header.\n3. Responses are JSON. Prices below are fixed per call.\n\n## Paid endpoints\n- GET /api/scanner — $0.1 — Unified Arbitrage Scanner\n- GET /api/perps — $0.1 — Perpetual Futures Funding Rate Carry\n- GET /api/flash — $0.75 — Flash Loan Strategy Builder\n- GET /api/sports — $0.1 — Sports Surebet Scanner\n- GET /api/crypto — $0.07 — CEX Spot Price Arbitrage\n- GET /api/dex — $0.1 — DEX Price Arbitrage\n- GET /api/execute — $0.75 — Execution Package Builder\n- GET /api/calculator — $0.02 — Arbitrage Profit Calculator\n- GET /api/commodity — $0.1 — Commodity Regional Arbitrage\n- GET /api/pairs — $0.15 — Statistical Arbitrage (Pairs Trading)\n- GET /api/spread-tick — $0.02 — Cross-exchange spread tick for one pair\n- GET /api/predmarket-arb — $0.05 — Prediction market cross-venue arbitrage (Polymarket × Kalshi)\n- GET /api/compute-arb — $0.05 — GPU compute price arbitrage (marketplace vs hyperscaler)\n- GET /api/fx-premium — $0.02 — Stablecoin parallel-rate premium (capital-control FX signal)\n- GET /api/inference-arb — $0.05 — AI inference price arbitrage (same model, every provider)\n\nMore APIs from this provider: https://pulsenetwork.theaslangroupllc.com (grouped catalog, all x402)." }, "servers": [ { "url": "https://arbipulse.theaslangroupllc.com" } ], "paths": { "/api/scanner": { "get": { "summary": "Unified Arbitrage Scanner", "description": "Meta-endpoint ranking live arbitrage opportunities across perps funding, DEX/CEX spot, ETF, commodity and sports markets. Returns top opportunities with profit estimates, complexity scores, and execution endpoint links. Does not cover DeFi lending/yield-pool spreads. x-agent-use-case: poll-every-15-minutes to find high-value opportunities.", "operationId": "getScanner", "x-price-usdc": "0.10", "x-agent-use-case": "poll-every-15-minutes", "parameters": [ { "name": "category", "in": "query", "schema": { "type": "string", "enum": [ "all", "dex", "perps", "sports", "etf", "commodity" ], "default": "all" } }, { "name": "min_profit_usd", "in": "query", "schema": { "type": "number", "description": "Minimum net profit per $1,000 stake" } }, { "name": "chain", "in": "query", "schema": { "type": "string", "enum": [ "all", "ethereum", "base", "arbitrum", "optimism" ], "default": "all" } } ], "responses": { "200": { "description": "Ranked arbitrage opportunities", "content": { "application/json": { "schema": { "type": "object" } } } }, "402": { "description": "Payment required — see PAYMENT-REQUIRED header" } }, "x-price-usd": 0.1, "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.100000" }, "protocols": [ { "x402": {} } ] } } }, "/api/perps": { "get": { "summary": "Perpetual Futures Funding Rate Carry", "description": "Delta-neutral carry strategies across Hyperliquid (no KYC wallet-only), Binance, Bybit, GMX, dYdX. Live 8h funding rates. x-agent-use-case: poll-every-8-hours.", "operationId": "getPerpsArb", "x-price-usdc": "0.10", "x-agent-use-case": "poll-every-8-hours", "parameters": [ { "name": "asset", "in": "query", "schema": { "type": "string", "enum": [ "all", "BTC", "ETH", "SOL", "ARB", "OP" ], "default": "all" } }, { "name": "min_apy", "in": "query", "schema": { "type": "number" } }, { "name": "platform", "in": "query", "schema": { "type": "string", "enum": [ "all", "hyperliquid", "binance", "bybit", "gmx", "dydx" ], "default": "all" } } ], "responses": { "200": { "description": "Funding rate carry opportunities", "content": { "application/json": { "schema": { "type": "object" } } } }, "402": { "description": "Payment required" } }, "x-price-usd": 0.1, "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.100000" }, "protocols": [ { "x402": {} } ] } } }, "/api/flash": { "get": { "summary": "Flash Loan Strategy Builder", "description": "ABI-encoded calldata for Aave V3 (0.09% fee) and Balancer (0% fee) flash loans. Includes Solidity executor interface, gas estimates, step-by-step execution. Zero capital required. x-agent-use-case: on-demand before execution.", "operationId": "getFlashLoan", "x-price-usdc": "0.75", "x-agent-use-case": "on-demand", "parameters": [ { "name": "protocol", "in": "query", "schema": { "type": "string", "enum": [ "aave", "balancer" ], "default": "aave" } }, { "name": "asset", "in": "query", "schema": { "type": "string", "enum": [ "USDC", "USDT", "WETH", "WBTC", "DAI" ], "default": "USDC" } }, { "name": "amount", "in": "query", "schema": { "type": "number" } }, { "name": "chain", "in": "query", "schema": { "type": "string", "enum": [ "ethereum", "base", "arbitrum", "optimism", "polygon" ], "default": "base" } }, { "name": "strategy", "in": "query", "schema": { "type": "string", "enum": [ "dex-arb", "yield-arb", "liquidation", "custom" ], "default": "dex-arb" } }, { "name": "receiver", "in": "query", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Flash loan calldata and execution plan", "content": { "application/json": { "schema": { "type": "object" } } } }, "402": { "description": "Payment required" } }, "x-price-usd": 0.75, "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.750000" }, "protocols": [ { "x402": {} } ] } } }, "/api/sports": { "get": { "summary": "Sports Surebet Scanner", "description": "Mathematical guaranteed-profit arbitrage across 80+ global bookmakers. Exact stake allocation per outcome. Soccer, basketball, tennis, cricket, MMA globally. x-agent-use-case: poll-every-30-minutes.", "operationId": "getSportsSurebets", "x-price-usdc": "0.10", "x-agent-use-case": "poll-every-30-minutes", "parameters": [ { "name": "sport", "in": "query", "schema": { "type": "string", "enum": [ "soccer", "basketball", "tennis", "american_football", "baseball", "cricket", "rugby_union", "mma", "all" ], "default": "soccer" } }, { "name": "region", "in": "query", "schema": { "type": "string" } }, { "name": "min_profit_pct", "in": "query", "schema": { "type": "number" } } ], "responses": { "200": { "description": "Surebet opportunities with exact stakes", "content": { "application/json": { "schema": { "type": "object" } } } }, "402": { "description": "Payment required" } }, "x-price-usd": 0.1, "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.100000" }, "protocols": [ { "x402": {} } ] } } }, "/api/crypto": { "get": { "summary": "CEX Spot Price Arbitrage", "description": "Live price comparison across Binance, Coinbase, Kraken, Bybit. Net profit after fees and transfer time. x-agent-use-case: on-demand.", "operationId": "getCexArb", "x-price-usdc": "0.07", "x-agent-use-case": "on-demand", "parameters": [ { "name": "pair", "in": "query", "schema": { "type": "string", "default": "BTC/USDT" } }, { "name": "amount_usd", "in": "query", "schema": { "type": "number" } }, { "name": "exchanges", "in": "query", "schema": { "type": "string" } } ], "responses": { "200": { "description": "CEX price comparison and arb viability", "content": { "application/json": { "schema": { "type": "object" } } } }, "402": { "description": "Payment required" } }, "x-price-usd": 0.07, "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.070000" }, "protocols": [ { "x402": {} } ] } } }, "/api/dex": { "get": { "summary": "DEX Price Arbitrage", "description": "Cross-pool and cross-chain price differentials. Uniswap, Curve, Aerodrome, Trader Joe. MEV competition flagged. Flash loan eligible for same-chain. x-agent-use-case: on-demand.", "operationId": "getDexArb", "x-price-usdc": "0.10", "x-agent-use-case": "on-demand", "parameters": [ { "name": "token", "in": "query", "schema": { "type": "string", "enum": [ "WETH", "USDC", "WBTC", "ARB", "OP", "DAI", "LINK", "UNI" ], "default": "WETH" } }, { "name": "amount_usd", "in": "query", "schema": { "type": "number" } }, { "name": "chains", "in": "query", "schema": { "type": "string" } } ], "responses": { "200": { "description": "DEX price differentials and execution paths", "content": { "application/json": { "schema": { "type": "object" } } } }, "402": { "description": "Payment required" } }, "x-price-usd": 0.1, "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.100000" }, "protocols": [ { "x402": {} } ] } } }, "/api/execute": { "get": { "summary": "Execution Package Builder", "description": "Complete agent-executable plan: calldata, gas params, financial summary, risk assessment, abort conditions. Designed for autonomous agent execution. x-agent-use-case: on-demand before execution.", "operationId": "getExecutionPackage", "x-price-usdc": "0.75", "x-agent-use-case": "on-demand", "parameters": [ { "name": "opportunity_type", "in": "query", "schema": { "type": "string", "enum": [ "perps", "flash", "defi", "dex", "sports" ], "default": "perps" } }, { "name": "asset", "in": "query", "schema": { "type": "string" } }, { "name": "amount_usd", "in": "query", "schema": { "type": "number" } }, { "name": "wallet_address", "in": "query", "schema": { "type": "string" } }, { "name": "chain", "in": "query", "schema": { "type": "string", "enum": [ "ethereum", "base", "arbitrum", "optimism" ], "default": "base" } }, { "name": "slippage_bps", "in": "query", "schema": { "type": "integer", "default": 50 } }, { "name": "long_venue", "in": "query", "schema": { "type": "string" } }, { "name": "short_venue", "in": "query", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Complete execution package with calldata", "content": { "application/json": { "schema": { "type": "object" } } } }, "402": { "description": "Payment required" } }, "x-price-usd": 0.75, "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.750000" }, "protocols": [ { "x402": {} } ] } } }, "/api/calculator": { "get": { "summary": "Arbitrage Profit Calculator", "description": "Pure computation — instant response, no AI. Itemizes taker fees, gas, slippage, flash loan fees, bridge costs, withdrawal fees. Break-even analysis. Scale analysis at 5x/10x/50x. x-agent-use-case: on-demand.", "operationId": "getCalculator", "x-price-usdc": "0.05", "x-agent-use-case": "on-demand", "parameters": [ { "name": "trade_size_usd", "in": "query", "schema": { "type": "number", "default": 10000 } }, { "name": "entry_price", "in": "query", "schema": { "type": "number" } }, { "name": "exit_price", "in": "query", "schema": { "type": "number" } }, { "name": "arb_type", "in": "query", "schema": { "type": "string", "enum": [ "spot", "yield", "perps", "flash", "sports" ], "default": "spot" } }, { "name": "taker_fee_bps", "in": "query", "schema": { "type": "number", "default": 10 } }, { "name": "gas_usd", "in": "query", "schema": { "type": "number", "default": 0.5 } }, { "name": "slippage_bps", "in": "query", "schema": { "type": "number", "default": 5 } }, { "name": "flash_fee_bps", "in": "query", "schema": { "type": "number", "default": 0 } }, { "name": "bridge_fee_usd", "in": "query", "schema": { "type": "number", "default": 0 } }, { "name": "withdrawal_fee_usd", "in": "query", "schema": { "type": "number", "default": 0 } }, { "name": "days", "in": "query", "schema": { "type": "number", "default": 1 } } ], "responses": { "200": { "description": "Profit/loss breakdown with break-even analysis", "content": { "application/json": { "schema": { "type": "object" } } } }, "402": { "description": "Payment required" } }, "x-price-usd": 0.02, "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.020000" }, "protocols": [ { "x402": {} } ] } } }, "/api/commodity": { "get": { "summary": "Commodity Regional Arbitrage", "description": "Cross-regional price differentials with transport cost breakdown. Oil (WTI/Brent/Dubai), natural gas (Henry Hub/TTF/JKM), metals (LME/COMEX/SHFE), agri (CBOT/EURONEXT). Global MENA/LatAm/SEA coverage. Prices are news-derived and labelled per row (no live exchange price tape); regions with no sourced price return null. x-agent-use-case: poll-daily.", "operationId": "getCommodityArb", "x-price-usdc": "0.10", "x-agent-use-case": "poll-daily", "parameters": [ { "name": "commodity", "in": "query", "schema": { "type": "string", "enum": [ "oil", "natural-gas", "copper", "gold", "wheat", "corn", "soybeans", "coffee", "cocoa", "cotton", "lng", "coal" ], "default": "natural-gas" } }, { "name": "unit", "in": "query", "schema": { "type": "string", "enum": [ "bbl", "mmbtu", "ton", "oz", "bushel", "auto" ], "default": "auto" } }, { "name": "regions", "in": "query", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Commodity regional price differentials", "content": { "application/json": { "schema": { "type": "object" } } } }, "402": { "description": "Payment required" } }, "x-price-usd": 0.1, "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.100000" }, "protocols": [ { "x402": {} } ] } } }, "/api/pairs": { "get": { "summary": "Statistical Arbitrage (Pairs Trading)", "description": "Cointegrated pairs analysis with z-score signals. Crypto (BTC/ETH), equities (SPY/QQQ, Asian pairs), forex (AUD/copper), DeFi (ETH/stETH). Entry/exit triggers, hedge ratio, size guidance. x-agent-use-case: poll-daily.", "operationId": "getPairsArb", "x-price-usdc": "0.15", "x-agent-use-case": "poll-daily", "parameters": [ { "name": "asset_a", "in": "query", "schema": { "type": "string" } }, { "name": "asset_b", "in": "query", "schema": { "type": "string" } }, { "name": "asset_class", "in": "query", "schema": { "type": "string", "enum": [ "crypto", "equities", "forex", "defi" ], "default": "crypto" } }, { "name": "lookback_days", "in": "query", "schema": { "type": "integer", "default": 30 } } ], "responses": { "200": { "description": "Pairs trading z-score signal", "content": { "application/json": { "schema": { "type": "object" } } } }, "402": { "description": "Payment required" } }, "x-price-usd": 0.15, "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.150000" }, "protocols": [ { "x402": {} } ] } } }, "/api/spread-tick": { "get": { "summary": "Cross-exchange spread tick for one pair", "description": "Live executable spread across Binance/Coinbase/Kraken/Bybit — best bid/ask venues, spread bps, TRADE/THIN/NONE verdict. $0.02, 30s freshness, deterministic. Escalate to /api/crypto for fees + transfer paths.", "operationId": "api_spread_tick", "parameters": [ { "name": "pair", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Trading pair, e.g. BTC/USDT (default) | ETH/USDT | SOL/USDT" } ], "responses": { "200": { "description": "Tick result" }, "402": { "description": "Payment required" } }, "x-price-usd": 0.02, "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.020000" }, "protocols": [ { "x402": {} } ] } } }, "/api/predmarket-arb": { "get": { "summary": "Prediction market cross-venue arbitrage (Polymarket × Kalshi)", "description": "Matches live Polymarket contracts to Kalshi contracts for the same events and returns per-pair arb math: both leg strategies, gross cost, Kalshi taker fee, net edge per contract, ARB_CANDIDATE/CONVERGENCE_GAP/ALIGNED verdicts, resolution-rules risk flag. Deterministic order-book math, no LLM.", "operationId": "api_predmarket_arb", "parameters": [ { "name": "query", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Optional topic filter, e.g. fed | world cup | bitcoin" }, { "name": "scan", "in": "query", "required": false, "schema": { "type": "integer" }, "description": "Top Polymarket contracts to match (default 8, max 12)" } ], "responses": { "200": { "description": "Result" }, "402": { "description": "Payment required" } }, "x-price-usd": 0.05, "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.050000" }, "protocols": [ { "x402": {} } ] } } }, "/api/compute-arb": { "get": { "summary": "GPU compute price arbitrage (marketplace vs hyperscaler)", "description": "Live $/GPU-hour for one GPU class across vast.ai marketplace floor, RunPod community/secure cloud, and AWS on-demand anchor, plus spread multiple and 24/7 monthly savings. Spreads of 3-10x are routine.", "operationId": "api_compute_arb", "parameters": [ { "name": "gpu", "in": "query", "required": false, "schema": { "type": "string" }, "description": "H100 (default) | H200 | B200 | A100 | L40S | RTX4090 | RTX5090" } ], "responses": { "200": { "description": "Result" }, "402": { "description": "Payment required" } }, "x-price-usd": 0.05, "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.050000" }, "protocols": [ { "x402": {} } ] } } }, "/api/fx-premium": { "get": { "summary": "Stablecoin parallel-rate premium (capital-control FX signal)", "description": "How far the street price of a digital dollar (per-venue USDT quotes) diverges from the official FX rate: venue table, median street rate, premium %, signal read. ARS includes the full official/blue/MEP/CCL board.", "operationId": "api_fx_premium", "parameters": [ { "name": "fiat", "in": "query", "required": false, "schema": { "type": "string" }, "description": "ARS (default) | VES | BRL | COP | PEN | MXN | CLP | BOB" } ], "responses": { "200": { "description": "Result" }, "402": { "description": "Payment required" } }, "x-price-usd": 0.02, "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.020000" }, "protocols": [ { "x402": {} } ] } } }, "/api/flip-check": { "get": { "summary": "Retail resale arbitrage check (comps + fees + verdict)", "description": "Given an item and your buy price: web-grounded comparable prices (every comp cited to source URL), deterministic fee math for eBay/Amazon/StockX/Poshmark/Mercari, net profit and ROI at low/median/high comps, best-venue table, FLIP/THIN/PASS verdict. Citation-gated — returns INSUFFICIENT_EVIDENCE rather than an invented price.", "operationId": "api_flip_check", "parameters": [ { "name": "item", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Product, specific (brand + model number)" }, { "name": "buy_price", "in": "query", "required": true, "schema": { "type": "number" }, "description": "Acquisition cost in USD" }, { "name": "marketplace", "in": "query", "required": false, "schema": { "type": "string" }, "description": "ebay (default) | amazon | stockx | poshmark | mercari" }, { "name": "ship_cost", "in": "query", "required": false, "schema": { "type": "number" }, "description": "Outbound shipping estimate in USD (default 8)" } ], "responses": { "200": { "description": "Result" }, "402": { "description": "Payment required" } }, "x-price-usd": 0.5 } }, "/api/inference-arb": { "get": { "summary": "AI inference price arbitrage (same model, every provider)", "description": "Every provider serving a given model with live input/output $/Mtoken, blended 3:1 cost, cheapest-vs-dearest spread multiple, and quantization caveats. Same open-weights model routinely spans 2-5x across providers.", "operationId": "api_inference_arb", "parameters": [ { "name": "model", "in": "query", "required": false, "schema": { "type": "string" }, "description": "OpenRouter slug or fuzzy name (default meta-llama/llama-3.3-70b-instruct)" } ], "responses": { "200": { "description": "Result" }, "402": { "description": "Payment required" } }, "x-price-usd": 0.05, "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.050000" }, "protocols": [ { "x402": {} } ] } } } } }