Werracle Radar API — Documentation

Base URL: https://api.werracle.com/v1/radar Dashboard: radar.werracle.com Status: /status Legal: Terms · Privacy · SLA

The Werracle Radar API provides:

• liquidation and oracle-extractable-value (OEV) analytics for Morpho Blue and Aave v3 on Base, derived from public on-chain data;
• stress tests of MetaMorpho vaults computed from live borrow positions.

The research behind the OEV figures is published openly, with all values re-derived on-chain:

• Zenodo 10.5281/zenodo.23642090
• Hugging Face dataset

1. Authentication

Paid endpoints require an API key. Send it in a header:

X-API-Key: wrk_pro_live_...
# or
Authorization: Bearer wrk_pro_live_...

Keys are stored only as SHA-256 hashes. A lost key cannot be recovered; contact us to have a new one issued.

Design-partner access for MetaMorpho curators is available on request: [email protected].

2. Endpoints

Examples

Free overview:

curl -s https://api.werracle.com/v1/radar/overview | jq '.realtime_surveillance.base_l2'

Pro (solvers):

curl -s -H "X-API-Key: $WERRACLE_KEY" "https://api.werracle.com/v1/radar/solvers?limit=10"

Institutional (vault stress test, by address or alias):

curl -s -H "X-API-Key: $WERRACLE_KEY" https://api.werracle.com/v1/radar/curator/0xbeeF010f9cb27031ad51e3333f9aF9C6B1228183
curl -s -H "X-API-Key: $WERRACLE_KEY" https://api.werracle.com/v1/radar/curator/steakhouse

Errors

3. Subscribing with USDC on Base

Self-serve payment is available only when /auth/plans shows "self_serve_payments_enabled": true. Otherwise, write to [email protected] for an invoice.

1. Pay. Send the plan amount in native USDC on Base (0x8335…2913) to the address shown by /auth/plans, from a wallet you control.
2. Request the message. Call claim-key. The response contains the exact message to sign:

   curl -s -X POST https://api.werracle.com/v1/radar/auth/claim-key \
     -H 'content-type: application/json' \
     -d '{"tx_hash":"0x…","tier":"pro","email":"[email protected]"}'
   # → {"error":"signature required","sign_this_message":"Werracle Radar API key claim\ntx: 0x…\ntier: pro\nemail: [email protected]", …}

3. Sign. Sign the message with the same wallet that sent the USDC (EIP-191 personal_sign). Smart-contract wallets are supported through EIP-1271. Then send the request again with the signature:

   // ethers v6
   const sig = await signer.signMessage(msg);   // msg = sign_this_message exactly

   # Foundry
   cast wallet sign --private-key $PK "$MSG"

   curl -s -X POST …/auth/claim-key -H 'content-type: application/json' \
     -d '{"tx_hash":"0x…","tier":"pro","email":"[email protected]","signature":"0x…"}'

4. Store the key. The response contains your key. It is shown once and is valid for 30 days.

Rules:

• A payment can be claimed once.
• A payment must be claimed within 7 days.
• Only transfers from a single paying address count.

4. Vault stress test model

/curator/{vault} evaluates every borrow position in the markets the vault supplies to. Data comes from the Morpho public API and is cached for 5 minutes. For each scenario (current price, −5, −10, −15, −20 and −30% collateral price, with the loan asset held fixed):

Not modelled:

• price paths and liquidation cascades;
• DEX liquidity for liquidators;
• pre-liquidation contracts;
• correlated loan assets (for example wstETH/WETH);
• oracle-specific deviations.

For the largest markets, the 10,000 largest positions are evaluated. The response reports the share of market debt they cover (debt_coverage_of_evaluated_positions).

Back-test: 12–18 October 2026 sell-off

We re-ran the model against what actually happened on-chain between 12 and 19 October 2026 (Base, Morpho Blue). The test covers the 10 markets with SVR liquidations in our research sample: cbXRP, WETH, SOL, cbLTC, cbADA, JitoSOL, cbDOGE, cbZEC and cbHYPE against USDC, plus cbBTC/USDC.

Method:

• Positions. Every borrow position is read on-chain at the start of each window, using Morpho.position at a historical block.
• Shock. The model is applied with the oracle's realised maximum drawdown inside the window. The price path is sampled every 15 minutes and at every block that contains a liquidation.
• Comparison. The flagged positions are compared with all Morpho Liquidate events in the window.

This tests whether the model finds the right positions and debt for a given price move. It does not test price forecasting.

What the numbers mean:

• Recall is the share of the debt that was actually liquidated which the model had flagged in advance.
• Precision is the share of flagged debt that was then liquidated.
• Why precision is lower. The rest of the flagged debt was saved because borrowers added collateral or repaid in time. That is the window an early-warning product is meant to use.
• Why a daily refresh matters. With a single 7-day snapshot, 16 of the missed positions had increased their leverage after the snapshot. Refreshing daily removes that gap.

Totals for the week:

Data and code: backtest_oct12_18.py · result JSON.

5. Data freshness

/overview reports:

Treat null values as "not available". The API never substitutes placeholder numbers.

6. Changelog

• 2026-10-25 — v2.1
  • Payment claims bound to the paying wallet by signature.
  • Real vault stress test from live positions, plus the curator/vaults endpoint.
  • Freshness fields added; placeholder values removed.
  • Research figures updated to dataset v1.2 (Zenodo v2).

7. Contact

Werracle Radar is operated by ITouch Systems, Çukurova Teknokent, Adana, Türkiye. Outputs are estimates provided as information only, not financial advice.