# Farm Distress Mesh

> Sole-source cross-chain liquidation-distress index + non-custodial execution for AI agents. Aave / Morpho / Compound-III / Moonwell across Base, Ethereum and HyperEVM. Pay-per-call in USDC on Base via the x402 protocol — no account, no API key.

## Guarantee
Fresh-or-free: every paid call returns data re-confirmed within 15 minutes, or a non-2xx with NO charge (503 = transient outage, retry; 404 = an honest empty answer, don't hot-retry). You are never billed for stale, empty, or failed responses. Each paid DATA response carries a `freshness` block you can verify; execution (POST /execute) returns an on-chain `txHash` as its proof.

## Paid endpoints (x402 exact, USDC on Base)
- GET https://trade-production-180b.up.railway.app/mesh — $0.04 — 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. [tags: liquidations, bad-debt, lending-risk, cross-chain, defi-risk]
- GET https://trade-production-180b.up.railway.app/distress — $0.01 — 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. [tags: liquidations, distress, health-factor, lending-risk, cross-chain]
- GET https://trade-production-180b.up.railway.app/delta — $0.01 — 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. [tags: liquidations, distress, diff, streaming, lending-risk]
- GET https://trade-production-180b.up.railway.app/hot — $0.01 — 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. [tags: liquidations, hot, morpho, health-factor, mev]
- GET https://trade-production-180b.up.railway.app/mispricing — $0.02 — Positions liquidatable RIGHT NOW (health factor ≤ 1) across the fleet's chains/venues — the actionable subset of the distress index. [tags: liquidations, liquidatable, mev, lending-risk, defi-risk]
- GET https://trade-production-180b.up.railway.app/venues — $0.01 — Cross-fork lending-venue stress: per venue/chain, positions at risk, total debt at risk, count liquidatable now, tightest health factor. [tags: lending, venue-health, defi-risk, protocol-risk, cross-chain]
- GET https://trade-production-180b.up.railway.app/whales — $0.01 — The biggest at-risk borrow positions across every chain/venue the fleet watches, ranked by debt size. Query: ?minUsd, ?limit, ?chain. [tags: whales, liquidations, large-positions, lending-risk, defi-risk]
- GET https://trade-production-180b.up.railway.app/targets — $0.02 — 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). [tags: liquidations, liquidation-targets, execution, mev, defi-risk]
- GET https://trade-production-180b.up.railway.app/gas — $0.005 — Cross-chain gas intelligence: current gas price (wei + gwei) and the USD cost of a typical liquidation tx, per chain (Base, Ethereum, Arbitrum, Optimism). [tags: gas, gas-price, cross-chain, tx-cost, mev]
- GET https://trade-production-180b.up.railway.app/liquidations — $0.02 — 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. [tags: liquidations, liquidation-feed, mev, leaderboard, defi-data]
- GET https://trade-production-180b.up.railway.app/competition — $0.02 — 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. [tags: liquidations, competition, mev, market-structure, defi-data]
- GET https://trade-production-180b.up.railway.app/baddebt — $0.02 — 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. [tags: bad-debt, insolvency, systemic-risk, defi-risk, lending]
- POST https://trade-production-180b.up.railway.app/execute/quote — $0.05 — 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}. [tags: execution, liquidations, profitability, quote, defi]
- POST https://trade-production-180b.up.railway.app/execute — $0.25 — 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}. [tags: execution, liquidations, non-custodial, flash-loan, mev]

## Free
- GET https://trade-production-180b.up.railway.app/summary — counts + tightest health factor (teaser, no addresses)
- GET https://trade-production-180b.up.railway.app/treasury — live earnings + honest external-demand stats
- GET https://trade-production-180b.up.railway.app/health , https://trade-production-180b.up.railway.app/radar , https://trade-production-180b.up.railway.app/.well-known/x402 , https://trade-production-180b.up.railway.app/openapi.json

## How to pay
Standard x402: request a paid route → receive HTTP 402 with `accepts` (scheme `exact`, network `base`, USDC amount, `payTo`). Sign a USDC authorization, retry with the `PAYMENT-SIGNATURE` (or `X-PAYMENT`) header; the facilitator settles to `payTo` and the JSON is served. Any x402-capable client works.