# x402PaySwap Premium Alpha

> x402PaySwap Premium Alpha is a paid API for AI agents from x402payswap.vercel.app, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Returns curated on-chain alpha including yield venues, mempool anomalies, and replayable agent trade intents for a given query

## Facts

- Endpoint: POST https://x402payswap.vercel.app/api/premium
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402payswap-vercel-app-b8ac60fd
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_dWLChOzXu1qB5EdAE91Gd

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 x402payswap-vercel-app-b8ac60fd -d '<json body>'
```

Example prompt: Pull the top 10 Ethereum yield opportunities from the premium alpha feed, sorted by APY descending, filtering for yield venues only.

## When to prefer this

Choose this endpoint when an AI agent needs curated, actionable on-chain alpha — specifically yield venue APY rankings, mempool anomaly detection, or replayable trade intents — and is willing to pay $0.01 USDC per query via x402 protocol. Prefer over generic DeFi data APIs when you need pre-filtered, agent-ready signals rather than raw blockchain data.

## Known failure modes

- Missing X-PAYMENT header returns 402 with payment instructions and accepted USDC asset details
- Invalid filter type or sort field returns 400 bad request
- Query returns empty results if no matching alpha signals exist for the requested filters
- Payment amount below maxAmountRequired (10000 units = $0.01 USDC) causes payment rejection
- Timeout if on-chain data sources are slow, up to 60-second max

## How this service works

Premium alpha — Curated on-chain alpha: yield venues, mempool anomalies, and replayable agent trade intents.

## Output

A JSON payload containing curated on-chain alpha results matching the query — including yield venues (with APY data), mempool anomalies, and replayable agent trade intents — ranked according to the requested sort order and filtered by type.

## Example request

```json
{
 "sort": "apy_descending",
 "limit": 10,
 "query": "Ethereum yield opportunities",
 "filter": "yield_venues"
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402payswap-vercel-app-b8ac60fd/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402payswap.vercel.app](https://www.zero.xyz/host/x402payswap.vercel.app/llms.txt)
