# GamePulse

> AI-synthesized gaming, collectables, and esports intelligence. Game deals, meta analysis, trading card pricing, eBay arbitrage, and esports match data — via x402 micropayments on Base.

## What This Is

GamePulse is a pay-per-query API covering three domains:
1. **Gaming** — deals, buy/wait verdicts, competitive meta, trending games, PC build recommendations, and mobile gaming (iOS/Android global launches, gacha game tier lists, Asian market releases via TapTap)
2. **Collectables** — Pokemon, MTG, Yu-Gi-Oh card pricing; Asian TCGs (One Piece, Cardfight Vanguard, Dragon Ball Super); set investment analysis; eBay and TCGPlayer arbitrage
3. **Esports** — match schedules, team profiles, betting analysis, tournament breakdowns; global coverage including KR/JP/CN regions (League of Legends, Valorant, Dota 2, PUBG Mobile)

Data sources: CheapShark (game deals), Steam API (player counts), IGDB (game database), Scryfall (MTG prices), eBay Finding API (sold/active listings), PandaScore (esports), TapTap (mobile/Asian gaming), Tavily (real-time news).

## Payment

All endpoints require x402 micropayment (USDC on Base mainnet).
Protocol: x402 | Network: eip155:8453 | Asset: USDC
Payment address: 0x50ab2018c06c6E4eAA9BA52057Eb55eD284912fc

## Endpoints

GET /api/gaming/deals?genre={genre}
- Returns: ranked game deals across Steam/Epic/GOG/Humble with buy/wait verdicts, hours-of-content value, and hidden gems
- Price: $0.05

GET /api/gaming/worth-it?game={game-slug}
- Returns: buy or wait verdict — current price, all-time-low, price trend, next likely sale, reasons to buy/wait
- Price: $0.08

GET /api/gaming/meta?game={game}
- Returns: current meta tier list, recent patch changes, pro play trends, best picks for ranked
- Price: $0.08

GET /api/gaming/trending
- Returns: top games by 2-week Steam player count with viral context — what's trending and why
- Price: $0.05

GET /api/gaming/setup?budget={usd}
- Returns: specific PC gaming build for budget — GPU, CPU, RAM, storage with Amazon links and performance targets
- Price: $0.10

GET /api/cards/price?card={name}&game={pokemon|mtg|yugioh}
- Returns: market value (raw and graded), PSA population, price trend, investment grade, buy/sell/hold
- Price: $0.10

GET /api/cards/invest?set={set-name}&game={game}
- Returns: sleepers, value plays, and overvalued traps within a set — sealed product angle, reprint risk
- Price: $0.15

GET /api/cards/deal?card={name}&game={game}
- Returns: eBay sold vs listed gap analysis — avg sold price, avg asking price, gap %, underpriced listings
- Price: $0.15

GET /api/esports/matches?game={lol|valorant|cs2|dota2|overwatch|rocket-league}
- Returns: today's live and upcoming matches with tournament context and player-to-watch
- Price: $0.05

GET /api/esports/team?name={team}&game={game}
- Returns: team form, roster with roles, recent results, strengths/weaknesses, upcoming schedule
- Price: $0.08

GET /api/esports/betting?game={game}&match={match-id}
- Returns: pre-match betting angles with confidence ratings, h2h context, risk factors
- Price: $0.10

GET /api/esports/tournament?name={tournament}&game={game}
- Returns: full tournament breakdown — teams, bracket status, storylines, predictions, viewing guide
- Price: $0.10

## Discovery

- OpenAPI spec: https://gamepulse-zeta.vercel.app/openapi.json
- Agent discovery: https://gamepulse-zeta.vercel.app/.well-known/agent.json

## Notes for AI Agents

- All endpoints return structured JSON
- eBay data (cards/deal) requires EBAY_APP_ID — graceful degradation to news synthesis without it
- IGDB data (gaming/worth-it) requires IGDB credentials — degrades gracefully
- Scryfall data is MTG-only; Pokemon/YGO card pricing is synthesized from news
- Disclaimer appended automatically to every response