{"uid":"cap_HufIYOWNlKiqwoZtxPiov","slug":"seerium-ranked-opportunities-api-59025a99","name":"Seerium Ranked Opportunities API","description":"Crypto and prediction market intelligence through x402.","url":"https://api.seerium.xyz/v1/opportunities/ranked","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"limit":{"type":"number","minimum":1,"description":"Optional maximum ranked opportunities to return. Defaults to 25."},"source":{"enum":["all","prediction","dex"],"type":"string","description":"Optional opportunity source: Polymarket prediction markets, Dex markets, or all. Defaults to all."},"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."},"budgetUsd":{"type":"number","minimum":1,"description":"Optional maximum notional budget in USD."},"maxSpread":{"type":"number","minimum":0,"description":"Optional maximum acceptable order book spread."},"allowShort":{"type":"boolean","description":"Optional flag to include opportunities requiring short exposure."},"riskProfile":{"enum":["conservative","balanced","aggressive"],"type":"string","description":"Optional risk profile used to rank opportunities. Defaults to balanced."},"horizonHours":{"type":"number","minimum":0,"description":"Optional maximum hours to market close."},"minLiquidity":{"type":"number","minimum":0,"description":"Optional minimum market or leg liquidity in USD."}}},"responseSchema":{"type":"json","example":{"data":{"rows":[{"fit":{"budgetOk":true,"spreadOk":true,"horizonOk":true,"liquidityOk":true},"edge":0.035,"legs":[{"side":"BUY","size":500,"price":0.49,"reason":"spread and liquidity screen passed","outcome":"Yes","tokenId":"poly_yes_token","marketSlug":"us-x-iran-permanent-peace-deal-by-may-31-2026"}],"rank":1,"score":81.4,"source":"prediction","reasons":["edge=0.035","score=81.4","avgAgentConfidence=72"],"strategy":"mispricing_spread","riskLevel":"medium","description":"Strategy-derived opportunity from cached market snapshots.","horizonHours":48.2,"maxLegSpread":0.02,"minLiquidity":54000,"requiresShort":false,"avgAgentConfidence":72,"estimatedNotionalUsd":480}],"criteria":{"limit":3,"source":"all","minEdge":null,"category":null,"budgetUsd":null,"maxSpread":null,"allowShort":true,"riskProfile":"balanced","horizonHours":null,"minLiquidity":null},"returned":1,"warnings":[],"totalCandidates":42},"meta":{"requestId":"req_example_123","updatedAt":"2026-03-25T11:59:30.000Z","freshnessMs":30000,"generatedAt":"2026-03-25T12:00:00.000Z"},"product":{"id":"ranked-opportunities","name":"Ranked Market Opportunities API","path":"/v1/opportunities/ranked","price":"$0.1000","method":"POST","accepts":[{"payTo":"0x81832eEDe3a4ad96CB3D7cA09977636D912fd3D5","price":"$0.1000","scheme":"exact","network":"eip155:8453"},{"payTo":"2h752kAbb9z1jpdSzqMEYg9JHv6TPJ6T2BfAJMyjLFtZ","price":"$0.1000","scheme":"exact","network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"}],"networks":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"]},"service":"seerium-x402-api"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.1","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.1/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_E3rTVUOYmkBE5Aflf-MNh","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.1","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Ranks and filters Polymarket prediction market and DEX trading opportunities by budget, liquidity, spread, time horizon, and risk profile","exampleAgentPrompt":"Find me the top 10 ranked trading opportunities across both Polymarket and DEX markets with a balanced risk profile, a budget of $200, minimum liquidity of $5000, and only include ones closing within the next 48 hours — no short exposure.","exampleUseCases":[{"title":"Conservative prediction market plays under budget","prompt":"Show me the best Polymarket opportunities I can trade with $300 or less — keep it conservative, I don't want anything too risky, and only show me markets that still have at least 3 days before they close. Make sure there's enough liquidity so I can actually get in and out easily."},{"title":"Top DEX signals by edge and spread","prompt":"Rank the top DEX trading opportunities for me right now, sorted by edge — I want at least a 5% edge and tight spreads only. My budget is around $1000 and I'm okay with moderate risk, but skip anything with thin liquidity."},{"title":"Polymarket crypto opportunities closing soon","prompt":"Find me the highest-ranked Polymarket opportunities in the crypto category that are closing within the next 24 hours. I've got about $500 to work with, I want decent liquidity, and show me the edge estimate for each one so I can decide where to put my money."}],"resultDescription":"Returns a ranked list of up to N trading opportunities (prediction market or DEX) scored and sorted by edge, liquidity, spread, horizon, and risk profile, with metadata per opportunity including market question or strategy, edge estimate, liquidity depth, spread, and time to close.","failureModes":["Invalid enum value for source or riskProfile returns 400 validation error","budgetUsd below minimum of 1 returns schema error","No opportunities matching the given filters returns empty ranked list","Service unavailable or upstream market data outage returns 5xx error","minEdge or maxSpread values outside feasible range return empty results or validation error"],"whenToPreferThis":"Use this endpoint when you need a pre-ranked, multi-signal view of actionable trading opportunities across prediction markets and DEX, especially when filtering by budget constraints, risk tolerance, liquidity minimums, and time horizon — as opposed to raw price feeds, order book snapshots, or unranked market lists.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:35:11.580Z","isFirstParty":false}