{"openapi":"3.1.0","info":{"title":"Seerium x402 Market Intelligence API","version":"1.0.0","description":"Pay-per-call crypto, prediction-market, news, Dex, and market intelligence APIs for autonomous agents.","x-guidance":"Choose the endpoint that matches the market intelligence task. Supply the documented query parameters or JSON request body. Each operation first returns an x402 v2 HTTP 402 challenge; select a supported payment option, sign it, and retry with PAYMENT-SIGNATURE. Successful responses are JSON envelopes containing product metadata, freshness metadata, and the requested data.","contact":{"name":"Seerium","url":"https://api.seerium.xyz"}},"servers":[{"url":"https://api.seerium.xyz"}],"tags":[{"name":"Market Intelligence","description":"Seerium agent-facing paid market data and intelligence endpoints."}],"paths":{"/v1/dex/agent-output":{"get":{"operationId":"dex-agent-output","summary":"Dex Trading Agent Output API","description":"Dex trading agent signal API and crypto market signal feed for agents. Returns the latest Dex trading agent read for supported crypto symbols, including action, confidence, risk, drivers, leverage context, and monitoring notes.","tags":["Market Intelligence"],"security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.1000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"symbol","in":"query","required":true,"description":"Dex asset or pair for the trading-agent read, for example BTC or BTCUSDT.","schema":{"type":"string","minLength":1,"description":"Dex asset or pair for the trading-agent read, for example BTC or BTCUSDT."},"example":"BTC"}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"},"example":{"service":"seerium-x402-api","product":{"id":"dex-agent-output","name":"Dex Trading Agent Output API","method":"GET","path":"/v1/dex/agent-output","price":"$0.1000","accepts":[{"scheme":"exact","network":"eip155:8453","payTo":"0x81832eEDe3a4ad96CB3D7cA09977636D912fd3D5","price":"$0.1000"},{"scheme":"exact","network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","payTo":"2h752kAbb9z1jpdSzqMEYg9JHv6TPJ6T2BfAJMyjLFtZ","price":"$0.1000"}],"networks":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"]},"meta":{"requestId":"req_example_123","generatedAt":"2026-03-25T12:00:00.000Z","updatedAt":"2026-03-25T11:59:30.000Z","freshnessMs":30000},"data":{"action":"hold","confidence":78,"riskLevel":"medium","rationale":"Momentum, volume, and trend alignment remain constructive.","model":"futures-agent-v2","keyDrivers":["24h momentum","positive intraday volume","trend confirmation"],"monitoring":{"alerts":["Lose 15m trend support","Funding spikes against position"],"metricsToWatch":["price_change_pct_15m","volume_quote_15m"]}}}}}},"402":{"description":"Payment Required","headers":{"PAYMENT-REQUIRED":{"description":"Base64url-encoded x402 v2 payment challenge.","schema":{"type":"string"}}}}}}},"/v1/dex/market-brief":{"get":{"operationId":"dex-market-brief","summary":"Dex Market Brief API","description":"Crypto Dex market brief API for agents. Combines market price, volume, funding heat, order book pressure, and Dex trading-agent output for one asset or perp pair.","tags":["Market Intelligence"],"security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.1000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"symbol","in":"query","required":true,"description":"Required Dex asset or pair to brief, for example BTC, BTCUSDT, or BTC-PERP.","schema":{"type":"string","minLength":1,"description":"Required Dex asset or pair to brief, for example BTC, BTCUSDT, or BTC-PERP."},"example":"BTC"},{"name":"levels","in":"query","required":false,"description":"Optional order book levels per side used for pressure. Defaults to 10.","schema":{"type":"number","minimum":1,"maximum":20,"description":"Optional order book levels per side used for pressure. Defaults to 10."},"example":10}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"},"example":{"service":"seerium-x402-api","product":{"id":"dex-market-brief","name":"Dex Market Brief API","method":"GET","path":"/v1/dex/market-brief","price":"$0.1000","accepts":[{"scheme":"exact","network":"eip155:8453","payTo":"0x81832eEDe3a4ad96CB3D7cA09977636D912fd3D5","price":"$0.1000"},{"scheme":"exact","network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","payTo":"2h752kAbb9z1jpdSzqMEYg9JHv6TPJ6T2BfAJMyjLFtZ","price":"$0.1000"}],"networks":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"]},"meta":{"requestId":"req_example_123","generatedAt":"2026-03-25T12:00:00.000Z","updatedAt":"2026-03-25T11:59:30.000Z","freshnessMs":30000},"data":{"timestamp":1760000000000,"venue":"dex","criteria":{"symbol":"BTC","levels":10},"asset":"BTC","symbol":"BTCUSDT","market":{"lastPrice":60763.8,"change24h":0.0157,"high24h":61210.4,"low24h":59880.2,"quoteVolume":3014587850.28,"fundingRate":-0.000537},"fundingHeat":{"rank":1,"symbol":"BTCUSDT","fundingRate":-0.000537,"fundingBps":-5.37,"sideCrowded":"short","severity":"medium","heatScore":35.8,"lastPrice":60763.8,"change24h":0.0157,"quoteVolume":3014587850.28,"high24h":61210.4,"low24h":59880.2,"reason":"negative funding means shorts are paying longs by 5.37 bps."},"orderbookPressure":{"symbol":"BTCUSDT","pressureScore":0.214,"direction":"buy_pressure","confidence":"high","depthImbalance":0.245,"microBiasBps":1.8,"spreadBps":0.7,"bidDepthNotional":420000,"askDepthNotional":255000,"totalDepthNotional":675000,"bestBid":60763.7,"bestAsk":60764.1,"midPrice":60763.9,"microprice":60764.01,"lastPrice":60763.8,"change24h":0.0157,"fundingRate":-0.000537,"levelsUsed":10,"bookTimestamp":"2026-03-25T12:00:00.000Z","reasons":["bid depth is 1.65x the opposite side across the measured book"]},"agent":{"action":"hold","confidence":62,"riskLevel":"medium","model":"futures-agent-v2","rationale":"Mixed funding and book pressure favor waiting for confirmation.","keyDrivers":["funding pressure","order book imbalance","short-term momentum"],"monitoring":{"alerts":["Watch for spread widening","Watch funding reversal"],"metricsToWatch":["fundingRate","pressureScore","change24h"]}},"signals":{"fundingCrowdedSide":"short","fundingHeatScore":35.8,"orderbookDirection":"buy_pressure","pressureScore":0.214,"agentAction":"hold","agentConfidence":62,"riskLevel":"medium"},"monitoring":{"alerts":["Watch for spread widening","Watch funding reversal"],"metricsToWatch":["fundingRate","pressureScore","change24h"]},"freshness":{"dexUpdatedAt":"2026-03-25T12:00:00.000Z","fundingUpdatedAt":"2026-03-25T12:00:00.000Z","orderbookUpdatedAt":"2026-03-25T12:00:00.000Z","agentUpdatedAt":"2026-03-25T11:59:30.000Z"},"warnings":[]}}}}},"402":{"description":"Payment Required","headers":{"PAYMENT-REQUIRED":{"description":"Base64url-encoded x402 v2 payment challenge.","schema":{"type":"string"}}}}}}},"/v1/prediction/scan":{"get":{"operationId":"prediction-scan","summary":"Polymarket Prediction Market API","description":"Polymarket API and prediction market API for agents. Returns prediction market signals, market snapshots, order books, and ranked opportunities.","tags":["Market Intelligence"],"security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.1000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"limitSnapshots","in":"query","required":false,"description":"Optional maximum Polymarket prediction-market snapshots to return.","schema":{"type":"number","minimum":1,"description":"Optional maximum Polymarket prediction-market snapshots to return."},"example":10},{"name":"limitOpportunities","in":"query","required":false,"description":"Optional maximum prediction-market opportunities to return.","schema":{"type":"number","minimum":1,"description":"Optional maximum prediction-market opportunities to return."},"example":10}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"},"example":{"service":"seerium-x402-api","product":{"id":"prediction-scan","name":"Polymarket Prediction Market API","method":"GET","path":"/v1/prediction/scan","price":"$0.1000","accepts":[{"scheme":"exact","network":"eip155:8453","payTo":"0x81832eEDe3a4ad96CB3D7cA09977636D912fd3D5","price":"$0.1000"},{"scheme":"exact","network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","payTo":"2h752kAbb9z1jpdSzqMEYg9JHv6TPJ6T2BfAJMyjLFtZ","price":"$0.1000"}],"networks":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"]},"meta":{"requestId":"req_example_123","generatedAt":"2026-03-25T12:00:00.000Z","updatedAt":"2026-03-25T11:59:30.000Z","freshnessMs":30000},"data":{"timestamp":1760000000000,"scope":"prediction","allowShort":false,"markets":745,"opportunities":1,"snapshots":[{"market":{"source":"polymarket","conditionId":"1919425","question":"US x Iran permanent peace deal by May 31, 2026?","marketSlug":"us-x-iran-permanent-peace-deal-by-may-31-2026","eventTitle":"US x Iran permanent peace deal by...?","eventSlug":"us-x-iran-permanent-peace-deal-by","endDateIso":"2026-05-31T00:00:00.000Z","volume24h":5768589.43,"volume":70112309.42,"liquidity":1201662.28,"acceptingOrders":true,"active":true,"closed":false,"archived":false,"tokens":[{"tokenId":"poly_yes_token","outcome":"Yes","price":0.48},{"tokenId":"poly_no_token","outcome":"No","price":0.52}]},"tokens":[{"tokenId":"poly_yes_token","outcome":"Yes","price":0.48},{"tokenId":"poly_no_token","outcome":"No","price":0.52}],"books":{"poly_yes_token":{"tokenId":"poly_yes_token","bids":[{"price":0.47,"size":12400},{"price":0.45999999999999996,"size":8300}],"asks":[{"price":0.49,"size":9100},{"price":0.5,"size":7200}],"timestampMs":1760000000000},"poly_no_token":{"tokenId":"poly_no_token","bids":[{"price":0.51,"size":12400},{"price":0.5,"size":8300}],"asks":[{"price":0.53,"size":9100},{"price":0.54,"size":7200}],"timestampMs":1760000000000}},"lastTrades":{"poly_yes_token":0.48,"poly_no_token":0.52},"yesToken":{"tokenId":"poly_yes_token","outcome":"Yes","price":0.48},"noToken":{"tokenId":"poly_no_token","outcome":"No","price":0.52},"yesBook":{"tokenId":"poly_yes_token","bids":[{"price":0.47,"size":12400},{"price":0.45999999999999996,"size":8300}],"asks":[{"price":0.49,"size":9100},{"price":0.5,"size":7200}],"timestampMs":1760000000000},"noBook":{"tokenId":"poly_no_token","bids":[{"price":0.51,"size":12400},{"price":0.5,"size":8300}],"asks":[{"price":0.53,"size":9100},{"price":0.54,"size":7200}],"timestampMs":1760000000000}}],"opportunityList":[{"strategy":"prediction_mispricing","edge":0.035,"description":"Polymarket opportunity from cached market snapshots and order book spread.","legs":[{"tokenId":"poly_yes_token","side":"BUY","price":0.49,"size":500,"outcome":"Yes","marketSlug":"us-x-iran-permanent-peace-deal-by-may-31-2026","reason":"spread and liquidity screen passed"}],"requiresShort":false}],"warnings":[]}}}}},"402":{"description":"Payment Required","headers":{"PAYMENT-REQUIRED":{"description":"Base64url-encoded x402 v2 payment challenge.","schema":{"type":"string"}}}}}}},"/v1/prediction/ending-soon":{"get":{"operationId":"prediction-ending-soon","summary":"Ending Soon Prediction Markets API","description":"Ending soon and expiring prediction market API for Polymarket, Kalshi, and Gemini. Find active markets resolving soon with close time, bid/ask prices, volume, liquidity, venue, and market links.","tags":["Market Intelligence"],"security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.1000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"source","in":"query","required":false,"description":"Optional prediction market venue filter: polymarket, kalshi, gemini, or all. Defaults to all.","schema":{"type":"string","enum":["polymarket","kalshi","gemini","all"],"description":"Optional prediction market venue filter: polymarket, kalshi, gemini, or all. Defaults to all."},"example":"all"},{"name":"hours","in":"query","required":false,"description":"Optional resolving-soon window in hours. Defaults to 24.","schema":{"type":"number","minimum":1,"maximum":168,"description":"Optional resolving-soon window in hours. Defaults to 24."},"example":24},{"name":"limit","in":"query","required":false,"description":"Optional maximum ending-soon markets to return. Defaults to 25.","schema":{"type":"number","minimum":1,"maximum":100,"description":"Optional maximum ending-soon markets to return. Defaults to 25."},"example":25}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"},"example":{"service":"seerium-x402-api","product":{"id":"prediction-ending-soon","name":"Ending Soon Prediction Markets API","method":"GET","path":"/v1/prediction/ending-soon","price":"$0.1000","accepts":[{"scheme":"exact","network":"eip155:8453","payTo":"0x81832eEDe3a4ad96CB3D7cA09977636D912fd3D5","price":"$0.1000"},{"scheme":"exact","network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","payTo":"2h752kAbb9z1jpdSzqMEYg9JHv6TPJ6T2BfAJMyjLFtZ","price":"$0.1000"}],"networks":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"]},"meta":{"requestId":"req_example_123","generatedAt":"2026-03-25T12:00:00.000Z","updatedAt":"2026-03-25T11:59:30.000Z","freshnessMs":30000},"data":{"timestamp":1760000000000,"criteria":{"source":"all","hours":24,"limit":25},"rows":[{"source":"kalshi","conditionId":"KXBTC-26MAY31-B100000","question":"Will Bitcoin be above $100,000 on May 31, 2026?","marketSlug":"kxbtc-26may31-b100000","marketUrl":"https://kalshi.com/markets/KXBTC-26MAY31-B100000","eventTitle":"Bitcoin price on May 31, 2026","eventSlug":"bitcoin-price-may-31-2026","seriesTicker":"KXBTC","seriesSlug":"bitcoin","marketTicker":"KXBTC-26MAY31-B100000","endDateIso":"2026-05-31T20:00:00.000Z","minutesUntilEnd":240,"yesBid":0.42,"yesAsk":0.44,"noBid":0.56,"noAsk":0.58,"yesPrice":0.43,"noPrice":0.57,"lastPrice":0.43,"volume24h":28450,"volume":193200,"liquidity":12800,"minOrderSize":1,"minTickSize":0.01,"acceptingOrders":true,"active":true,"closed":false,"archived":false,"indicative":true,"sourceUpdatedAt":"2026-05-31T15:56:00.000Z"}],"totalCandidates":12,"returned":1,"sourceCounts":{"polymarket":5,"kalshi":4,"gemini":3},"sourceUpdatedAt":{"polymarket":"2026-05-31T15:55:00.000Z","kalshi":"2026-05-31T15:56:00.000Z","gemini":"2026-05-31T15:54:30.000Z"},"warnings":[]}}}}},"402":{"description":"Payment Required","headers":{"PAYMENT-REQUIRED":{"description":"Base64url-encoded x402 v2 payment challenge.","schema":{"type":"string"}}}}}}},"/v1/prediction/cross-venue-disagreement":{"get":{"operationId":"prediction-cross-venue-disagreement","summary":"Cross-Venue Prediction Market Disagreement API","description":"Cross-venue prediction market disagreement API for Polymarket, Kalshi, and Gemini. Finds active related markets where venues price the same YES or NO outcome differently, with match confidence, price gap, liquidity, volume, and market identifiers.","tags":["Market Intelligence"],"security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.1000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"sources","in":"query","required":false,"description":"Optional comma-separated venue filter: polymarket, kalshi, gemini. Defaults to all.","schema":{"type":"string","description":"Optional comma-separated venue filter: polymarket, kalshi, gemini. Defaults to all."},"example":"polymarket,kalshi,gemini"},{"name":"limit","in":"query","required":false,"description":"Optional maximum disagreement rows to return. Defaults to 25.","schema":{"type":"number","minimum":1,"maximum":100,"description":"Optional maximum disagreement rows to return. Defaults to 25."},"example":25},{"name":"minGap","in":"query","required":false,"description":"Optional minimum price gap. Use 0.01 or 1 for one percentage point. Defaults to 0.01.","schema":{"type":"number","minimum":0,"maximum":1,"description":"Optional minimum price gap. Use 0.01 or 1 for one percentage point. Defaults to 0.01."},"example":0.01},{"name":"minMatchConfidence","in":"query","required":false,"description":"Optional minimum market match confidence. Use 0-1 or 0-100. Defaults to 0.7.","schema":{"type":"number","minimum":0,"maximum":1,"description":"Optional minimum market match confidence. Use 0-1 or 0-100. Defaults to 0.7."},"example":0.7},{"name":"includeIndicative","in":"query","required":false,"description":"Optional flag to include indicative price-only markets. Defaults to true.","schema":{"type":"boolean","description":"Optional flag to include indicative price-only markets. Defaults to true."},"example":true}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"},"example":{"service":"seerium-x402-api","product":{"id":"prediction-cross-venue-disagreement","name":"Cross-Venue Prediction Market Disagreement API","method":"GET","path":"/v1/prediction/cross-venue-disagreement","price":"$0.1000","accepts":[{"scheme":"exact","network":"eip155:8453","payTo":"0x81832eEDe3a4ad96CB3D7cA09977636D912fd3D5","price":"$0.1000"},{"scheme":"exact","network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","payTo":"2h752kAbb9z1jpdSzqMEYg9JHv6TPJ6T2BfAJMyjLFtZ","price":"$0.1000"}],"networks":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"]},"meta":{"requestId":"req_example_123","generatedAt":"2026-03-25T12:00:00.000Z","updatedAt":"2026-03-25T11:59:30.000Z","freshnessMs":30000},"data":{"timestamp":1760000000000,"criteria":{"sources":["polymarket","kalshi","gemini"],"limit":25,"minGap":0.01,"minMatchConfidence":0.7,"includeIndicative":true},"rows":[{"id":"disagreement_example","topic":"Bitcoin price on May 31, 2026: Will Bitcoin be above $100,000 on May 31, 2026?","outcome":"yes","gap":0.1,"gapPct":10,"matchConfidence":0.9,"matchType":"strong","matchedOn":{"type":"strong","dateKey":"2026-05-31","eventKey":"bitcoin price on may 31 2026","subjectKey":"will bitcoin be above 100000 on may 31 2026","numericKey":"100000|31|2026","directionKey":"above"},"sources":["polymarket","kalshi"],"lower":{"source":"polymarket","conditionId":"0xexample-poly","question":"Will Bitcoin be above $100,000 on May 31, 2026?","marketSlug":"will-bitcoin-be-above-100000-on-may-31-2026","eventTitle":"Bitcoin price on May 31, 2026","eventSlug":"bitcoin-price-may-31-2026","seriesTicker":null,"seriesSlug":"bitcoin","marketTicker":null,"endDateIso":"2026-05-31T20:00:00.000Z","yesBid":0.39,"yesAsk":0.41,"noBid":0.59,"noAsk":0.61,"yesPrice":0.4,"noPrice":0.6,"lastPrice":0.4,"volume24h":18450,"volume":129300,"liquidity":9400,"indicative":false,"sourceUpdatedAt":"2026-05-31T15:55:00.000Z","price":0.4},"higher":{"source":"kalshi","conditionId":"KXBTC-26MAY31-B100000","question":"Will Bitcoin be above $100,000 on May 31, 2026?","marketSlug":"kxbtc-26may31-b100000","eventTitle":"Bitcoin price on May 31, 2026","eventSlug":"bitcoin-price-may-31-2026","seriesTicker":"KXBTC","seriesSlug":"bitcoin","marketTicker":"KXBTC-26MAY31-B100000","endDateIso":"2026-05-31T20:00:00.000Z","yesBid":0.49,"yesAsk":0.51,"noBid":0.49,"noAsk":0.51,"yesPrice":0.5,"noPrice":0.5,"lastPrice":0.5,"volume24h":28450,"volume":193200,"liquidity":12800,"indicative":true,"sourceUpdatedAt":"2026-05-31T15:56:00.000Z","price":0.5},"markets":[{"source":"polymarket","conditionId":"0xexample-poly","question":"Will Bitcoin be above $100,000 on May 31, 2026?","marketSlug":"will-bitcoin-be-above-100000-on-may-31-2026","eventTitle":"Bitcoin price on May 31, 2026","eventSlug":"bitcoin-price-may-31-2026","seriesTicker":null,"seriesSlug":"bitcoin","marketTicker":null,"endDateIso":"2026-05-31T20:00:00.000Z","yesBid":0.39,"yesAsk":0.41,"noBid":0.59,"noAsk":0.61,"yesPrice":0.4,"noPrice":0.6,"lastPrice":0.4,"volume24h":18450,"volume":129300,"liquidity":9400,"indicative":false,"sourceUpdatedAt":"2026-05-31T15:55:00.000Z","price":0.4},{"source":"kalshi","conditionId":"KXBTC-26MAY31-B100000","question":"Will Bitcoin be above $100,000 on May 31, 2026?","marketSlug":"kxbtc-26may31-b100000","eventTitle":"Bitcoin price on May 31, 2026","eventSlug":"bitcoin-price-may-31-2026","seriesTicker":"KXBTC","seriesSlug":"bitcoin","marketTicker":"KXBTC-26MAY31-B100000","endDateIso":"2026-05-31T20:00:00.000Z","yesBid":0.49,"yesAsk":0.51,"noBid":0.49,"noAsk":0.51,"yesPrice":0.5,"noPrice":0.5,"lastPrice":0.5,"volume24h":28450,"volume":193200,"liquidity":12800,"indicative":true,"sourceUpdatedAt":"2026-05-31T15:56:00.000Z","price":0.5}],"totalLiquidity":22200,"totalVolume24h":46900,"minutesUntilEnd":240,"rationale":"kalshi prices YES 10 points above polymarket on a strong cross-venue match."}],"totalCandidates":14,"returned":1,"groups":42,"sourceCounts":{"polymarket":5,"kalshi":4,"gemini":3},"sourceUpdatedAt":{"polymarket":"2026-05-31T15:55:00.000Z","kalshi":"2026-05-31T15:56:00.000Z","gemini":"2026-05-31T15:54:30.000Z"},"warnings":[]}}}}},"402":{"description":"Payment Required","headers":{"PAYMENT-REQUIRED":{"description":"Base64url-encoded x402 v2 payment challenge.","schema":{"type":"string"}}}}}}},"/v1/prediction/arb/full-cover":{"get":{"operationId":"prediction-arb-full-cover","summary":"Prediction Market Arb Full Cover","description":"Prediction market arbitrage API for Polymarket, Kalshi, and Gemini. Finds full-cover YES plus NO combinations with positive net edge.","tags":["Market Intelligence"],"security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.1000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"limit","in":"query","required":false,"description":"Optional maximum arb rows to return. Defaults to 20 and is hard-capped at 20.","schema":{"type":"number","minimum":1,"maximum":20,"description":"Optional maximum arb rows to return. Defaults to 20 and is hard-capped at 20."},"example":3},{"name":"minEdge","in":"query","required":false,"description":"Optional minimum net arb edge as a decimal or percentage-style value.","schema":{"type":"number","minimum":0,"description":"Optional minimum net arb edge as a decimal or percentage-style value."},"example":0},{"name":"sources","in":"query","required":false,"description":"Optional comma-separated venue filter: polymarket, kalshi, gemini.","schema":{"type":"string","description":"Optional comma-separated venue filter: polymarket, kalshi, gemini."},"example":"polymarket,kalshi,gemini"},{"name":"includeIndicative","in":"query","required":false,"description":"Optional flag for indicative price-only rows. Defaults to true.","schema":{"type":"boolean","description":"Optional flag for indicative price-only rows. Defaults to true."},"example":true}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"},"example":{"service":"seerium-x402-api","product":{"id":"prediction-arb-full-cover","name":"Prediction Market Arb Full Cover","method":"GET","path":"/v1/prediction/arb/full-cover","price":"$0.1000","accepts":[{"scheme":"exact","network":"eip155:8453","payTo":"0x81832eEDe3a4ad96CB3D7cA09977636D912fd3D5","price":"$0.1000"},{"scheme":"exact","network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","payTo":"2h752kAbb9z1jpdSzqMEYg9JHv6TPJ6T2BfAJMyjLFtZ","price":"$0.1000"}],"networks":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"]},"meta":{"requestId":"req_example_123","generatedAt":"2026-03-25T12:00:00.000Z","updatedAt":"2026-03-25T11:59:30.000Z","freshnessMs":30000},"data":{"criteria":{"strategy":"full_cover","limit":20,"minEdge":null,"sources":[],"includeIndicative":true,"outcome":null},"rows":[{"id":"arb_full_cover_example","key":"question:will example event happen by friday:date:2026-03-30","strategy":"full_cover","question":"Will example event happen by Friday?","outcome":null,"edge":0.04,"grossEdge":0.042,"feeBuffer":0.002,"totalCost":0.96,"requiresShort":false,"sources":["polymarket","kalshi"],"matchedOn":{"dateKey":"2026-03-30","eventKey":"example event","subjectKey":"will example event happen by friday","numericKey":null,"directionKey":null},"yes":{"source":"polymarket","side":"BUY","outcome":"yes","tokenId":"poly_yes_token","marketSlug":"example-market","conditionId":"0xexample","marketTicker":null,"marketUrl":"https://polymarket.com/market/example-market","question":"Will example event happen by Friday?","price":0.42,"priceType":"ask","size":null,"totalDepth":null,"indicative":true,"endDateIso":"2026-03-30T00:00:00.000Z","eventTitle":"Example Event","eventTicker":null,"seriesTicker":null},"no":{"source":"kalshi","side":"BUY","outcome":"no","tokenId":"KXEXAMPLE:NO","marketSlug":"KXEXAMPLE","conditionId":"KXEXAMPLE","marketTicker":"KXEXAMPLE","marketUrl":"https://kalshi.com/markets/kxexample","question":"Will example event happen by Friday?","price":0.54,"priceType":"ask","size":null,"totalDepth":null,"indicative":true,"endDateIso":"2026-03-30T00:00:00.000Z","eventTitle":"Example Event","eventTicker":null,"seriesTicker":null},"legs":[{"source":"polymarket","side":"BUY","outcome":"yes","tokenId":"poly_yes_token","marketSlug":"example-market","conditionId":"0xexample","marketTicker":null,"marketUrl":"https://polymarket.com/market/example-market","question":"Will example event happen by Friday?","price":0.42,"priceType":"ask","size":null,"totalDepth":null,"indicative":true,"endDateIso":"2026-03-30T00:00:00.000Z","eventTitle":"Example Event","eventTicker":null,"seriesTicker":null},{"source":"kalshi","side":"BUY","outcome":"no","tokenId":"KXEXAMPLE:NO","marketSlug":"KXEXAMPLE","conditionId":"KXEXAMPLE","marketTicker":"KXEXAMPLE","marketUrl":"https://kalshi.com/markets/kxexample","question":"Will example event happen by Friday?","price":0.54,"priceType":"ask","size":null,"totalDepth":null,"indicative":true,"endDateIso":"2026-03-30T00:00:00.000Z","eventTitle":"Example Event","eventTicker":null,"seriesTicker":null}]}],"totalCandidates":1,"returned":1,"updatedAt":"2026-03-25T11:59:30.000Z","markets":1200,"totals":{"polymarket":500,"kalshi":450,"gemini":250,"groups":80,"fullCover":1,"sameOutcomeSpread":0},"sourceTimestamps":{"polymarket":1760000000000,"kalshi":1760000000000,"gemini":1760000000000},"warnings":[]}}}}},"402":{"description":"Payment Required","headers":{"PAYMENT-REQUIRED":{"description":"Base64url-encoded x402 v2 payment challenge.","schema":{"type":"string"}}}}}}},"/v1/prediction/arb/same-outcome-spread":{"get":{"operationId":"prediction-arb-same-outcome-spread","summary":"Prediction Market Same Outcome Spread","description":"Prediction market arbitrage and same-outcome spread API for Polymarket, Kalshi, and Gemini. Finds YES or NO price gaps across venues.","tags":["Market Intelligence"],"security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.1000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"limit","in":"query","required":false,"description":"Optional maximum arb rows to return. Defaults to 20 and is hard-capped at 20.","schema":{"type":"number","minimum":1,"maximum":20,"description":"Optional maximum arb rows to return. Defaults to 20 and is hard-capped at 20."},"example":3},{"name":"minEdge","in":"query","required":false,"description":"Optional minimum net arb edge as a decimal or percentage-style value.","schema":{"type":"number","minimum":0,"description":"Optional minimum net arb edge as a decimal or percentage-style value."},"example":0},{"name":"sources","in":"query","required":false,"description":"Optional comma-separated venue filter: polymarket, kalshi, gemini.","schema":{"type":"string","description":"Optional comma-separated venue filter: polymarket, kalshi, gemini."},"example":"polymarket,kalshi,gemini"},{"name":"includeIndicative","in":"query","required":false,"description":"Optional flag for indicative price-only rows. Defaults to true.","schema":{"type":"boolean","description":"Optional flag for indicative price-only rows. Defaults to true."},"example":true},{"name":"outcome","in":"query","required":false,"description":"Optional same-outcome filter.","schema":{"type":"string","enum":["yes","no"],"description":"Optional same-outcome filter."}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"},"example":{"service":"seerium-x402-api","product":{"id":"prediction-arb-same-outcome-spread","name":"Prediction Market Same Outcome Spread","method":"GET","path":"/v1/prediction/arb/same-outcome-spread","price":"$0.1000","accepts":[{"scheme":"exact","network":"eip155:8453","payTo":"0x81832eEDe3a4ad96CB3D7cA09977636D912fd3D5","price":"$0.1000"},{"scheme":"exact","network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","payTo":"2h752kAbb9z1jpdSzqMEYg9JHv6TPJ6T2BfAJMyjLFtZ","price":"$0.1000"}],"networks":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"]},"meta":{"requestId":"req_example_123","generatedAt":"2026-03-25T12:00:00.000Z","updatedAt":"2026-03-25T11:59:30.000Z","freshnessMs":30000},"data":{"criteria":{"strategy":"same_outcome_spread","limit":20,"minEdge":null,"sources":[],"includeIndicative":true,"outcome":"yes"},"rows":[{"id":"arb_same_outcome_example","key":"question:will example event happen by friday:date:2026-03-30","strategy":"same_outcome_spread","question":"Will example event happen by Friday?","outcome":"yes","edge":0.035,"grossEdge":0.037,"feeBuffer":0.002,"spread":0.037,"requiresShort":true,"sources":["gemini","polymarket"],"matchedOn":{"dateKey":"2026-03-30","eventKey":"example event","subjectKey":"will example event happen by friday","numericKey":null,"directionKey":null},"buy":{"source":"gemini","side":"BUY","outcome":"yes","tokenId":"GEMEXAMPLE:YES","marketSlug":"GEMEXAMPLE","conditionId":"GEMEXAMPLE","marketTicker":null,"marketUrl":"https://polymarket.com/market/example-market","question":"Will example event happen by Friday?","price":0.42,"priceType":"ask","size":null,"totalDepth":null,"indicative":true,"endDateIso":"2026-03-30T00:00:00.000Z","eventTitle":"Example Event","eventTicker":null,"seriesTicker":null},"sell":{"source":"polymarket","side":"SELL","outcome":"yes","tokenId":"poly_yes_token","marketSlug":"example-market","conditionId":"0xexample","marketTicker":null,"marketUrl":"https://polymarket.com/market/example-market","question":"Will example event happen by Friday?","price":0.457,"priceType":"bid","size":null,"totalDepth":null,"indicative":true,"endDateIso":"2026-03-30T00:00:00.000Z","eventTitle":"Example Event","eventTicker":null,"seriesTicker":null},"legs":[{"source":"gemini","side":"BUY","outcome":"yes","tokenId":"GEMEXAMPLE:YES","marketSlug":"GEMEXAMPLE","conditionId":"GEMEXAMPLE","marketTicker":null,"marketUrl":"https://polymarket.com/market/example-market","question":"Will example event happen by Friday?","price":0.42,"priceType":"ask","size":null,"totalDepth":null,"indicative":true,"endDateIso":"2026-03-30T00:00:00.000Z","eventTitle":"Example Event","eventTicker":null,"seriesTicker":null},{"source":"polymarket","side":"SELL","outcome":"yes","tokenId":"poly_yes_token","marketSlug":"example-market","conditionId":"0xexample","marketTicker":null,"marketUrl":"https://polymarket.com/market/example-market","question":"Will example event happen by Friday?","price":0.457,"priceType":"bid","size":null,"totalDepth":null,"indicative":true,"endDateIso":"2026-03-30T00:00:00.000Z","eventTitle":"Example Event","eventTicker":null,"seriesTicker":null}]}],"totalCandidates":1,"returned":1,"updatedAt":"2026-03-25T11:59:30.000Z","markets":1200,"totals":{"polymarket":500,"kalshi":450,"gemini":250,"groups":80,"fullCover":0,"sameOutcomeSpread":1},"sourceTimestamps":{"polymarket":1760000000000,"kalshi":1760000000000,"gemini":1760000000000},"warnings":[]}}}}},"402":{"description":"Payment Required","headers":{"PAYMENT-REQUIRED":{"description":"Base64url-encoded x402 v2 payment challenge.","schema":{"type":"string"}}}}}}},"/v1/dex/scan":{"get":{"operationId":"dex-scan","summary":"Dex Market Signals API","description":"Crypto market signals API for Dex market data, order books, funding, momentum, and trading opportunities.","tags":["Market Intelligence"],"security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.1000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"limitRows","in":"query","required":false,"description":"Optional maximum Dex market rows to return.","schema":{"type":"number","minimum":1,"description":"Optional maximum Dex market rows to return."},"example":10},{"name":"limitSnapshots","in":"query","required":false,"description":"Optional maximum Dex market snapshots to return.","schema":{"type":"number","minimum":1,"description":"Optional maximum Dex market snapshots to return."},"example":5},{"name":"limitOpportunities","in":"query","required":false,"description":"Optional maximum Dex trading opportunities to return.","schema":{"type":"number","minimum":1,"description":"Optional maximum Dex trading opportunities to return."},"example":5}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"},"example":{"service":"seerium-x402-api","product":{"id":"dex-scan","name":"Dex Market Signals API","method":"GET","path":"/v1/dex/scan","price":"$0.1000","accepts":[{"scheme":"exact","network":"eip155:8453","payTo":"0x81832eEDe3a4ad96CB3D7cA09977636D912fd3D5","price":"$0.1000"},{"scheme":"exact","network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","payTo":"2h752kAbb9z1jpdSzqMEYg9JHv6TPJ6T2BfAJMyjLFtZ","price":"$0.1000"}],"networks":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"]},"meta":{"requestId":"req_example_123","generatedAt":"2026-03-25T12:00:00.000Z","updatedAt":"2026-03-25T11:59:30.000Z","freshnessMs":30000},"data":{"timestamp":1760000000000,"venue":"dex","total":40,"rows":[{"venue":"dex","symbol":"SOL","lastPrice":82.36,"change24h":0.0157,"high24h":83.02,"low24h":80.07,"quoteVolume":2434347.58,"fundingRate":0.00223}],"snapshots":[{"market":{"source":"dex","conditionId":"SOL","question":"SOL","marketSlug":"SOL","lastPrice":82.36,"change24h":0.0157,"high24h":83.02,"low24h":80.07,"fundingRate":0.00223,"acceptingOrders":true,"active":true,"closed":false,"archived":false,"tokens":[{"tokenId":"SOL-PERP","outcome":"SOL","price":82.36}]},"tokens":[{"tokenId":"SOL-PERP","outcome":"SOL","price":82.36}],"books":{"SOL-PERP":{"tokenId":"SOL-PERP","bids":[{"price":82.36,"size":179.36},{"price":82.35,"size":633.81}],"asks":[{"price":82.37,"size":95.84},{"price":82.38,"size":445.49}],"timestampMs":1760000000000}},"lastTrades":{"SOL-PERP":82.36},"yesToken":null,"noToken":null,"yesBook":null,"noBook":null}],"opportunityList":[{"strategy":"dex_range_reversion","edge":0.0185,"description":"Range reversion BUY on SOL","legs":[{"tokenId":"SOL-PERP","side":"BUY","price":82.36,"size":5,"outcome":"SOL","marketSlug":"SOL","reason":"dex_range_reversion"}],"requiresShort":false}],"warnings":[]}}}}},"402":{"description":"Payment Required","headers":{"PAYMENT-REQUIRED":{"description":"Base64url-encoded x402 v2 payment challenge.","schema":{"type":"string"}}}}}}},"/v1/dex/orderbook-pressure":{"get":{"operationId":"dex-orderbook-pressure","summary":"Crypto Dex Order Book Pressure API","description":"Crypto order book API and Dex orderbook pressure feed for agents. Returns bid/ask depth imbalance, buy-side or sell-side pressure, microprice bias, spread in bps, notional liquidity, funding, and confidence for active crypto Dex symbols.","tags":["Market Intelligence"],"security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.1000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"symbol","in":"query","required":false,"description":"Optional crypto Dex symbol filter for order book pressure, for example BTC, BTCUSDT, or BTC-PERP.","schema":{"type":"string","description":"Optional crypto Dex symbol filter for order book pressure, for example BTC, BTCUSDT, or BTC-PERP."},"example":"BTC"},{"name":"limit","in":"query","required":false,"description":"Optional maximum crypto order book pressure rows to return. Defaults to 20.","schema":{"type":"number","minimum":1,"maximum":100,"description":"Optional maximum crypto order book pressure rows to return. Defaults to 20."},"example":10},{"name":"levels","in":"query","required":false,"description":"Optional order book levels per side used to measure buy-side or sell-side pressure. Defaults to 10.","schema":{"type":"number","minimum":1,"maximum":20,"description":"Optional order book levels per side used to measure buy-side or sell-side pressure. Defaults to 10."},"example":10},{"name":"minTotalDepthNotional","in":"query","required":false,"description":"Optional minimum combined bid plus ask notional depth filter.","schema":{"type":"number","minimum":0,"description":"Optional minimum combined bid plus ask notional depth filter."}},{"name":"maxSpreadBps","in":"query","required":false,"description":"Optional maximum top-of-book spread in basis points.","schema":{"type":"number","minimum":0,"description":"Optional maximum top-of-book spread in basis points."}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"},"example":{"service":"seerium-x402-api","product":{"id":"dex-orderbook-pressure","name":"Crypto Dex Order Book Pressure API","method":"GET","path":"/v1/dex/orderbook-pressure","price":"$0.1000","accepts":[{"scheme":"exact","network":"eip155:8453","payTo":"0x81832eEDe3a4ad96CB3D7cA09977636D912fd3D5","price":"$0.1000"},{"scheme":"exact","network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","payTo":"2h752kAbb9z1jpdSzqMEYg9JHv6TPJ6T2BfAJMyjLFtZ","price":"$0.1000"}],"networks":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"]},"meta":{"requestId":"req_example_123","generatedAt":"2026-03-25T12:00:00.000Z","updatedAt":"2026-03-25T11:59:30.000Z","freshnessMs":30000},"data":{"timestamp":1760000000000,"venue":"dex","criteria":{"symbol":"SOL","limit":10,"levels":10,"minTotalDepthNotional":null,"maxSpreadBps":null},"rows":[{"symbol":"SOL","pressureScore":0.3842,"direction":"buy_pressure","confidence":"high","depthImbalance":0.4175,"microBiasBps":3.62,"spreadBps":1.21,"bidDepthNotional":103428.44,"askDepthNotional":42516.72,"totalDepthNotional":145945.16,"bestBid":82.36,"bestAsk":82.37,"midPrice":82.365,"microprice":82.3948,"lastPrice":82.36,"change24h":0.0157,"fundingRate":0.00223,"levelsUsed":10,"bookTimestamp":"2026-03-25T11:59:30.000Z","reasons":["bid depth is 2.43x the opposite side across the measured book","microprice is 3.62 bps above mid","spread is 1.21 bps"]}],"totalCandidates":1,"returned":1,"warnings":[]}}}}},"402":{"description":"Payment Required","headers":{"PAYMENT-REQUIRED":{"description":"Base64url-encoded x402 v2 payment challenge.","schema":{"type":"string"}}}}}}},"/v1/dex/funding-heat":{"get":{"operationId":"dex-funding-heat","summary":"Crypto Dex Funding Heat API","description":"Crypto perpetual funding rate API, perp funding heatmap, and Dex funding heat feed for agents. Ranks active crypto Dex symbols by current funding pressure, crowded longs, crowded shorts, funding bps, severity, heat score, price move, volume, short squeeze risk, long squeeze risk, and reversal monitoring.","tags":["Market Intelligence"],"security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.1000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"symbol","in":"query","required":false,"description":"Optional crypto Dex or perpetual symbol filter for current funding heat, for example BTC, BTCUSDT, or BTC-PERP.","schema":{"type":"string","description":"Optional crypto Dex or perpetual symbol filter for current funding heat, for example BTC, BTCUSDT, or BTC-PERP."},"example":"BTC"},{"name":"limit","in":"query","required":false,"description":"Optional maximum current funding rate heat rows to return. Defaults to 20.","schema":{"type":"number","minimum":1,"maximum":100,"description":"Optional maximum current funding rate heat rows to return. Defaults to 20."},"example":10},{"name":"minAbsFundingBps","in":"query","required":false,"description":"Optional minimum absolute perp funding rate in basis points.","schema":{"type":"number","minimum":0,"description":"Optional minimum absolute perp funding rate in basis points."}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"},"example":{"service":"seerium-x402-api","product":{"id":"dex-funding-heat","name":"Crypto Dex Funding Heat API","method":"GET","path":"/v1/dex/funding-heat","price":"$0.1000","accepts":[{"scheme":"exact","network":"eip155:8453","payTo":"0x81832eEDe3a4ad96CB3D7cA09977636D912fd3D5","price":"$0.1000"},{"scheme":"exact","network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","payTo":"2h752kAbb9z1jpdSzqMEYg9JHv6TPJ6T2BfAJMyjLFtZ","price":"$0.1000"}],"networks":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"]},"meta":{"requestId":"req_example_123","generatedAt":"2026-03-25T12:00:00.000Z","updatedAt":"2026-03-25T11:59:30.000Z","freshnessMs":30000},"data":{"timestamp":1760000000000,"venue":"dex","criteria":{"symbol":"BTC","limit":10,"minAbsFundingBps":null},"rows":[{"rank":1,"symbol":"BTC","fundingRate":0.00012,"fundingBps":1.2,"sideCrowded":"long","severity":"medium","heatScore":8,"lastPrice":104250.5,"change24h":-0.012,"quoteVolume":82450000,"high24h":106200,"low24h":103800,"reason":"positive funding means longs are paying shorts by 1.2 bps."}],"totalCandidates":1,"returned":1,"warnings":[]}}}}},"402":{"description":"Payment Required","headers":{"PAYMENT-REQUIRED":{"description":"Base64url-encoded x402 v2 payment challenge.","schema":{"type":"string"}}}}}}},"/v1/pulse/latest":{"get":{"operationId":"pulse-latest","summary":"Crypto Market Pulse API","description":"Crypto news API and crypto market signals feed for agents. Returns market-moving headlines, macro events, weather, and x402 market data context.","tags":["Market Intelligence"],"security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.1000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"Accept","in":"header","required":false,"description":"Preferred response media type.","schema":{"type":"string","enum":["application/json"],"default":"application/json"},"example":"application/json"}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"},"example":{"service":"seerium-x402-api","product":{"id":"pulse-latest","name":"Crypto Market Pulse API","method":"GET","path":"/v1/pulse/latest","price":"$0.1000","accepts":[{"scheme":"exact","network":"eip155:8453","payTo":"0x81832eEDe3a4ad96CB3D7cA09977636D912fd3D5","price":"$0.1000"},{"scheme":"exact","network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","payTo":"2h752kAbb9z1jpdSzqMEYg9JHv6TPJ6T2BfAJMyjLFtZ","price":"$0.1000"}],"networks":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"]},"meta":{"requestId":"req_example_123","generatedAt":"2026-03-25T12:00:00.000Z","updatedAt":"2026-03-25T11:59:30.000Z","freshnessMs":30000},"data":{"timestamp":"2026-03-25T12:00:00.000Z","items":[{"id":"pulse_1","provider":"coindesk","headline":"Bitcoin volatility rises ahead of CPI print","summary":"Macro-sensitive crypto headlines from cached pulse sources.","description":"Macro-sensitive crypto headlines from cached pulse sources.","url":"https://example.com/pulse/bitcoin-cpi","imageUrl":"https://example.com/pulse/bitcoin-cpi.jpg","tags":["news","crypto"],"tickers":["BTC"],"status":"fresh","publishedAt":"2026-03-25T11:58:00.000Z"}]}}}}},"402":{"description":"Payment Required","headers":{"PAYMENT-REQUIRED":{"description":"Base64url-encoded x402 v2 payment challenge.","schema":{"type":"string"}}}}}}},"/v1/pulse/macro-clock":{"get":{"operationId":"pulse-macro-clock","summary":"Macro Market Signals API","description":"Macro market signals API for agents. Tracks inflation, rates, liquidity, economic releases, crypto, and prediction markets.","tags":["Market Intelligence"],"security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.1000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"Accept","in":"header","required":false,"description":"Preferred response media type.","schema":{"type":"string","enum":["application/json"],"default":"application/json"},"example":"application/json"}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"},"example":{"service":"seerium-x402-api","product":{"id":"pulse-macro-clock","name":"Macro Market Signals API","method":"GET","path":"/v1/pulse/macro-clock","price":"$0.1000","accepts":[{"scheme":"exact","network":"eip155:8453","payTo":"0x81832eEDe3a4ad96CB3D7cA09977636D912fd3D5","price":"$0.1000"},{"scheme":"exact","network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","payTo":"2h752kAbb9z1jpdSzqMEYg9JHv6TPJ6T2BfAJMyjLFtZ","price":"$0.1000"}],"networks":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"]},"meta":{"requestId":"req_example_123","generatedAt":"2026-03-25T12:00:00.000Z","updatedAt":"2026-03-25T11:59:30.000Z","freshnessMs":30000},"data":{"items":[{"id":"cpi","label":"US CPI","value":3.1,"unit":"%","date":"2026-03-25T12:00:00.000Z","change":-0.1,"changePct":-3.13,"score":74,"trend":"down","detail":"Latest macro pulse cache item"}]}}}}},"402":{"description":"Payment Required","headers":{"PAYMENT-REQUIRED":{"description":"Base64url-encoded x402 v2 payment challenge.","schema":{"type":"string"}}}}}}},"/v1/pulse/weather-markets":{"get":{"operationId":"pulse-weather-markets","summary":"Weather Prediction Market API","description":"Weather prediction market API for agents. Pairs NOAA weather context with related Polymarket market signals and event markets.","tags":["Market Intelligence"],"security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.1000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"Accept","in":"header","required":false,"description":"Preferred response media type.","schema":{"type":"string","enum":["application/json"],"default":"application/json"},"example":"application/json"}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"},"example":{"service":"seerium-x402-api","product":{"id":"pulse-weather-markets","name":"Weather Prediction Market API","method":"GET","path":"/v1/pulse/weather-markets","price":"$0.1000","accepts":[{"scheme":"exact","network":"eip155:8453","payTo":"0x81832eEDe3a4ad96CB3D7cA09977636D912fd3D5","price":"$0.1000"},{"scheme":"exact","network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","payTo":"2h752kAbb9z1jpdSzqMEYg9JHv6TPJ6T2BfAJMyjLFtZ","price":"$0.1000"}],"networks":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"]},"meta":{"requestId":"req_example_123","generatedAt":"2026-03-25T12:00:00.000Z","updatedAt":"2026-03-25T11:59:30.000Z","freshnessMs":30000},"data":{"items":[{"marketKey":"nyc-high-temp-2026-03-27","source":"polymarket","conditionId":"0xcondition","marketSlug":"will-nyc-hit-70f-on-mar-27","marketUrl":"https://polymarket.com/event/will-nyc-hit-70f-on-mar-27","question":"Will NYC reach 70F on March 27?","city":"New York","locationQuery":"New York, NY","targetDate":"2026-03-27","unit":"F","rule":{"kind":"at_or_above","threshold":70,"label":"70F or higher"},"endDateIso":"2026-03-27T23:59:59.000Z","endTimestamp":1774655999000,"location":{"latitude":40.7128,"longitude":-74.006,"gridId":"OKX","gridX":33,"gridY":35,"timezone":"America/New_York","relativeCity":"New York","relativeState":"NY"},"station":{"stationId":"KNYC","stationName":"Central Park","stationDistanceMeters":3200},"currentWeather":{"observedAt":"2026-03-25T11:55:00.000Z","temperatureC":19.4,"temperatureF":66.9,"dewpointC":10.2,"dewpointF":50.4,"relativeHumidity":55,"windSpeedKph":12.2,"windSpeedMph":7.6,"textDescription":"Partly Cloudy","iconUrl":"https://example.com/weather/icon.png"},"currentTempMarketUnit":66.9,"conditionMetNow":false,"status":"ok","error":null,"updatedAt":"2026-03-25T11:57:00.000Z","expiresAt":"2026-03-25T12:12:00.000Z"}]}}}}},"402":{"description":"Payment Required","headers":{"PAYMENT-REQUIRED":{"description":"Base64url-encoded x402 v2 payment challenge.","schema":{"type":"string"}}}}}}},"/v1/pulse/news-market-links":{"get":{"operationId":"pulse-news-market-links","summary":"News Prediction Market Links","description":"News prediction market API and crypto news feed for agents. Matches global headlines to Polymarket questions, catalysts, and market context.","tags":["Market Intelligence"],"security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.1000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"Accept","in":"header","required":false,"description":"Preferred response media type.","schema":{"type":"string","enum":["application/json"],"default":"application/json"},"example":"application/json"}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"},"example":{"service":"seerium-x402-api","product":{"id":"pulse-news-market-links","name":"News Prediction Market Links","method":"GET","path":"/v1/pulse/news-market-links","price":"$0.1000","accepts":[{"scheme":"exact","network":"eip155:8453","payTo":"0x81832eEDe3a4ad96CB3D7cA09977636D912fd3D5","price":"$0.1000"},{"scheme":"exact","network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","payTo":"2h752kAbb9z1jpdSzqMEYg9JHv6TPJ6T2BfAJMyjLFtZ","price":"$0.1000"}],"networks":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"]},"meta":{"requestId":"req_example_123","generatedAt":"2026-03-25T12:00:00.000Z","updatedAt":"2026-03-25T11:59:30.000Z","freshnessMs":30000},"data":{"items":[{"id":"pulse:headline_1","news":{"id":"headline_1","provider":"coindesk","headline":"Bitcoin volatility rises ahead of CPI print","summary":"Macro-sensitive crypto headlines from cached pulse sources.","description":"Macro-sensitive crypto headlines from cached pulse sources.","url":"https://example.com/pulse/bitcoin-cpi","imageUrl":"https://example.com/pulse/bitcoin-cpi.jpg","tags":["news","crypto"],"tickers":["BTC"],"status":"fresh","publishedAt":"2026-03-25T11:58:00.000Z"},"predictionMarket":{"question":"Will BTC close above $110k this week?","marketSlug":"will-btc-close-above-110k-this-week","source":"polymarket","url":"https://polymarket.com/event/will-btc-close-above-110k-this-week","score":0.92,"confidence":0.88,"matchedTokens":["BTC","bitcoin"],"market":{"source":"polymarket","marketSlug":"will-btc-close-above-110k-this-week","question":"Will BTC close above $110k this week?","endDateIso":"2026-03-28T00:00:00.000Z","volume24h":1200000,"volume":8450000,"liquidity":390000,"yesBid":0.47,"yesAsk":0.49,"noBid":0.51,"noAsk":0.53}}}]}}}}},"402":{"description":"Payment Required","headers":{"PAYMENT-REQUIRED":{"description":"Base64url-encoded x402 v2 payment challenge.","schema":{"type":"string"}}}}}}},"/v1/pulse/catalysts":{"get":{"operationId":"pulse-catalysts","summary":"Prediction Market Catalyst Signals","description":"News prediction market catalyst API for agents. Ranks prediction market signals by freshness, confidence, urgency, liquidity, and probability context.","tags":["Market Intelligence"],"security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.1000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"limit","in":"query","required":false,"description":"Optional maximum news catalyst to prediction-market links to return.","schema":{"type":"number","minimum":1,"description":"Optional maximum news catalyst to prediction-market links to return."},"example":3},{"name":"minConfidence","in":"query","required":false,"description":"Optional minimum catalyst link confidence.","schema":{"type":"number","minimum":0,"description":"Optional minimum catalyst link confidence."}},{"name":"tickers","in":"query","required":false,"description":"Optional comma-separated crypto tickers such as BTC,ETH,SOL.","schema":{"type":"string","description":"Optional comma-separated crypto tickers such as BTC,ETH,SOL."}},{"name":"source","in":"query","required":false,"description":"Optional news provider or prediction-market source filter.","schema":{"type":"string","description":"Optional news provider or prediction-market source filter."}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"},"example":{"service":"seerium-x402-api","product":{"id":"pulse-catalysts","name":"Prediction Market Catalyst Signals","method":"GET","path":"/v1/pulse/catalysts","price":"$0.1000","accepts":[{"scheme":"exact","network":"eip155:8453","payTo":"0x81832eEDe3a4ad96CB3D7cA09977636D912fd3D5","price":"$0.1000"},{"scheme":"exact","network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","payTo":"2h752kAbb9z1jpdSzqMEYg9JHv6TPJ6T2BfAJMyjLFtZ","price":"$0.1000"}],"networks":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"]},"meta":{"requestId":"req_example_123","generatedAt":"2026-03-25T12:00:00.000Z","updatedAt":"2026-03-25T11:59:30.000Z","freshnessMs":30000},"data":{"criteria":{"limit":3,"minConfidence":null,"tickers":[],"source":null},"catalysts":[{"id":"pulse:headline_1","catalystScore":84.2,"freshnessMinutes":4.5,"news":{"id":"headline_1","provider":"coindesk","headline":"Bitcoin volatility rises ahead of CPI print","summary":"Macro-sensitive crypto headlines from cached pulse sources.","tags":["news","crypto"],"tickers":["BTC"],"status":"fresh","publishedAt":"2026-03-25T11:58:00.000Z"},"impact":{"question":"Will BTC close above $110k this week?","marketSlug":"will-btc-close-above-110k-this-week","source":"polymarket","url":"https://polymarket.com/event/will-btc-close-above-110k-this-week","score":0.92,"confidence":0.88,"matchedTokens":["BTC","bitcoin"],"volume24h":1200000,"liquidity":390000,"yesBid":0.47,"yesAsk":0.49,"probabilityMidpoint":0.48,"spread":0.02,"hoursToClose":61.5,"urgency":"soon"},"reasons":["matchedTokens=BTC,bitcoin","linkConfidence=0.88","urgency=soon"]}],"returned":1,"totalLinkedItems":10}}}}},"402":{"description":"Payment Required","headers":{"PAYMENT-REQUIRED":{"description":"Base64url-encoded x402 v2 payment challenge.","schema":{"type":"string"}}}}}}},"/v1/opportunities/ranked":{"post":{"operationId":"ranked-opportunities","summary":"Ranked Market Opportunities API","description":"Ranked opportunities API and market signals API for agents. Ranks Polymarket prediction market opportunities and Dex signals by budget, liquidity, spread, horizon, and risk.","tags":["Market Intelligence"],"security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.1000"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"source":{"type":"string","enum":["all","prediction","dex"],"description":"Optional opportunity source: Polymarket prediction markets, Dex markets, or all. Defaults to all."},"limit":{"type":"number","minimum":1,"description":"Optional maximum ranked opportunities to return. Defaults to 25."},"budgetUsd":{"type":"number","minimum":1,"description":"Optional maximum notional budget in USD."},"minLiquidity":{"type":"number","minimum":0,"description":"Optional minimum market or leg liquidity in USD."},"maxSpread":{"type":"number","minimum":0,"description":"Optional maximum acceptable order book spread."},"minEdge":{"type":"number","description":"Optional minimum opportunity edge as a decimal or percent-style value."},"category":{"type":"string","description":"Optional text filter over strategy, market question, event metadata, or theme."},"horizonHours":{"type":"number","minimum":0,"description":"Optional maximum hours to market close."},"allowShort":{"type":"boolean","description":"Optional flag to include opportunities requiring short exposure."},"riskProfile":{"type":"string","enum":["conservative","balanced","aggressive"],"description":"Optional risk profile used to rank opportunities. Defaults to balanced."}},"additionalProperties":false},"example":{"source":"all","allowShort":true,"riskProfile":"balanced","limit":3}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"},"example":{"service":"seerium-x402-api","product":{"id":"ranked-opportunities","name":"Ranked Market Opportunities API","method":"POST","path":"/v1/opportunities/ranked","price":"$0.1000","accepts":[{"scheme":"exact","network":"eip155:8453","payTo":"0x81832eEDe3a4ad96CB3D7cA09977636D912fd3D5","price":"$0.1000"},{"scheme":"exact","network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","payTo":"2h752kAbb9z1jpdSzqMEYg9JHv6TPJ6T2BfAJMyjLFtZ","price":"$0.1000"}],"networks":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"]},"meta":{"requestId":"req_example_123","generatedAt":"2026-03-25T12:00:00.000Z","updatedAt":"2026-03-25T11:59:30.000Z","freshnessMs":30000},"data":{"criteria":{"source":"all","limit":3,"budgetUsd":null,"minLiquidity":null,"maxSpread":null,"minEdge":null,"category":null,"horizonHours":null,"allowShort":true,"riskProfile":"balanced"},"rows":[{"rank":1,"source":"prediction","strategy":"mispricing_spread","score":81.4,"edge":0.035,"estimatedNotionalUsd":480,"maxLegSpread":0.02,"minLiquidity":54000,"avgAgentConfidence":72,"riskLevel":"medium","requiresShort":false,"horizonHours":48.2,"description":"Strategy-derived opportunity from cached market snapshots.","fit":{"budgetOk":true,"liquidityOk":true,"spreadOk":true,"horizonOk":true},"reasons":["edge=0.035","score=81.4","avgAgentConfidence=72"],"legs":[{"tokenId":"poly_yes_token","side":"BUY","price":0.49,"size":500,"outcome":"Yes","marketSlug":"us-x-iran-permanent-peace-deal-by-may-31-2026","reason":"spread and liquidity screen passed"}]}],"totalCandidates":42,"returned":1,"warnings":[]}}}}},"402":{"description":"Payment Required","headers":{"PAYMENT-REQUIRED":{"description":"Base64url-encoded x402 v2 payment challenge.","schema":{"type":"string"}}}}}}},"/v1/prediction/builders":{"get":{"operationId":"polymarket-builder-stats","summary":"Polymarket Builder Stats API","description":"Polymarket API for builder stats. Ranks prediction market creators by volume, active users, verification, and period comparisons.","tags":["Market Intelligence"],"security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.1000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"timePeriod","in":"query","required":false,"description":"Optional Polymarket builder ranking period. Defaults to MONTH.","schema":{"type":"string","enum":["DAY","WEEK","MONTH","ALL"],"description":"Optional Polymarket builder ranking period. Defaults to MONTH."},"example":"MONTH"},{"name":"limit","in":"query","required":false,"description":"Optional maximum ranked Polymarket builders to return. Defaults to 50.","schema":{"type":"number","minimum":1,"description":"Optional maximum ranked Polymarket builders to return. Defaults to 50."},"example":25},{"name":"offset","in":"query","required":false,"description":"Optional pagination offset. Defaults to 0.","schema":{"type":"number","minimum":0,"description":"Optional pagination offset. Defaults to 0."},"example":0}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"},"example":{"service":"seerium-x402-api","product":{"id":"polymarket-builder-stats","name":"Polymarket Builder Stats API","method":"GET","path":"/v1/prediction/builders","price":"$0.1000","accepts":[{"scheme":"exact","network":"eip155:8453","payTo":"0x81832eEDe3a4ad96CB3D7cA09977636D912fd3D5","price":"$0.1000"},{"scheme":"exact","network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","payTo":"2h752kAbb9z1jpdSzqMEYg9JHv6TPJ6T2BfAJMyjLFtZ","price":"$0.1000"}],"networks":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"]},"meta":{"requestId":"req_example_123","generatedAt":"2026-03-25T12:00:00.000Z","updatedAt":"2026-03-25T11:59:30.000Z","freshnessMs":30000},"data":{"criteria":{"timePeriod":"MONTH","limit":25,"offset":0},"builders":[{"dt":"2026-03-25T00:00:00.000Z","rank":1,"builder":"Example Builder","volume":1250000,"activeUsers":420,"verified":true,"builderLogo":null,"volumeShare":0.2976,"volumePerActiveUser":2976.19}],"summary":{"period":"MONTH","builderCount":24,"verifiedCount":12,"totalVolume":4200000,"activeUsers":1800,"topBuilder":"Example Builder","topBuilderVolume":1250000,"topBuilderShare":0.2976,"medianVolumePerUser":1800},"total":24,"nextOffset":null,"updatedAt":"2026-03-25T11:59:30.000Z"}}}}},"402":{"description":"Payment Required","headers":{"PAYMENT-REQUIRED":{"description":"Base64url-encoded x402 v2 payment challenge.","schema":{"type":"string"}}}}}}},"/v1/prediction/builders/detail":{"get":{"operationId":"polymarket-builder-detail","summary":"Polymarket Builder Detail API","description":"Polymarket API for builder analytics. Returns one prediction market creator's volume, active users, verification, breakdowns, and time series rows.","tags":["Market Intelligence"],"security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.1000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"builder","in":"query","required":true,"description":"Required Polymarket builder or creator name. Use /v1/prediction/builders first to discover current builder names.","schema":{"type":"string","minLength":1,"description":"Required Polymarket builder or creator name. Use /v1/prediction/builders first to discover current builder names."},"example":"Polymarket"},{"name":"timePeriod","in":"query","required":false,"description":"Optional selected period for builder detail and series rows. Defaults to MONTH.","schema":{"type":"string","enum":["DAY","WEEK","MONTH","ALL"],"description":"Optional selected period for builder detail and series rows. Defaults to MONTH."},"example":"MONTH"}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"},"example":{"service":"seerium-x402-api","product":{"id":"polymarket-builder-detail","name":"Polymarket Builder Detail API","method":"GET","path":"/v1/prediction/builders/detail","price":"$0.1000","accepts":[{"scheme":"exact","network":"eip155:8453","payTo":"0x81832eEDe3a4ad96CB3D7cA09977636D912fd3D5","price":"$0.1000"},{"scheme":"exact","network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","payTo":"2h752kAbb9z1jpdSzqMEYg9JHv6TPJ6T2BfAJMyjLFtZ","price":"$0.1000"}],"networks":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"]},"meta":{"requestId":"req_example_123","generatedAt":"2026-03-25T12:00:00.000Z","updatedAt":"2026-03-25T11:59:30.000Z","freshnessMs":30000},"data":{"builder":"Example Builder","timePeriod":"MONTH","selectedPeriod":{"dt":"2026-03-25T00:00:00.000Z","rank":1,"builder":"Example Builder","volume":1250000,"activeUsers":420,"verified":true,"builderLogo":null,"volumeShare":0.2976,"volumePerActiveUser":2976.19},"periodBreakdown":[{"period":"MONTH","rank":1,"volume":1250000,"activeUsers":420,"volumeShare":0.2976,"volumePerActiveUser":2976.19,"verified":true,"builderLogo":null,"dt":"2026-03-25T00:00:00.000Z"}],"seriesRows":[],"updatedAt":"2026-03-25T11:59:30.000Z"}}}}},"402":{"description":"Payment Required","headers":{"PAYMENT-REQUIRED":{"description":"Base64url-encoded x402 v2 payment challenge.","schema":{"type":"string"}}}}}}},"/v1/prediction/rewards":{"get":{"operationId":"sponsor-rewards","summary":"Polymarket Sponsor Rewards API","description":"Polymarket sponsor rewards API for agents. Finds prediction market reward programs with CLOB liquidity, volume, spread, and current daily reward rates.","tags":["Market Intelligence"],"security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.1000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"limit","in":"query","required":false,"description":"Optional maximum Polymarket sponsor reward markets to return. Defaults to 50.","schema":{"type":"number","minimum":1,"description":"Optional maximum Polymarket sponsor reward markets to return. Defaults to 50."},"example":10},{"name":"offset","in":"query","required":false,"description":"Optional pagination offset. Defaults to 0.","schema":{"type":"number","minimum":0,"description":"Optional pagination offset. Defaults to 0."},"example":0},{"name":"order","in":"query","required":false,"description":"Optional sort field such as volume24hr, liquidityClob, or currentDailyRewardsRate. Defaults to volume24hr.","schema":{"type":"string","description":"Optional sort field such as volume24hr, liquidityClob, or currentDailyRewardsRate. Defaults to volume24hr."},"example":"volume24hr"},{"name":"ascending","in":"query","required":false,"description":"Optional flag to sort ascending. Defaults to false.","schema":{"type":"boolean","description":"Optional flag to sort ascending. Defaults to false."},"example":false},{"name":"volumeMin","in":"query","required":false,"description":"Optional minimum 24h market volume.","schema":{"type":"number","description":"Optional minimum 24h market volume."}},{"name":"liquidityMin","in":"query","required":false,"description":"Optional minimum CLOB liquidity.","schema":{"type":"number","description":"Optional minimum CLOB liquidity."}},{"name":"rewardsMinSize","in":"query","required":false,"description":"Optional minimum reward program min-size.","schema":{"type":"number","description":"Optional minimum reward program min-size."}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"},"example":{"service":"seerium-x402-api","product":{"id":"sponsor-rewards","name":"Polymarket Sponsor Rewards API","method":"GET","path":"/v1/prediction/rewards","price":"$0.1000","accepts":[{"scheme":"exact","network":"eip155:8453","payTo":"0x81832eEDe3a4ad96CB3D7cA09977636D912fd3D5","price":"$0.1000"},{"scheme":"exact","network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","payTo":"2h752kAbb9z1jpdSzqMEYg9JHv6TPJ6T2BfAJMyjLFtZ","price":"$0.1000"}],"networks":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"]},"meta":{"requestId":"req_example_123","generatedAt":"2026-03-25T12:00:00.000Z","updatedAt":"2026-03-25T11:59:30.000Z","freshnessMs":30000},"data":{"markets":[{"marketId":"1919425","conditionId":"0x0e4a0c937b8934c2475613b6322b3f8edc8dedc24762e01e42b0e6f87424a089","marketSlug":"us-x-iran-permanent-peace-deal-by-may-31-2026","question":"US x Iran permanent peace deal by May 31, 2026?","eventTitle":null,"clobTokenIds":["poly_yes_token","poly_no_token"],"rewardsMinSize":200,"rewardsMaxSpread":3.5,"spread":0.01,"volume24hr":5768589.43,"liquidityClob":1201662.28,"liquidityAmm":null,"rewardAmount":null,"rewardAllocation":null,"clobRewards":[{"id":null,"conditionId":null,"assetAddress":"0xC011a7E12a19f7B1f670d46F03B03f3342E82DFB","rewardsAmount":0,"rewardsDailyRate":5000,"startDate":"2026-05-19T00:00:00.000Z","endDate":"2500-12-31T00:00:00.000Z"}],"activeRewardPrograms":1,"currentDailyRewardsRate":5000,"currentRewardsAmount":0,"clobRewardsStart":"2026-05-19T00:00:00.000Z","clobRewardsEnd":"2500-12-31T00:00:00.000Z"}],"total":500,"nextOffset":1}}}}},"402":{"description":"Payment Required","headers":{"PAYMENT-REQUIRED":{"description":"Base64url-encoded x402 v2 payment challenge.","schema":{"type":"string"}}}}}}},"/v1/prediction/rewards/lab":{"post":{"operationId":"sponsor-rewards-lab","summary":"Polymarket Rewards Lab API","description":"Polymarket rewards lab API for agents. Analyzes sponsor rewards markets, order book depth, slippage, recent prints, and quote bands.","tags":["Market Intelligence"],"security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.1000"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"targetNotional":{"type":"number","minimum":1,"description":"Optional target quote notional used for depth and slippage analysis. Defaults to 1000."},"includePrints":{"type":"boolean","description":"Optional flag to include recent Polymarket trade prints. Defaults to false."},"tradesLimit":{"type":"number","minimum":1,"description":"Optional maximum recent prints to fetch per market when includePrints is true."},"markets":{"type":"array","description":"Required unless market is provided. Reward markets to analyze. Use /v1/prediction/rewards first and pass returned marketId or conditionId plus clobTokenIds.","minItems":1,"items":{"type":"object","properties":{"marketId":{"type":"string","minLength":1,"description":"Preferred Polymarket reward market identifier. conditionId is also accepted."},"conditionId":{"type":"string","description":"Alternative Polymarket condition id when marketId is not available."},"marketSlug":{"type":"string","description":"Optional Polymarket market slug."},"question":{"type":"string","minLength":1,"description":"Optional prediction-market question. marketSlug or identifier is used when omitted."},"clobTokenIds":{"type":"array","description":"Required Polymarket CLOB token ids for the market outcomes.","minItems":1,"items":{"type":"string","minLength":1}},"rewardsMaxSpread":{"type":"number","minimum":0,"description":"Optional reward-eligible maximum spread."}},"required":["clobTokenIds"],"anyOf":[{"required":["marketId"]},{"required":["conditionId"]}],"additionalProperties":false}},"market":{"type":"object","properties":{"marketId":{"type":"string","minLength":1,"description":"Preferred Polymarket reward market identifier. conditionId is also accepted."},"conditionId":{"type":"string","description":"Alternative Polymarket condition id when marketId is not available."},"marketSlug":{"type":"string","description":"Optional Polymarket market slug."},"question":{"type":"string","minLength":1,"description":"Optional prediction-market question. marketSlug or identifier is used when omitted."},"clobTokenIds":{"type":"array","description":"Required Polymarket CLOB token ids for the market outcomes.","minItems":1,"items":{"type":"string","minLength":1}},"rewardsMaxSpread":{"type":"number","minimum":0,"description":"Optional reward-eligible maximum spread."}},"required":["clobTokenIds"],"anyOf":[{"required":["marketId"]},{"required":["conditionId"]}],"additionalProperties":false}},"anyOf":[{"required":["markets"]},{"required":["market"]}],"additionalProperties":false},"example":{}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"},"example":{"service":"seerium-x402-api","product":{"id":"sponsor-rewards-lab","name":"Polymarket Rewards Lab API","method":"POST","path":"/v1/prediction/rewards/lab","price":"$0.1000","accepts":[{"scheme":"exact","network":"eip155:8453","payTo":"0x81832eEDe3a4ad96CB3D7cA09977636D912fd3D5","price":"$0.1000"},{"scheme":"exact","network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","payTo":"2h752kAbb9z1jpdSzqMEYg9JHv6TPJ6T2BfAJMyjLFtZ","price":"$0.1000"}],"networks":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"]},"meta":{"requestId":"req_example_123","generatedAt":"2026-03-25T12:00:00.000Z","updatedAt":"2026-03-25T11:59:30.000Z","freshnessMs":30000},"data":{"targetNotional":500,"markets":[{"marketId":"0xmarket","conditionId":"0xcondition","marketSlug":"will-btc-close-above-110k-this-week","question":"Will BTC close above $110k this week?","rewardsMaxSpread":0.03,"tokenMetrics":[{"tokenId":"12345","midpoint":0.48,"bestBid":0.47,"bestAsk":0.49,"spread":0.02,"depthWithinBandNotional":820,"depthWithinBandBidNotional":390,"depthWithinBandAskNotional":430,"buyProjection":{"targetNotional":500,"filledNotional":500,"fillPct":100,"averagePrice":0.489,"worstPrice":0.492,"slippagePct":1.88},"sellProjection":{"targetNotional":500,"filledNotional":500,"fillPct":100,"averagePrice":0.471,"worstPrice":0.468,"slippagePct":1.88},"heatmapBins":[{"price":0.49,"bidSize":0,"bidNotional":0,"askSize":1400,"askNotional":686},{"price":0.47,"bidSize":1350,"bidNotional":634.5,"askSize":0,"askNotional":0}]}],"midpoint":0.48,"spread":0.02,"depthWithinBandNotional":820,"sponsorScore":92,"sponsorWorthy":true,"buyProjection":{"targetNotional":500,"filledNotional":500,"fillPct":100,"averagePrice":0.489,"worstPrice":0.492,"slippagePct":1.88},"sellProjection":{"targetNotional":500,"filledNotional":500,"fillPct":100,"averagePrice":0.471,"worstPrice":0.468,"slippagePct":1.88},"prints":[{"tradeId":"trade_1","side":"BUY","price":0.49,"size":250,"timestamp":"2026-03-25T11:58:00.000Z","outcome":"Yes","wallet":"0x1234567890abcdef1234567890abcdef12345678"}]}]}}}}},"402":{"description":"Payment Required","headers":{"PAYMENT-REQUIRED":{"description":"Base64url-encoded x402 v2 payment challenge.","schema":{"type":"string"}}}}}}},"/v1/prediction/rewards/optimize":{"post":{"operationId":"sponsor-rewards-optimize","summary":"Polymarket Rewards Optimizer API","description":"Polymarket rewards optimizer API for agents. Produces reward plans from live books, recent prints, inventory, budget, and sponsor rewards metadata.","tags":["Market Intelligence"],"security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.1000"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"marketId":{"type":"string","minLength":1,"description":"Required unless conditionId or marketSlug is provided. Use a marketId from /v1/prediction/rewards."},"conditionId":{"type":"string","minLength":1,"description":"Required unless marketId or marketSlug is provided. Use a conditionId from /v1/prediction/rewards."},"marketSlug":{"type":"string","minLength":1,"description":"Required unless marketId or conditionId is provided. Use a marketSlug from /v1/prediction/rewards."},"quoteBudgetUsd":{"type":"number","minimum":1,"description":"Optional USD budget available for qualifying reward quotes. Defaults to 1000."},"currentInventoryUsd":{"type":"number","description":"Optional signed current inventory exposure in USD. Defaults to 0."},"profile":{"type":"string","enum":["passive","balanced","aggressive"],"description":"Optional rewards quoting risk profile. Defaults to balanced."}},"anyOf":[{"required":["marketId"]},{"required":["conditionId"]},{"required":["marketSlug"]}],"additionalProperties":false},"example":{}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"},"example":{"service":"seerium-x402-api","product":{"id":"sponsor-rewards-optimize","name":"Polymarket Rewards Optimizer API","method":"POST","path":"/v1/prediction/rewards/optimize","price":"$0.1000","accepts":[{"scheme":"exact","network":"eip155:8453","payTo":"0x81832eEDe3a4ad96CB3D7cA09977636D912fd3D5","price":"$0.1000"},{"scheme":"exact","network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","payTo":"2h752kAbb9z1jpdSzqMEYg9JHv6TPJ6T2BfAJMyjLFtZ","price":"$0.1000"}],"networks":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"]},"meta":{"requestId":"req_example_123","generatedAt":"2026-03-25T12:00:00.000Z","updatedAt":"2026-03-25T11:59:30.000Z","freshnessMs":30000},"data":{"market":{"marketId":"0xmarket","conditionId":"0xcondition","marketSlug":"will-btc-close-above-110k-this-week","question":"Will BTC close above $110k this week?","rewardsMinSize":100,"rewardsMaxSpread":0.03,"currentDailyRewardsRate":120,"clobRewardsStart":"2026-03-25T00:00:00.000Z","clobRewardsEnd":"2026-03-28T00:00:00.000Z","midpoint":0.48,"spread":0.02,"bestBid":0.47,"bestAsk":0.49,"tokenCount":2},"assumptionsUsed":{"quoteBudgetUsd":1000,"currentInventoryUsd":0,"profile":"balanced","deployableBudgetUsd":700,"inventoryCapUsd":700},"verdict":"quote_both_sides","recommendedQuoteBand":{"rewardEligibleMaxSpread":0.03,"perToken":[{"tokenId":"12345","midpoint":0.48,"tickSize":0.01,"rewardEligibleBidFloor":0.45,"rewardEligibleAskCeiling":0.51,"bidMin":0.46,"bidMax":0.47,"askMin":0.49,"askMax":0.5}]},"targetSize":{"totalBudgetUsd":1000,"deployableBudgetUsd":700,"perTokenUsd":350,"perTokenShares":729.17,"minQualifyingShares":100,"minQualifyingNotionalUsd":48,"meetsMinSize":true},"expectedRewardsPerDay":28.4,"fillProb":{"next15m":0.18,"next1h":0.55},"inventoryRisk":{"score":28,"level":"low","currentInventoryUsd":0,"maxSuggestedInventoryUsd":700},"cancelReplaceThreshold":{"midpointMoveBps":45,"queueLossPct":24,"maxQuoteAgeSec":43},"why":["Live rewards rate is healthy relative to current inside-band depth.","Configured budget clears the reward min-size threshold across both token books.","Fill probability and inventory pressure support an active rewards quote plan."],"diagnostics":{"sponsorScore":78,"depthWithinBandNotional":820,"projectedRewardShare":0.46,"recentPrintCount":12,"recentPrintNotionalUsd":3100,"printWindowMinutes":36,"hourlyFlowUsd":5166.67}}}}}},"402":{"description":"Payment Required","headers":{"PAYMENT-REQUIRED":{"description":"Base64url-encoded x402 v2 payment challenge.","schema":{"type":"string"}}}}}}},"/v1/prediction/rewards/top-plans":{"post":{"operationId":"sponsor-rewards-top-plans","summary":"Polymarket Rewards Top Plans","description":"Polymarket reward plans API for agents. Discovers and ranks sponsor rewards quote strategies for a caller-provided budget.","tags":["Market Intelligence"],"security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.1000"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"quoteBudgetUsd":{"type":"number","minimum":1,"description":"Optional USD budget available for qualifying reward quotes. Defaults to 1000."},"currentInventoryUsd":{"type":"number","description":"Optional signed current inventory exposure in USD. Defaults to 0."},"profile":{"type":"string","enum":["passive","balanced","aggressive"],"description":"Optional rewards quoting risk profile. Defaults to balanced."},"limit":{"type":"number","minimum":1,"description":"Optional maximum optimized rewards plans to return. Defaults to 5."},"candidateLimit":{"type":"number","minimum":1,"description":"Optional maximum reward markets to evaluate before ranking. Defaults to 24."},"minDailyRewardsRate":{"type":"number","minimum":0,"description":"Optional minimum active daily reward rate."},"minLiquidity":{"type":"number","minimum":0,"description":"Optional minimum CLOB liquidity."},"maxSpread":{"type":"number","minimum":0,"description":"Optional maximum current or reward max spread."},"includeSkipped":{"type":"boolean","description":"Optional flag to include optimizer skip verdicts. Defaults to false."}},"additionalProperties":false},"example":{"quoteBudgetUsd":1000,"currentInventoryUsd":0,"profile":"balanced","limit":5,"candidateLimit":24}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"},"example":{"service":"seerium-x402-api","product":{"id":"sponsor-rewards-top-plans","name":"Polymarket Rewards Top Plans","method":"POST","path":"/v1/prediction/rewards/top-plans","price":"$0.1000","accepts":[{"scheme":"exact","network":"eip155:8453","payTo":"0x81832eEDe3a4ad96CB3D7cA09977636D912fd3D5","price":"$0.1000"},{"scheme":"exact","network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","payTo":"2h752kAbb9z1jpdSzqMEYg9JHv6TPJ6T2BfAJMyjLFtZ","price":"$0.1000"}],"networks":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"]},"meta":{"requestId":"req_example_123","generatedAt":"2026-03-25T12:00:00.000Z","updatedAt":"2026-03-25T11:59:30.000Z","freshnessMs":30000},"data":{"criteria":{"quoteBudgetUsd":1000,"currentInventoryUsd":0,"profile":"balanced","limit":5,"candidateLimit":24,"minDailyRewardsRate":null,"minLiquidity":null,"maxSpread":null,"includeSkipped":false},"plans":[{"rank":1,"score":82.7,"rankingReasons":["score=82.7","verdict=quote_both_sides","expectedRewardsPerDay=28.4","risk=low"],"plan":{"market":{"marketId":"0xmarket","conditionId":"0xcondition","marketSlug":"will-btc-close-above-110k-this-week","question":"Will BTC close above $110k this week?","rewardsMinSize":100,"rewardsMaxSpread":0.03,"currentDailyRewardsRate":120,"clobRewardsStart":"2026-03-25T00:00:00.000Z","clobRewardsEnd":"2026-03-28T00:00:00.000Z","midpoint":0.48,"spread":0.02,"bestBid":0.47,"bestAsk":0.49,"tokenCount":2},"assumptionsUsed":{"quoteBudgetUsd":1000,"currentInventoryUsd":0,"profile":"balanced","deployableBudgetUsd":700,"inventoryCapUsd":700},"verdict":"quote_both_sides","expectedRewardsPerDay":28.4,"fillProb":{"next15m":0.18,"next1h":0.55},"inventoryRisk":{"score":28,"level":"low","currentInventoryUsd":0,"maxSuggestedInventoryUsd":700}}}],"skipped":[],"totalCandidates":12,"evaluatedCandidates":5,"returned":1}}}}},"402":{"description":"Payment Required","headers":{"PAYMENT-REQUIRED":{"description":"Base64url-encoded x402 v2 payment challenge.","schema":{"type":"string"}}}}}}},"/v1/prediction/whale-radar/top-10-recent-moves":{"get":{"operationId":"whale-radar-top-10-recent-moves","summary":"Polymarket Whale Radar API","description":"Polymarket whale trades API and whale radar feed for agents. Returns the top 10 largest recent trades from tracked whale wallets.","tags":["Market Intelligence"],"security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.1000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"Accept","in":"header","required":false,"description":"Preferred response media type.","schema":{"type":"string","enum":["application/json"],"default":"application/json"},"example":"application/json"}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"},"example":{"service":"seerium-x402-api","product":{"id":"whale-radar-top-10-recent-moves","name":"Polymarket Whale Radar API","method":"GET","path":"/v1/prediction/whale-radar/top-10-recent-moves","price":"$0.1000","accepts":[{"scheme":"exact","network":"eip155:8453","payTo":"0x81832eEDe3a4ad96CB3D7cA09977636D912fd3D5","price":"$0.1000"},{"scheme":"exact","network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","payTo":"2h752kAbb9z1jpdSzqMEYg9JHv6TPJ6T2BfAJMyjLFtZ","price":"$0.1000"}],"networks":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"]},"meta":{"requestId":"req_example_123","generatedAt":"2026-03-25T12:00:00.000Z","updatedAt":"2026-03-25T11:59:30.000Z","freshnessMs":30000},"data":{"trades":[{"wallet":"0x1234567890abcdef1234567890abcdef12345678","tradeId":"whale_trade_example","marketTitle":"US x Iran permanent peace deal by May 31, 2026?","marketSlug":"us-x-iran-permanent-peace-deal-by-may-31-2026","outcome":"Yes","side":"BUY","price":0.49,"size":20000,"amount":9800,"timestamp":"2026-03-25T11:58:30.000Z","profileImage":null,"name":"Example Whale","tier":"alpha","score":98}],"total":1,"updatedAt":"2026-03-25T11:59:00.000Z"}}}}},"402":{"description":"Payment Required","headers":{"PAYMENT-REQUIRED":{"description":"Base64url-encoded x402 v2 payment challenge.","schema":{"type":"string"}}}}}}},"/v1/prediction/whale-radar/randomized":{"get":{"operationId":"whale-radar-randomized","summary":"Whale Radar Randomized","description":"Polymarket whale trades API and whale radar sample for agents. Returns current tracked wallet moves for discovery and monitoring.","tags":["Market Intelligence"],"security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.1000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"Accept","in":"header","required":false,"description":"Preferred response media type.","schema":{"type":"string","enum":["application/json"],"default":"application/json"},"example":"application/json"}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"},"example":{"service":"seerium-x402-api","product":{"id":"whale-radar-randomized","name":"Whale Radar Randomized","method":"GET","path":"/v1/prediction/whale-radar/randomized","price":"$0.1000","accepts":[{"scheme":"exact","network":"eip155:8453","payTo":"0x81832eEDe3a4ad96CB3D7cA09977636D912fd3D5","price":"$0.1000"},{"scheme":"exact","network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","payTo":"2h752kAbb9z1jpdSzqMEYg9JHv6TPJ6T2BfAJMyjLFtZ","price":"$0.1000"}],"networks":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"]},"meta":{"requestId":"req_example_123","generatedAt":"2026-03-25T12:00:00.000Z","updatedAt":"2026-03-25T11:59:30.000Z","freshnessMs":30000},"data":{"trades":[{"wallet":"0x1234567890abcdef1234567890abcdef12345678","tradeId":"whale_trade_example","marketTitle":"US x Iran permanent peace deal by May 31, 2026?","marketSlug":"us-x-iran-permanent-peace-deal-by-may-31-2026","outcome":"Yes","side":"BUY","price":0.49,"size":20000,"amount":9800,"timestamp":"2026-03-25T11:58:30.000Z","profileImage":null,"name":"Example Whale","tier":"alpha","score":98}],"total":1,"updatedAt":"2026-03-25T11:59:00.000Z"}}}}},"402":{"description":"Payment Required","headers":{"PAYMENT-REQUIRED":{"description":"Base64url-encoded x402 v2 payment challenge.","schema":{"type":"string"}}}}}}},"/v1/prediction/whale-radar/by-wallet":{"get":{"operationId":"whale-radar-by-wallet","summary":"Polymarket Whale Wallet API","description":"Polymarket whale wallet API for agents. Returns whale trades, wallet metadata, tier, score, and activity for one tracked 0x wallet.","tags":["Market Intelligence"],"security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.1000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"wallet","in":"query","required":true,"description":"Required tracked 0x EVM wallet address to inspect for recent Polymarket whale trades. Use /v1/prediction/whale-radar/top-10-recent-moves first to discover active wallets.","schema":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Required tracked 0x EVM wallet address to inspect for recent Polymarket whale trades. Use /v1/prediction/whale-radar/top-10-recent-moves first to discover active wallets."},"example":"0xed107a85a4585a381e48c7f7ca4144909e7dd2e5"},{"name":"limit","in":"query","required":false,"description":"Optional maximum recent wallet trades to return.","schema":{"type":"number","minimum":1,"description":"Optional maximum recent wallet trades to return."},"example":5}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"},"example":{"service":"seerium-x402-api","product":{"id":"whale-radar-by-wallet","name":"Polymarket Whale Wallet API","method":"GET","path":"/v1/prediction/whale-radar/by-wallet","price":"$0.1000","accepts":[{"scheme":"exact","network":"eip155:8453","payTo":"0x81832eEDe3a4ad96CB3D7cA09977636D912fd3D5","price":"$0.1000"},{"scheme":"exact","network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","payTo":"2h752kAbb9z1jpdSzqMEYg9JHv6TPJ6T2BfAJMyjLFtZ","price":"$0.1000"}],"networks":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"]},"meta":{"requestId":"req_example_123","generatedAt":"2026-03-25T12:00:00.000Z","updatedAt":"2026-03-25T11:59:30.000Z","freshnessMs":30000},"data":{"wallet":{"wallet":"0x1234567890abcdef1234567890abcdef12345678","tracked":true,"active":true,"name":"Example Whale","profileImage":null,"tier":"alpha","score":98,"updatedAt":"2026-03-25T11:59:00.000Z"},"trades":[{"wallet":"0x1234567890abcdef1234567890abcdef12345678","tradeId":"whale_trade_example","marketTitle":"US x Iran permanent peace deal by May 31, 2026?","marketSlug":"us-x-iran-permanent-peace-deal-by-may-31-2026","outcome":"Yes","side":"BUY","price":0.49,"size":20000,"amount":9800,"timestamp":"2026-03-25T11:58:30.000Z","profileImage":null,"name":"Example Whale","tier":"alpha","score":98}],"total":1,"updatedAt":"2026-03-25T11:59:00.000Z"}}}}},"402":{"description":"Payment Required","headers":{"PAYMENT-REQUIRED":{"description":"Base64url-encoded x402 v2 payment challenge.","schema":{"type":"string"}}}}}}},"/v1/meme-radar/fresh-launches":{"get":{"operationId":"meme-radar-fresh-launches","summary":"Pump.fun Meme Radar Fresh Launches","description":"Pump.fun and Pump Fun Solana meme coin radar API for agents. Returns fresh-launch tokens with early traction, liquidity, short-window volume, and meme scores.","tags":["Market Intelligence"],"security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.1000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"minScore","in":"query","required":false,"description":"Optional minimum meme radar score for Pump.fun token cards.","schema":{"type":"number","minimum":0,"description":"Optional minimum meme radar score for Pump.fun token cards."}},{"name":"minLiquidity","in":"query","required":false,"description":"Optional minimum token liquidity in USD. Defaults to 1000.","schema":{"type":"number","minimum":0,"description":"Optional minimum token liquidity in USD. Defaults to 1000."}},{"name":"sort","in":"query","required":false,"description":"Optional sort for Pump.fun meme coin cards: score, volume, liquidity, or age. Defaults to score.","schema":{"type":"string","enum":["score","volume","liquidity","age"],"description":"Optional sort for Pump.fun meme coin cards: score, volume, liquidity, or age. Defaults to score."},"example":"score"},{"name":"limit","in":"query","required":false,"description":"Optional maximum cards to return for this meme radar lane.","schema":{"type":"number","minimum":1,"maximum":25,"description":"Optional maximum cards to return for this meme radar lane."},"example":3}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"},"example":{"service":"seerium-x402-api","product":{"id":"meme-radar-fresh-launches","name":"Pump.fun Meme Radar Fresh Launches","method":"GET","path":"/v1/meme-radar/fresh-launches","price":"$0.1000","accepts":[{"scheme":"exact","network":"eip155:8453","payTo":"0x81832eEDe3a4ad96CB3D7cA09977636D912fd3D5","price":"$0.1000"},{"scheme":"exact","network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","payTo":"2h752kAbb9z1jpdSzqMEYg9JHv6TPJ6T2BfAJMyjLFtZ","price":"$0.1000"}],"networks":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"]},"meta":{"requestId":"req_example_123","generatedAt":"2026-03-25T12:00:00.000Z","updatedAt":"2026-03-25T11:59:30.000Z","freshnessMs":30000},"data":{"criteria":{"minScore":null,"minLiquidity":1000,"sort":"score","limitPerCategory":3,"category":"fresh"},"lane":{"key":"fresh","title":"Fresh Launches","caption":"New tokens with early traction","strategies":["meme_fresh_launch"],"rows":[{"tokenMint":"9xQeWvG816bUx9EPf123456789ABCDEFGHijkLmno","name":"Example Meme","symbol":"MEME","strategy":"meme_fresh_launch","signalLabel":"Fresh launch","firstSeenAt":"2026-03-25T11:52:00.000Z","pairCreatedAt":"2026-03-25T11:52:00.000Z","priceUsd":0.00042,"liquidityUsd":18500,"marketCap":420000,"volumeM5":12500,"volumeH1":74000,"trustScore":82,"attentionScore":76,"memeScore":84,"status":"hot","reasons":["liquidity gate passed","volume acceleration","fresh pair activity"],"timestamp":"2026-03-25T11:59:30.000Z","url":"https://pump.fun/coin/9xQeWvG816bUx9EPf123456789ABCDEFGHijkLmno"}],"totalMatching":3}}}}}},"402":{"description":"Payment Required","headers":{"PAYMENT-REQUIRED":{"description":"Base64url-encoded x402 v2 payment challenge.","schema":{"type":"string"}}}}}}},"/v1/meme-radar/smart-flow":{"get":{"operationId":"meme-radar-smart-flow","summary":"Meme Radar Smart Flow","description":"Pump.fun and Pump Fun Solana meme coin smart-flow API for agents. Surfaces clean momentum, tracked wallet flow, liquidity, volume, and meme scores.","tags":["Market Intelligence"],"security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.1000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"minScore","in":"query","required":false,"description":"Optional minimum meme radar score for Pump.fun token cards.","schema":{"type":"number","minimum":0,"description":"Optional minimum meme radar score for Pump.fun token cards."}},{"name":"minLiquidity","in":"query","required":false,"description":"Optional minimum token liquidity in USD. Defaults to 1000.","schema":{"type":"number","minimum":0,"description":"Optional minimum token liquidity in USD. Defaults to 1000."}},{"name":"sort","in":"query","required":false,"description":"Optional sort for Pump.fun meme coin cards: score, volume, liquidity, or age. Defaults to score.","schema":{"type":"string","enum":["score","volume","liquidity","age"],"description":"Optional sort for Pump.fun meme coin cards: score, volume, liquidity, or age. Defaults to score."},"example":"score"},{"name":"limit","in":"query","required":false,"description":"Optional maximum cards to return for this meme radar lane.","schema":{"type":"number","minimum":1,"maximum":25,"description":"Optional maximum cards to return for this meme radar lane."},"example":3}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"},"example":{"service":"seerium-x402-api","product":{"id":"meme-radar-smart-flow","name":"Meme Radar Smart Flow","method":"GET","path":"/v1/meme-radar/smart-flow","price":"$0.1000","accepts":[{"scheme":"exact","network":"eip155:8453","payTo":"0x81832eEDe3a4ad96CB3D7cA09977636D912fd3D5","price":"$0.1000"},{"scheme":"exact","network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","payTo":"2h752kAbb9z1jpdSzqMEYg9JHv6TPJ6T2BfAJMyjLFtZ","price":"$0.1000"}],"networks":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"]},"meta":{"requestId":"req_example_123","generatedAt":"2026-03-25T12:00:00.000Z","updatedAt":"2026-03-25T11:59:30.000Z","freshnessMs":30000},"data":{"criteria":{"minScore":null,"minLiquidity":1000,"sort":"score","limitPerCategory":3,"category":"momentum"},"lane":{"key":"momentum","title":"Smart Flow","caption":"Clean momentum and tracked wallets","strategies":["meme_smart_flow","meme_momentum"],"rows":[{"tokenMint":"9xQeWvG816bUx9EPf123456789ABCDEFGHijkLmno","name":"Example Meme","symbol":"MEME","strategy":"meme_smart_flow","signalLabel":"Smart flow","firstSeenAt":"2026-03-25T11:52:00.000Z","pairCreatedAt":"2026-03-25T11:52:00.000Z","priceUsd":0.00042,"liquidityUsd":18500,"marketCap":420000,"volumeM5":12500,"volumeH1":74000,"trustScore":82,"attentionScore":76,"memeScore":81,"status":"hot","reasons":["liquidity gate passed","volume acceleration","fresh pair activity"],"timestamp":"2026-03-25T11:59:30.000Z","url":"https://pump.fun/coin/9xQeWvG816bUx9EPf123456789ABCDEFGHijkLmno"}],"totalMatching":3}}}}}},"402":{"description":"Payment Required","headers":{"PAYMENT-REQUIRED":{"description":"Base64url-encoded x402 v2 payment challenge.","schema":{"type":"string"}}}}}}},"/v1/meme-radar/quality-volume":{"get":{"operationId":"meme-radar-quality-volume","summary":"Meme Radar Quality Volume","description":"Pump.fun and Pump Fun Solana meme coin quality-volume API for agents. Ranks high-velocity tokens with liquidity, short-window volume, and meme scores.","tags":["Market Intelligence"],"security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.1000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"minScore","in":"query","required":false,"description":"Optional minimum meme radar score for Pump.fun token cards.","schema":{"type":"number","minimum":0,"description":"Optional minimum meme radar score for Pump.fun token cards."}},{"name":"minLiquidity","in":"query","required":false,"description":"Optional minimum token liquidity in USD. Defaults to 1000.","schema":{"type":"number","minimum":0,"description":"Optional minimum token liquidity in USD. Defaults to 1000."}},{"name":"sort","in":"query","required":false,"description":"Optional sort for Pump.fun meme coin cards: score, volume, liquidity, or age. Defaults to score.","schema":{"type":"string","enum":["score","volume","liquidity","age"],"description":"Optional sort for Pump.fun meme coin cards: score, volume, liquidity, or age. Defaults to score."},"example":"score"},{"name":"limit","in":"query","required":false,"description":"Optional maximum cards to return for this meme radar lane.","schema":{"type":"number","minimum":1,"maximum":25,"description":"Optional maximum cards to return for this meme radar lane."},"example":3}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"},"example":{"service":"seerium-x402-api","product":{"id":"meme-radar-quality-volume","name":"Meme Radar Quality Volume","method":"GET","path":"/v1/meme-radar/quality-volume","price":"$0.1000","accepts":[{"scheme":"exact","network":"eip155:8453","payTo":"0x81832eEDe3a4ad96CB3D7cA09977636D912fd3D5","price":"$0.1000"},{"scheme":"exact","network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","payTo":"2h752kAbb9z1jpdSzqMEYg9JHv6TPJ6T2BfAJMyjLFtZ","price":"$0.1000"}],"networks":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"]},"meta":{"requestId":"req_example_123","generatedAt":"2026-03-25T12:00:00.000Z","updatedAt":"2026-03-25T11:59:30.000Z","freshnessMs":30000},"data":{"criteria":{"minScore":null,"minLiquidity":1000,"sort":"score","limitPerCategory":3,"category":"volume"},"lane":{"key":"volume","title":"Quality Volume","caption":"Velocity with active flow","strategies":["meme_volume_velocity","meme_quality_watch"],"rows":[{"tokenMint":"9xQeWvG816bUx9EPf123456789ABCDEFGHijkLmno","name":"Example Meme","symbol":"MEME","strategy":"meme_volume_velocity","signalLabel":"Quality volume","firstSeenAt":"2026-03-25T11:52:00.000Z","pairCreatedAt":"2026-03-25T11:52:00.000Z","priceUsd":0.00042,"liquidityUsd":18500,"marketCap":420000,"volumeM5":12500,"volumeH1":74000,"trustScore":82,"attentionScore":76,"memeScore":79,"status":"new","reasons":["liquidity gate passed","volume acceleration","fresh pair activity"],"timestamp":"2026-03-25T11:59:30.000Z","url":"https://pump.fun/coin/9xQeWvG816bUx9EPf123456789ABCDEFGHijkLmno"}],"totalMatching":3}}}}}},"402":{"description":"Payment Required","headers":{"PAYMENT-REQUIRED":{"description":"Base64url-encoded x402 v2 payment challenge.","schema":{"type":"string"}}}}}}},"/v1/pro/screener":{"get":{"operationId":"pro-screener","summary":"Polymarket Pro Screener API","description":"Polymarket API and prediction market pro screener for agents. Ranks setups by score, confidence, liquidity, spread, volume, momentum, and mispricing.","tags":["Market Intelligence"],"security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.1000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"preset","in":"query","required":false,"description":"Optional advanced prediction-market screener preset for top movers or top setups.","schema":{"type":"string","enum":["top_movers","top_setups"],"description":"Optional advanced prediction-market screener preset for top movers or top setups."}},{"name":"source","in":"query","required":false,"description":"Optional market source filter, for example polymarket.","schema":{"type":"string","description":"Optional market source filter, for example polymarket."}},{"name":"minConfidence","in":"query","required":false,"description":"Optional minimum Seerium agent confidence score.","schema":{"type":"number","description":"Optional minimum Seerium agent confidence score."}},{"name":"minLiquidity","in":"query","required":false,"description":"Optional minimum prediction-market liquidity in USD.","schema":{"type":"number","description":"Optional minimum prediction-market liquidity in USD."}},{"name":"maxSpread","in":"query","required":false,"description":"Optional maximum order book spread.","schema":{"type":"number","description":"Optional maximum order book spread."}},{"name":"sortBy","in":"query","required":false,"description":"Optional metric to sort by, such as setupScore, liquidity, volume, momentumMedium, or mispricingScore. Defaults to setupScore.","schema":{"type":"string","description":"Optional metric to sort by, such as setupScore, liquidity, volume, momentumMedium, or mispricingScore. Defaults to setupScore."}},{"name":"sortDir","in":"query","required":false,"description":"Optional sort direction. Defaults to desc.","schema":{"type":"string","enum":["asc","desc"],"description":"Optional sort direction. Defaults to desc."}},{"name":"limit","in":"query","required":false,"description":"Optional maximum advanced screener rows to return. Defaults to 200.","schema":{"type":"number","minimum":1,"description":"Optional maximum advanced screener rows to return. Defaults to 200."},"example":3}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"},"example":{"service":"seerium-x402-api","product":{"id":"pro-screener","name":"Polymarket Pro Screener API","method":"GET","path":"/v1/pro/screener","price":"$0.1000","accepts":[{"scheme":"exact","network":"eip155:8453","payTo":"0x81832eEDe3a4ad96CB3D7cA09977636D912fd3D5","price":"$0.1000"},{"scheme":"exact","network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","payTo":"2h752kAbb9z1jpdSzqMEYg9JHv6TPJ6T2BfAJMyjLFtZ","price":"$0.1000"}],"networks":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"]},"meta":{"requestId":"req_example_123","generatedAt":"2026-03-25T12:00:00.000Z","updatedAt":"2026-03-25T11:59:30.000Z","freshnessMs":30000},"data":{"rows":[{"marketId":"1919425","marketName":"US x Iran permanent peace deal by May 31, 2026?","source":"polymarket","momentumShort":-0.005,"momentumMedium":0,"volatility":0,"volume":5768589.43,"liquidity":1201662.28,"spread":0.01,"slippageProxy":0.00912,"agentConfidence":0,"setupScore":15,"mispricingScore":0.02,"updatedAt":"2026-03-25T11:59:30.000Z"}]}}}}},"402":{"description":"Payment Required","headers":{"PAYMENT-REQUIRED":{"description":"Base64url-encoded x402 v2 payment challenge.","schema":{"type":"string"}}}}}}}}}