# PunkPredictor Top Realtime Deals

> PunkPredictor Top Realtime Deals is a paid API for AI agents from api.punkpredictor.xyz, paid per call via x402, $50/call, status unknown (last checked 2026-09-13).

Returns the top CryptoPunks currently listed below their fair market value in real time, ranked by discount percentage

## Facts

- Endpoint: GET https://api.punkpredictor.xyz/agents/v2/top-realtime
- Price: $50/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/punkpredictor-top-realtime-deals-6d9e4eb1
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_qd2YYCHEiMOEXk5glcm8P

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 punkpredictor-top-realtime-deals-6d9e4eb1
```

Example prompt: Show me the top 10 CryptoPunks right now that are listed the furthest below their fair value — I want to see the biggest real-time deals with their discount percentages.

## When to prefer this

Choose this endpoint when you need live, up-to-the-moment CryptoPunk deal data rather than delayed snapshots. Prefer this over the 'Top delayed deals' sibling when timing is critical and you need the most current listings. Ideal for automated trading agents, deal-alert bots, or users actively monitoring the CryptoPunks market for arbitrage or value purchases.

## Known failure modes

- No punks currently listed at a discount — empty results array
- limit parameter out of range (must be 1–100) — validation error
- Payment not received or invalid — 402 Payment Required
- Service temporarily unavailable — 503 or timeout
- Rate limiting if too many requests in succession

## How this service works

Top realtime deals

## Output

A JSON array of CryptoPunk listings with each punk's ID, its algorithmically determined fair price in ETH, the current listed price in ETH, and the percentage discount to fair value — sorted by best deals first. Returns up to the requested limit (max 100).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "limit": {
       "type": "integer",
       "maximum": 100,
       "minimum": 1
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "mode": "realtime",
  "count": 1,
  "results": [
   {
    "id_punk": 5822,
    "fair_price_eth": 28.74,
    "listed_price_eth": 26,
    "discount_to_fair_pct": 9.53
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/punkpredictor-top-realtime-deals-6d9e4eb1/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.punkpredictor.xyz](https://www.zero.xyz/host/api.punkpredictor.xyz/llms.txt)