{"uid":"cap_5fbpujSgZtmWJ6-gnNJtF","slug":"mavrin-prediction-market-rank-api-688b9747","name":"Mavrin Prediction Market Rank API","description":"Kalshi and Polymarket US research data for agents. Free market search and coverage, odds from 0.004 USDC, and x402 payments on Base.","url":"https://api.mavrin.app/api/v1/markets/rank","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"properties":{"type":"string"}}},"responseSchema":{"type":"json","example":{"count":200,"markets":[{"worth":9.44,"series":"KXZEC15M","failure":100,"category":"Crypto","top_failure_risk":"tail_asymmetry","top_worth_driver":"settlement_observability"}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","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.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_K6s3daevL0HLMl-Ipgtsv","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns ranked prediction market opportunities from Kalshi and Polymarket, scored by worth and failure risk, to help AI agents identify the best markets to trade or monitor.","exampleAgentPrompt":"Pull up the top-ranked prediction markets from Mavrin right now — I want to see which ones have the best worth scores and lowest failure risk, especially in the crypto category.","exampleUseCases":[{"title":"Finding best crypto prediction markets","prompt":"Show me the highest-ranked crypto prediction markets available on Kalshi and Polymarket right now, sorted by worth score so I can decide where to place my next trade."},{"title":"Avoiding high-risk market bets","prompt":"I want to see which prediction markets have tail asymmetry or high failure risk so I can steer clear of those and only bet on the safest, most reliable ones."},{"title":"Building a market watchlist for an agent","prompt":"Give me the top 200 ranked prediction markets with their worth drivers and failure risk categories so I can build a watchlist for my trading bot to monitor automatically."}],"resultDescription":"A JSON object containing a count of markets and an array of ranked market objects, each with a worth score, series ID, failure score, category label, top failure risk type, and top worth driver — enabling agents to identify which markets are most valuable or risky to trade.","failureModes":["Invalid or unrecognized properties filter returns empty or error response","Payment not completed via x402/Base results in 402 Payment Required","Rate limiting or quota exceeded returns 429","Malformed request parameters return 400 Bad Request","Market data temporarily unavailable returns 503"],"whenToPreferThis":"Use this endpoint when you need a ranked, scored view of available prediction markets rather than raw market listings — specifically when you want to compare markets by expected worth and failure risk across Kalshi and Polymarket simultaneously. Prefer this over raw search endpoints when the agent needs to prioritize which markets to trade or monitor, not just find markets by keyword.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:34:08.178Z","isFirstParty":false}