{"uid":"cap_Ldu6IVWS0T0d-1JjaeRhy","slug":"polymarket-liquidity-shift-alerts-api-edge402-0cb89061","name":"Polymarket Liquidity-Shift Alerts API (edge402)","description":"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.","url":"https://x402.edge402.xyz/edge/liquidity-shifts","method":"GET","headers":{},"bodySchema":{"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"}}}}},"responseSchema":{"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}},"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"max_alerts":"10","z_threshold":"2.0","min_liquidity":"10000"}}},"response":{"as_of":"2026-06-19T06:01:07Z","count":10,"alerts":[{"url":"https://polymarket.com/event/who-will-announce-presidential-run-before-2027","slug":"will-jon-stewart-announce-a-presidential-run-before-2027","spread":0.007,"best_ask":0.045,"best_bid":0.038,"category":"volume_spike_up","question":"Will Jon Stewart announce a Presidential run before 2027?","severity":135.697,"market_id":"692282","clob_token_ids":["40001554280514639575248113942404775300178150008617376574462404952462535321139","78871879226029536711385867624064517137924644648619833029530210199379799159903"],"samples_in_window":168,"spread_change_bps":-32.6,"liquidity_z_score_1h":2.148,"current_liquidity_usd":12236.1847,"volume_24h_change_pct":13569.74,"current_volume_24h_usd":382.06},{"url":"https://polymarket.com/event/sc-07-house-election-winner","slug":"will-the-democratic-party-win-the-sc-07-house-seat","spread":0.02,"best_ask":0.09,"best_bid":0.07,"category":"volume_spike_up","question":"Will the Democratic Party win the SC-07 House seat?","severity":128.741,"market_id":"1284720","clob_token_ids":["66533200574784349380509162104467040229187348123731676518825142374740016683195","21974045169480397897994461463989334445317167933936197745708215237803104432906"],"samples_in_window":168,"spread_change_bps":-2,"liquidity_z_score_1h":1.81,"current_liquidity_usd":14008.9404,"volume_24h_change_pct":12874.14,"current_volume_24h_usd":150},{"url":"https://polymarket.com/event/mn-05-house-election-winner","slug":"will-the-democratic-party-win-the-mn-05-house-seat","spread":0.01,"best_ask":0.94,"best_bid":0.93,"category":"volume_spike_up","question":"Will the Democratic Party win the MN-05 House seat?","severity":74.928,"market_id":"1283873","clob_token_ids":["20781040640207419108275494852260640607740976077797936236220411009198028862221","23961860519982475034051880266064562162897218555151540222239835200934168383354"],"samples_in_window":168,"spread_change_bps":0.5,"liquidity_z_score_1h":1.297,"current_liquidity_usd":15419.9127,"volume_24h_change_pct":7492.83,"current_volume_24h_usd":26},{"url":"https://polymarket.com/event/arizona-governor-winner-2026","slug":"will-the-republican-win-the-arizona-governor-race-in-2026","spread":0.02,"best_ask":0.25,"best_bid":0.23,"category":"volume_spike_up","question":"Will the Republicans win the Arizona governor race in 2026?","severity":54.031,"market_id":"629184","clob_token_ids":["18859933834391393264997730047904836599784455493762567366530805521273388590339","88124433300559247959309048268928728970816174095213461359357515260826164605193"],"samples_in_window":168,"spread_change_bps":-53.9,"liquidity_z_score_1h":0.619,"current_liquidity_usd":11390.9819,"volume_24h_change_pct":5403.11,"current_volume_24h_usd":433.070186},{"url":"https://polymarket.com/event/who-will-announce-presidential-run-before-2027","slug":"will-chelsea-clinton-announce-a-presidential-run-before-2027","spread":0.002,"best_ask":0.014,"best_bid":0.012,"category":"volume_spike_up","question":"Will Chelsea Clinton announce a Presidential run before 2027?","severity":44.506,"market_id":"692291","clob_token_ids":["28147986407510792113365391193428968075302360378201971341665736876627210040909","55399302404177174090572731897104437483011711635563297285356988498081042797253"],"samples_in_window":168,"spread_change_bps":-2.3,"liquidity_z_score_1h":3.515,"current_liquidity_usd":14597.03521,"volume_24h_change_pct":4450.61,"current_volume_24h_usd":142.848571},{"url":"https://polymarket.com/event/richest-person-on-december-31-2026","slug":"will-warren-buffett-be-richest-person-on-december-31-579","spread":0.002,"best_ask":0.014,"best_bid":0.012,"category":"volume_spike_up","question":"Will Warren Buffett be richest person on December 31?","severity":40.328,"market_id":"676943","clob_token_ids":["115055397260683461892027718934804755177371613204852263881954807501570063206911","104749853918751139046297459169776190810156202328924175275885144881960433094058"],"samples_in_window":168,"spread_change_bps":-0.5,"liquidity_z_score_1h":0.513,"current_liquidity_usd":11479.00903,"volume_24h_change_pct":4032.76,"current_volume_24h_usd":142.848571},{"url":"https://polymarket.com/event/2026-mens-wimbledon-winner","slug":"will-sebastian-korda-be-the-2026-mens-wimbledon-winner","spread":0.001,"best_ask":0.001,"best_bid":0,"category":"volume_spike_up","question":"Will Sebastian Korda be the 2026 Men’s Wimbledon winner?","severity":35.807,"market_id":"1087908","clob_token_ids":["46475648948269103513191948998916264992816066457627260304347234221570036651720","692397941123748296546343124337676721076750529977381654707815474689353904911"],"samples_in_window":168,"spread_change_bps":0,"liquidity_z_score_1h":0.814,"current_liquidity_usd":43064.70485,"volume_24h_change_pct":3580.68,"current_volume_24h_usd":22922.550000000003},{"url":"https://polymarket.com/event/anthony-albanese-out-as-prime-minister-of-australia-by","slug":"anthony-albanese-out-as-prime-minister-of-australia-by-june-30-2026","spread":0.025,"best_ask":0.048,"best_bid":0.023,"category":"volume_spike_up","question":"Anthony Albanese out as Prime Minister of Australia by June 30, 2026?","severity":35.785,"market_id":"1219942","clob_token_ids":["107367552319182667076918123529835512301963822028781657102322664093024927372582","100521556570482127641735660129325049026705022430879161899012394629392158410668"],"samples_in_window":168,"spread_change_bps":-11.8,"liquidity_z_score_1h":8.422,"current_liquidity_usd":12844.0323,"volume_24h_change_pct":3578.5,"current_volume_24h_usd":10.24},{"url":"https://polymarket.com/event/who-will-announce-presidential-run-before-2027","slug":"will-lebron-james-announce-a-presidential-run-before-2027","spread":0.003,"best_ask":0.016,"best_bid":0.013,"category":"volume_spike_up","question":"Will LeBron James announce a Presidential run before 2027?","severity":35.1,"market_id":"692288","clob_token_ids":["3583984307549135608982800881180654331530073284398689309975040632637049515529","107634195765329584715848093062412776982677725890533967903606925674962268280924"],"samples_in_window":168,"spread_change_bps":-51.2,"liquidity_z_score_1h":2.696,"current_liquidity_usd":14714.97536,"volume_24h_change_pct":3509.99,"current_volume_24h_usd":111.105554},{"url":"https://polymarket.com/event/pa-04-house-election-winner","slug":"will-the-democratic-party-win-the-pa-04-house-seat","spread":0.01,"best_ask":0.95,"best_bid":0.94,"category":"volume_spike_up","question":"Will the Democratic Party win the PA-04 House seat?","severity":33.534,"market_id":"1284576","clob_token_ids":["45016212564278950396482368180977199049829776570377366771879459820318001214835","59906651547894742089517549044347575375710797987634788303168204873105775827604"],"samples_in_window":168,"spread_change_bps":-0.3,"liquidity_z_score_1h":6.085,"current_liquidity_usd":27904.1465,"volume_24h_change_pct":3353.44,"current_volume_24h_usd":1495.1}],"window":"1h","z_threshold":2,"min_liquidity":10000}},"exampleRequest":{"max_alerts":"10","z_threshold":"2.0","min_liquidity":"10000"},"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"down","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_145OvNzCYBdn49qpjlb77","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"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.","exampleAgentPrompt":"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.","exampleUseCases":null,"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T21:28:15.192Z","isFirstParty":false}