{"openapi":"3.1.0","info":{"title":"MEV Intelligence API","version":"0.1.0","description":"Derived MEV intelligence — predicted liquidation waves, searcher leaderboards, builder routing recommendations, and a risk-enriched opportunity feed. All data is derived from internal on-chain pricer and dispatcher state — we do not resell third-party feeds.\n\n**Payment:** Pay-per-call USDC on Base via the x402 protocol. Supported facilitators: Heurist (primary) and Coinbase CDP (for Agentic.market discovery).\n\n**Positioning:** \"We tell you what happens next.\"","contact":{"name":"AdValorem","url":"https://mev.advalorem.io/intelligence"}},"servers":[{"url":"https://mev.advalorem.io"}],"x-x402":{"protocol":"x402","version":1,"network":"eip155:8453","payTo":"0x467032Df0e31198ccAC0EF4457B08C65e74C49Db","facilitators":["https://facilitator.heurist.xyz","https://api.cdp.coinbase.com/platform/v2/x402"],"asset":"USDC"},"paths":{"/intelligence/liquidation-waves":{"get":{"operationId":"liquidation_waves","summary":"Predicted liquidation waves","description":"For each asset showing oracle pressure in the last 30 min, returns the predicted wave of borrowers about to become liquidatable, plus the full HF cliff distribution. \"We tell you what happens next.\"\n\n**Payment:** $0.50 USDC on Base via x402. Send a request without X-PAYMENT to receive a 402 challenge.","parameters":[{"name":"window_min","in":"query","schema":{"type":"integer","default":30},"description":"Lookback window for oracle pressure (minutes)."},{"name":"top_n","in":"query","schema":{"type":"integer","default":10},"description":"Number of waves to return."}],"responses":{"200":{"description":"OK — derived intelligence payload","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"Payment Required — x402 challenge. Sign the X-PAYMENT and retry.","content":{"application/json":{"schema":{"type":"object"}}}},"429":{"description":"Rate limited (preview tier only)."}}}},"/preview/liquidation-waves":{"get":{"operationId":"preview_liquidation_waves","summary":"FREE preview — Predicted liquidation waves","description":"Rate-limited free preview (60 req/hr per IP, ~5 min cached). Returns a truncated payload. Upgrade to /intelligence/liquidation-waves for full data, no rate limit, and lower latency.","responses":{"200":{"description":"Truncated preview payload"},"429":{"description":"Rate limited — retry after the window or use the paid route"}}}},"/intelligence/searcher-leaderboard":{"get":{"operationId":"searcher_leaderboard","summary":"Top liquidator searchers (last 4h)","description":"Ranked searcher wallets by landed fires, attempts, and land-rate. Derived from our own dispatcher audit — the searchers we directly observe competing on the same opportunities.\n\n**Payment:** $0.25 USDC on Base via x402. Send a request without X-PAYMENT to receive a 402 challenge.","parameters":[{"name":"window_min","in":"query","schema":{"type":"integer","default":240},"description":"Lookback window (minutes)."},{"name":"top_n","in":"query","schema":{"type":"integer","default":25},"description":"Number of searchers to return."}],"responses":{"200":{"description":"OK — derived intelligence payload","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"Payment Required — x402 challenge. Sign the X-PAYMENT and retry.","content":{"application/json":{"schema":{"type":"object"}}}},"429":{"description":"Rate limited (preview tier only)."}}}},"/preview/searcher-leaderboard":{"get":{"operationId":"preview_searcher_leaderboard","summary":"FREE preview — Top liquidator searchers (last 4h)","description":"Rate-limited free preview (60 req/hr per IP, ~5 min cached). Returns a truncated payload. Upgrade to /intelligence/searcher-leaderboard for full data, no rate limit, and lower latency.","responses":{"200":{"description":"Truncated preview payload"},"429":{"description":"Rate limited — retry after the window or use the paid route"}}}},"/intelligence/builder-recommendation":{"get":{"operationId":"builder_recommendation","summary":"Best builder route NOW","description":"Which builder to route a bundle through based on our last 60 min of acceptance × volume. Useful for liquidation-shaped bundles and similar searcher profiles.\n\n**Payment:** $0.25 USDC on Base via x402. Send a request without X-PAYMENT to receive a 402 challenge.","parameters":[{"name":"window_min","in":"query","schema":{"type":"integer","default":60},"description":"Lookback window for builder stats (minutes)."}],"responses":{"200":{"description":"OK — derived intelligence payload","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"Payment Required — x402 challenge. Sign the X-PAYMENT and retry.","content":{"application/json":{"schema":{"type":"object"}}}},"429":{"description":"Rate limited (preview tier only)."}}}},"/preview/builder-recommendation":{"get":{"operationId":"preview_builder_recommendation","summary":"FREE preview — Best builder route NOW","description":"Rate-limited free preview (60 req/hr per IP, ~5 min cached). Returns a truncated payload. Upgrade to /intelligence/builder-recommendation for full data, no rate limit, and lower latency.","responses":{"200":{"description":"Truncated preview payload"},"429":{"description":"Rate limited — retry after the window or use the paid route"}}}},"/intelligence/feed":{"get":{"operationId":"feed","summary":"Risk-enriched MEV opportunity feed","description":"Recent priced liquidation opportunities across Aave V3, Spark, Morpho (L1) and Aave V3 (Base), tagged with risk + oracle-pressure context. The Twitter for MEV opportunities.\n\n**Payment:** $0.10 USDC on Base via x402. Send a request without X-PAYMENT to receive a 402 challenge.","parameters":[{"name":"limit","in":"query","schema":{"type":"integer","default":50},"description":"Max items to return."}],"responses":{"200":{"description":"OK — derived intelligence payload","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"Payment Required — x402 challenge. Sign the X-PAYMENT and retry.","content":{"application/json":{"schema":{"type":"object"}}}},"429":{"description":"Rate limited (preview tier only)."}}}},"/preview/feed":{"get":{"operationId":"preview_feed","summary":"FREE preview — Risk-enriched MEV opportunity feed","description":"Rate-limited free preview (60 req/hr per IP, ~5 min cached). Returns a truncated payload. Upgrade to /intelligence/feed for full data, no rate limit, and lower latency.","responses":{"200":{"description":"Truncated preview payload"},"429":{"description":"Rate limited — retry after the window or use the paid route"}}}}}}