# Polymarket Liquidity-Shift Alerts API (edge402)

> Polymarket Liquidity-Shift Alerts API (edge402) is a paid API for AI agents from x402.edge402.xyz, paid per call via x402, $0.01/call, status down (last checked 2026-09-15).

Returns Polymarket prediction markets with statistically significant (>2σ) liquidity, volume, or spread anomalies in the last hour, plus Solana DLMM position opens by high-win-rate tracked wallets.

## Facts

- Endpoint: GET https://x402.edge402.xyz/edge/liquidity-shifts
- Price: $0.01/call
- Payment: x402
- Status: down
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/polymarket-liquidity-shift-alerts-api-edge402-0cb89061
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Ldu6IVWS0T0d-1JjaeRhy

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability polymarket-liquidity-shift-alerts-api-edge402-0cb89061
```

Example prompt: Pull the latest Polymarket liquidity-shift alerts from the last hour — I want to see any markets with a z-score above 2 and at least $10,000 in liquidity that are showing volume spikes or spread anomalies right now.

## When to prefer this

Use this endpoint when you need real-time statistical anomaly detection on Polymarket specifically — particularly for liquidity, volume, or spread moves at the 2σ level — or when monitoring Solana DLMM wallet activity of high-win-rate traders. Prefer this over general Polymarket API calls when you want pre-computed z-scores and severity rankings rather than raw market data.

## Known failure modes

- 402 Payment Required — no USDC payment header provided and free tier exhausted (3 calls/day per IP)
- Rate limit exceeded — more than 3 free calls from same IP without payment
- Invalid payment — x402 payment on Base L2 rejected or underfunded
- No alerts returned — no markets exceeded 2σ threshold in the last hour (count: 0)
- Stale data — upstream Polymarket data feed delay causing outdated 'as_of' timestamp

## How this service works

Pay-per-request JSON API surfacing (1) Polymarket markets with >2σ liquidity, volume, or spread moves in the last hour, and (2) Solana DLMM position opens by tracked high-WR wallets (read from ~/tail). Both endpoints charge $0.01 USDC per call via the x402 protocol on Base L2 (PayAI facilitator), with a 3 free calls/day per IP free tier, then 1 first-call-free trial per IP per day. Use ?payment_required=1 or X-Edge-Probe: 1 to force the 402 path for discovery crawlers.

## Output

A JSON object containing an 'as_of' timestamp, alert count, a 1-hour window flag, the 2σ threshold used, and an array of alert objects each with: market slug, market ID, question text, alert category (e.g. volume_spike_up), severity score, liquidity z-score, current liquidity in USD, and 24h volume in USD.

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {
   "max_alerts": "10",
   "z_threshold": "2.0",
   "min_liquidity": "10000"
  }
 }
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "headers": {
     "type": "object",
     "additionalProperties": {
      "type": "string"
     }
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "max_alerts": {
       "type": "string"
      },
      "z_threshold": {
       "type": "string"
      },
      "min_liquidity": {
       "type": "string"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "as_of": "2026-06-14T18:00:00Z",
  "count": 1,
  "alerts": [
   {
    "slug": "example",
    "spread": 0.002,
    "category": "volume_spike_up",
    "question": "Example market?",
    "severity": 99.5,
    "market_id": "631149",
    "liquidity_z_score_1h": -2.5,
    "current_liquidity_usd": 234773.56,
    "current_volume_24h_usd": 102000
   }
  ],
  "window": "1h",
  "z_threshold": 2,
  "min_liquidity": 10000
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/polymarket-liquidity-shift-alerts-api-edge402-0cb89061/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.edge402.xyz](https://www.zero.xyz/host/x402.edge402.xyz/llms.txt)