# Oracle TCG Trending Cards Feed

> Oracle TCG Trending Cards Feed is a paid API for AI agents from oracle.the-undesirables.com, paid per call via x402, $0.025/call, status unknown (last checked 2026-09-15).

Returns the top trading cards ranked by market activity (30-day sales volume, views, price velocity) across up to 25 supported TCG games

## Facts

- Endpoint: GET https://oracle.the-undesirables.com/api/v1/trending
- Price: $0.025/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/oracle-tcg-trending-cards-feed-3c65684f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_tJNl9sLcVUPLCofVPYx-1

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 oracle-tcg-trending-cards-feed-3c65684f
```

Example prompt: Show me the top 20 trending Magic: The Gathering cards right now with at least $5 minimum price — I want to spot cards gaining momentum before they spike.

## When to prefer this

Use this endpoint when an agent needs a real-time snapshot of market momentum across TCG games — especially for autonomous buy/sell agents tracking which cards are trending up, identifying emerging opportunities before price spikes, or building watchlists. Prefer this over the daily snapshot endpoint when you need live momentum data rather than end-of-day summaries, and over the portfolio optimizer when you want raw discovery rather than optimization of existing holdings.

## Known failure modes

- Invalid game name returns empty results or 400 error
- limit out of range (outside 1-100) returns validation error
- min_price set too high returns empty card list
- Service unavailable returns non-200 status with error status field
- Payment required (402) if x402 payment header not included

## How this service works

Trending Cards Feed: returns the top trading cards by market activity (30-day sales volume, views, price velocity). Covers all 25 supported TCG games. Useful for autonomous buy/sell agents tracking market momentum and identifying emerging opportunities.

## Output

A ranked list of trading cards sorted by market activity metrics including 30-day sales volume, view counts, and price velocity. Each entry includes card identity, game, current price, and momentum indicators. Covers any of the 25 supported TCG games based on filters applied.

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "results": 50,
   "trending": []
  },
  "tool": "trending_cards",
  "status": "ok"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/oracle-tcg-trending-cards-feed-3c65684f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from oracle.the-undesirables.com](https://www.zero.xyz/host/oracle.the-undesirables.com/llms.txt)