{"openapi":"3.1.0","info":{"title":"Farm Distress Mesh","version":"2.0.0","description":"On-chain lending liquidation distress for AI agents. Pay per call via x402 USDC on Base. Fresh-or-free: every paid call returns data re-confirmed within 15 min, or a non-2xx with no charge (503 = transient outage, retry; 404 = an honest empty answer). Never billed for stale, empty, or failed responses."},"servers":[{"url":"https://trade-production-180b.up.railway.app"}],"paths":{"/mesh":{"get":{"summary":"ONE-CALL cross-chain risk snapshot: distress top + venue stress + gas + bad-debt in a single response, priced below the ","description":"ONE-CALL cross-chain risk snapshot: distress top + venue stress + gas + bad-debt in a single response, priced below the sum of the parts. Sole-source multi-venue view; non-custodial. Query: ?chain, ?top.","operationId":"get_mesh","tags":["liquidations","bad-debt","lending-risk","cross-chain","defi-risk"],"x-x402":{"price":"$0.04","network":"eip155:8453","payTo":"0x20D71310309b6A4982472F4A5EeE131069A493A7","scheme":"exact"},"responses":{"200":{"description":"Paid JSON payload"},"402":{"description":"Payment Required — x402"}}}},"/distress":{"get":{"summary":"Ranked cross-chain liquidation-distress index — every near-liquidation position the fleet watches (Aave/Morpho/Comet/Moo","description":"Ranked cross-chain liquidation-distress index — every near-liquidation position the fleet watches (Aave/Morpho/Comet/Moonwell across Base, Ethereum, HyperEVM), scored by proximity×size. Query: ?chain, ?minScore, ?limit.","operationId":"get_distress","tags":["liquidations","distress","health-factor","lending-risk","cross-chain"],"x-x402":{"price":"$0.01","network":"eip155:8453","payTo":"0x20D71310309b6A4982472F4A5EeE131069A493A7","scheme":"exact"},"responses":{"200":{"description":"Paid JSON payload"},"402":{"description":"Payment Required — x402"}}}},"/delta":{"get":{"summary":"Changed-only distress diff — pass ?since=<cursor> to get just what moved since your last poll: added, worsened/now-liqui","description":"Changed-only distress diff — pass ?since=<cursor> to get just what moved since your last poll: added, worsened/now-liquidatable, resolved (gone). You're charged ONLY when something actually changed (a no-change poll returns 404, free); each call returns a fresh `cursor`. Cheap polling instead of re-buying the whole index.","operationId":"get_delta","tags":["liquidations","distress","diff","streaming","lending-risk"],"x-x402":{"price":"$0.01","network":"eip155:8453","payTo":"0x20D71310309b6A4982472F4A5EeE131069A493A7","scheme":"exact"},"responses":{"200":{"description":"Paid JSON payload"},"402":{"description":"Payment Required — x402"}}}},"/hot":{"get":{"summary":"Fleet HOT band (HF 1.00–1.08) Morpho-first — the same names the race bots recheck every ~200ms on Base flashblocks. Quer","description":"Fleet HOT band (HF 1.00–1.08) Morpho-first — the same names the race bots recheck every ~200ms on Base flashblocks. Query: ?chain, ?hfMax, ?limit.","operationId":"get_hot","tags":["liquidations","hot","morpho","health-factor","mev"],"x-x402":{"price":"$0.01","network":"eip155:8453","payTo":"0x20D71310309b6A4982472F4A5EeE131069A493A7","scheme":"exact"},"responses":{"200":{"description":"Paid JSON payload"},"402":{"description":"Payment Required — x402"}}}},"/mispricing":{"get":{"summary":"Positions liquidatable RIGHT NOW (health factor ≤ 1) across the fleet's chains/venues — the actionable subset of the dis","description":"Positions liquidatable RIGHT NOW (health factor ≤ 1) across the fleet's chains/venues — the actionable subset of the distress index.","operationId":"get_mispricing","tags":["liquidations","liquidatable","mev","lending-risk","defi-risk"],"x-x402":{"price":"$0.02","network":"eip155:8453","payTo":"0x20D71310309b6A4982472F4A5EeE131069A493A7","scheme":"exact"},"responses":{"200":{"description":"Paid JSON payload"},"402":{"description":"Payment Required — x402"}}}},"/venues":{"get":{"summary":"Cross-fork lending-venue stress: per venue/chain, positions at risk, total debt at risk, count liquidatable now, tightes","description":"Cross-fork lending-venue stress: per venue/chain, positions at risk, total debt at risk, count liquidatable now, tightest health factor.","operationId":"get_venues","tags":["lending","venue-health","defi-risk","protocol-risk","cross-chain"],"x-x402":{"price":"$0.01","network":"eip155:8453","payTo":"0x20D71310309b6A4982472F4A5EeE131069A493A7","scheme":"exact"},"responses":{"200":{"description":"Paid JSON payload"},"402":{"description":"Payment Required — x402"}}}},"/whales":{"get":{"summary":"The biggest at-risk borrow positions across every chain/venue the fleet watches, ranked by debt size. Query: ?minUsd, ?l","description":"The biggest at-risk borrow positions across every chain/venue the fleet watches, ranked by debt size. Query: ?minUsd, ?limit, ?chain.","operationId":"get_whales","tags":["whales","liquidations","large-positions","lending-risk","defi-risk"],"x-x402":{"price":"$0.01","network":"eip155:8453","payTo":"0x20D71310309b6A4982472F4A5EeE131069A493A7","scheme":"exact"},"responses":{"200":{"description":"Paid JSON payload"},"402":{"description":"Payment Required — x402"}}}},"/targets":{"get":{"summary":"Liquidation targets ranked by GROSS seize-bonus $ (debt × close-factor × venue bonus, public params) — the top of the ex","description":"Liquidation targets ranked by GROSS seize-bonus $ (debt × close-factor × venue bonus, public params) — the top of the execution funnel. Query: ?minBonusUsd, ?limit, ?chain. Feeds POST /execute/quote (net go/no-go) and POST /execute (non-custodial land).","operationId":"get_targets","tags":["liquidations","liquidation-targets","execution","mev","defi-risk"],"x-x402":{"price":"$0.02","network":"eip155:8453","payTo":"0x20D71310309b6A4982472F4A5EeE131069A493A7","scheme":"exact"},"responses":{"200":{"description":"Paid JSON payload"},"402":{"description":"Payment Required — x402"}}}},"/gas":{"get":{"summary":"Cross-chain gas intelligence: current gas price (wei + gwei) and the USD cost of a typical liquidation tx, per chain (Ba","description":"Cross-chain gas intelligence: current gas price (wei + gwei) and the USD cost of a typical liquidation tx, per chain (Base, Ethereum, Arbitrum, Optimism).","operationId":"get_gas","tags":["gas","gas-price","cross-chain","tx-cost","mev"],"x-x402":{"price":"$0.005","network":"eip155:8453","payTo":"0x20D71310309b6A4982472F4A5EeE131069A493A7","scheme":"exact"},"responses":{"200":{"description":"Paid JSON payload"},"402":{"description":"Payment Required — x402"}}}},"/liquidations":{"get":{"summary":"Recent ON-CHAIN liquidations across Base venues (Moonwell + Aave v3 + Morpho Blue) — the actual events (liquidator, borr","description":"Recent ON-CHAIN liquidations across Base venues (Moonwell + Aave v3 + Morpho Blue) — the actual events (liquidator, borrower, repay, seize, per venue) plus a cross-venue liquidator leaderboard (who's winning) and per-venue counts. Query: ?limit.","operationId":"get_liquidations","tags":["liquidations","liquidation-feed","mev","leaderboard","defi-data"],"x-x402":{"price":"$0.02","network":"eip155:8453","payTo":"0x20D71310309b6A4982472F4A5EeE131069A493A7","scheme":"exact"},"responses":{"200":{"description":"Paid JSON payload"},"402":{"description":"Payment Required — x402"}}}},"/competition":{"get":{"summary":"Liquidator competition analytics across Base venues: concentration (HHI 0-10000), top-liquidator share, and a per-venue ","description":"Liquidator competition analytics across Base venues: concentration (HHI 0-10000), top-liquidator share, and a per-venue verdict (open / contested / dominated) — tells a searcher WHERE it's crowded vs where there's room to win. Derived from the fleet's live cross-venue liquidation observation.","operationId":"get_competition","tags":["liquidations","competition","mev","market-structure","defi-data"],"x-x402":{"price":"$0.02","network":"eip155:8453","payTo":"0x20D71310309b6A4982472F4A5EeE131069A493A7","scheme":"exact"},"responses":{"200":{"description":"Paid JSON payload"},"402":{"description":"Payment Required — x402"}}}},"/baddebt":{"get":{"summary":"Insolvency / bad-debt early-warning: positions liquidatable but NOT being liquidated (unsellable collateral or underwate","description":"Insolvency / bad-debt early-warning: positions liquidatable but NOT being liquidated (unsellable collateral or underwater past the bonus), rotting into protocol bad debt. Query: ?chain, ?minUsd.","operationId":"get_baddebt","tags":["bad-debt","insolvency","systemic-risk","defi-risk","lending"],"x-x402":{"price":"$0.02","network":"eip155:8453","payTo":"0x20D71310309b6A4982472F4A5EeE131069A493A7","scheme":"exact"},"responses":{"200":{"description":"Paid JSON payload"},"402":{"description":"Payment Required — x402"}}}},"/execute/quote":{"post":{"summary":"Non-custodial execution economics for a liquidation target: liquidatable?, repayable under close factor, seize bonus, es","description":"Non-custodial execution economics for a liquidation target: liquidatable?, repayable under close factor, seize bonus, est net after gas, go/no-go. Body: {chain,venue,borrower}.","operationId":"post_execute_quote","tags":["execution","liquidations","profitability","quote","defi"],"x-x402":{"price":"$0.05","network":"eip155:8453","payTo":"0x20D71310309b6A4982472F4A5EeE131069A493A7","scheme":"exact"},"responses":{"200":{"description":"Paid JSON payload"},"402":{"description":"Payment Required — x402"}}}},"/execute":{"post":{"summary":"Land a liquidation for you, non-custodially: the fleet's atomic executor flash-funds, liquidates, sells, and pays procee","description":"Land a liquidation for you, non-custodially: the fleet's atomic executor flash-funds, liquidates, sells, and pays proceeds (minus a fee) to YOUR address, or reverts. Body: {borrower, beneficiary, venue}.","operationId":"post_execute","tags":["execution","liquidations","non-custodial","flash-loan","mev"],"x-x402":{"price":"$0.25","network":"eip155:8453","payTo":"0x20D71310309b6A4982472F4A5EeE131069A493A7","scheme":"exact"},"responses":{"200":{"description":"Paid JSON payload"},"402":{"description":"Payment Required — x402"}}}},"/summary":{"get":{"summary":"Free /summary","responses":{"200":{"description":"JSON"}}}},"/treasury":{"get":{"summary":"Free /treasury","responses":{"200":{"description":"JSON"}}}},"/radar":{"get":{"summary":"Free /radar","responses":{"200":{"description":"JSON"}}}},"/health":{"get":{"summary":"Free /health","responses":{"200":{"description":"JSON"}}}},"/.well-known/x402":{"get":{"summary":"Free /.well-known/x402","responses":{"200":{"description":"JSON"}}}},"/llms.txt":{"get":{"summary":"Free /llms.txt","responses":{"200":{"description":"JSON"}}}}}}