# Mavrin Prediction Market Rank API

> Mavrin Prediction Market Rank API is a paid API for AI agents from api.mavrin.app, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-15).

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.

## Facts

- Endpoint: GET https://api.mavrin.app/api/v1/markets/rank
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/mavrin-prediction-market-rank-api-688b9747
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_5fbpujSgZtmWJ6-gnNJtF

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

## How to call it through Zero

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

```sh
zero fetch --capability mavrin-prediction-market-rank-api-688b9747
```

Example prompt: 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.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

Kalshi and Polymarket US research data for agents. Free market search and coverage, odds from 0.004 USDC, and x402 payments on Base.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "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"
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/mavrin-prediction-market-rank-api-688b9747/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.mavrin.app](https://www.zero.xyz/host/api.mavrin.app/llms.txt)