# Liquid Agent: Polymarket ETH 5m Price to Beat

> Liquid Agent: Polymarket ETH 5m Price to Beat is a paid API for AI agents from api.liquidagent.ai, paid per call via x402, $0.004/call, status unknown (last checked 2026-10-12).

Returns the official Chainlink TWAP price-to-beat, live ETH price, distance, seconds remaining, token IDs, and Polymarket market prices for the current (or a past) 5-minute ETH Up/Down window.

## Facts

- Endpoint: GET https://api.liquidagent.ai/v1/polymarket/eth-5m?utm_source=zero.xyz
- Price: $0.004/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/liquid-agent-polymarket-eth-5m-price-to-beat-6d9da5c2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_l6ksvGBXdSeTdE9iYmjuc

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 liquid-agent-polymarket-eth-5m-price-to-beat-6d9da5c2
```

Example prompt: What's the official Chainlink price-to-beat for the current Polymarket ETH 5-minute Up/Down market, and how far is the live ETH price from it right now?

## When to prefer this

Use this endpoint when you need the authoritative Chainlink TWAP price-to-beat for Polymarket ETH 5-minute Up/Down markets — especially when you need it matched to Polymarket's own settlement logic to the cent. Prefer this over scraping Polymarket directly or fetching raw Chainlink data separately, since it combines both into a single call with distance and time-remaining context. Also ideal for historical settlement verification via the ?start= parameter.

## Known failure modes

- Invalid or malformed unix timestamp returns an error or empty result
- Querying a future window start time returns no data
- Market not yet open for the requested window
- Chainlink oracle data temporarily unavailable causing stale prices
- Network or payment (x402) failure preventing data return

## How this service works

Polymarket ETH 5m Up/Down in one call: the OFFICIAL price to beat (the 60 s Chainlink TWAP before the window, matched to the cent against Polymarket's results), the live Chainlink price and its distance from the price to beat, seconds left, token ids and the market's own prices. ?start=<unix> returns a past window's official settle and outcome. $0.002 USDC. Data, not financial advice.

## Output

A JSON object containing: the market slug, asset (ETH), timeframe (5m), seconds left in the window, market status (live or settled), live Chainlink ETH price, the official price-to-beat (60s Chainlink TWAP from before the window), distance between live price and price-to-beat, and Polymarket market prices for Up and Down tokens. For historical queries (with ?start=), also returns the official settled price and outcome.

## Request schema (JSON Schema)

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

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "market": {
   "slug": "eth-updown-5m-1790652300",
   "asset": "ETH",
   "timeframe": "5m",
   "secondsLeft": 120
  },
  "status": "live",
  "distance": 55.93,
  "chainlink": {
   "price": 83140.29
  },
  "priceToBeat": 83084.36,
  "marketPrices": {
   "up": 0.925,
   "down": 0.075
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/liquid-agent-polymarket-eth-5m-price-to-beat-6d9da5c2/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.liquidagent.ai](https://www.zero.xyz/host/api.liquidagent.ai/llms.txt)