{
 "openapi": "3.1.0",
 "info": {
  "title": "GamePulse API",
  "description": "Global gaming intelligence API. AI-synthesized meta analysis, tier lists, gaming hardware recommendations, PC specs optimization, esports match predictions, TCG card valuations (MTG, Pokémon, Yu-Gi-Oh), game deal aggregation, subscription value analysis, and gaming setup guides. Covers 1,000+ games, all major platforms, and global esports tournaments. Fanatical, Humble Bundle, TCGPlayer/CardMarket (EU), Amazon gaming gear, and Xbox/PS5/Nintendo affiliate links included. Tournament travel via Expedia affiliate included for esports events. All endpoints support any language via ?lang=. Pricing: $0.05–$0.15 USDC/call via x402 micropayment.",
  "version": "1.2.0",
  "contact": {
   "url": "https://gamepulse-zeta.vercel.app"
  }
 },
 "servers": [
  {
   "url": "https://gamepulse-zeta.vercel.app"
  }
 ],
 "components": {
  "securitySchemes": {
   "x402": {
    "type": "apiKey",
    "in": "header",
    "name": "PAYMENT-SIGNATURE",
    "description": "x402 payment signature. Send without to receive 402 with payment requirements. Sign and retry."
   }
  }
 },
 "security": [
  {
   "x402": []
  }
 ],
 "paths": {
  "/api/gaming/deals": {
   "get": {
    "summary": "Game deals",
    "description": "Best game deals across Steam, Epic, GOG, Humble, and Fanatical with buy/wait verdicts.",
    "operationId": "gamingDeals",
    "parameters": [
     {
      "name": "genre",
      "in": "query",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "e.g. rpg, action, strategy, fps"
     }
    ],
    "responses": {
     "200": {
      "description": "Deals brief"
     },
     "402": {
      "description": "Payment required"
     }
    },
    "x-price-usd": 0.05,
    "x-agent-use-case": "on-demand",
    "x-agent-chaining": "Game deal aggregator — Fanatical + Humble Bundle affiliates; highest purchase intent endpoint"
   }
  },
  "/api/gaming/worth-it": {
   "get": {
    "summary": "Buy or wait verdict",
    "description": "Price history, reviews, completion time, and a clear buy/wait verdict for any game.",
    "operationId": "gamingWorthIt",
    "parameters": [
     {
      "name": "game",
      "in": "query",
      "required": true,
      "schema": {
       "type": "string"
      },
      "description": "Game title or slug e.g. elden-ring, cyberpunk-2077"
     }
    ],
    "responses": {
     "200": {
      "description": "Worth-it verdict"
     },
     "402": {
      "description": "Payment required"
     }
    },
    "x-price-usd": 0.08,
    "x-agent-use-case": "on-demand",
    "x-agent-chaining": "Game value analysis — hours-per-dollar metric; pairs with /api/gaming/deals for purchase decision"
   }
  },
  "/api/gaming/meta": {
   "get": {
    "summary": "Game meta analysis",
    "description": "Current meta, tier lists, and patch notes synthesis for any competitive game.",
    "operationId": "gamingMeta",
    "parameters": [
     {
      "name": "game",
      "in": "query",
      "required": true,
      "schema": {
       "type": "string"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "Meta analysis"
     },
     "402": {
      "description": "Payment required"
     }
    },
    "x-price-usd": 0.08,
    "x-agent-use-case": "on-demand",
    "x-agent-chaining": "Meta analysis + tier lists — gaming gear affiliate links included; start here for any competitive game query"
   }
  },
  "/api/gaming/trending": {
   "get": {
    "summary": "Trending games",
    "description": "What's exploding on Steam right now — top games by 2-week player count with explanations of why they're trending.",
    "operationId": "gamingTrending",
    "responses": {
     "200": {
      "description": "Trending brief"
     },
     "402": {
      "description": "Payment required"
     }
    },
    "x-price-usd": 0.05,
    "x-agent-use-case": "on-demand",
    "x-agent-chaining": "Trending games and viral moments — highest discovery value; pairs with FanPulse for fandom overlap"
   }
  },
  "/api/gaming/setup": {
   "get": {
    "summary": "PC gaming setup",
    "description": "Optimized PC gaming build recommendations for any budget with specific components and Amazon links.",
    "operationId": "gamingSetup",
    "parameters": [
     {
      "name": "budget",
      "in": "query",
      "required": false,
      "schema": {
       "type": "integer",
       "default": 1500
      },
      "description": "Budget in USD ($200-$10,000)"
     }
    ],
    "responses": {
     "200": {
      "description": "PC build recommendations"
     },
     "402": {
      "description": "Payment required"
     }
    },
    "x-price-usd": 0.1,
    "x-agent-use-case": "on-demand",
    "x-agent-chaining": "PC/console setup recommendations — Amazon hardware affiliate links; chain with /api/gaming/specs for compatibility"
   }
  },
  "/api/cards/price": {
   "get": {
    "summary": "Card price analysis",
    "description": "Market value, trend, PSA population, investment grade, and buy/sell/hold recommendation for any trading card.",
    "operationId": "cardsPrice",
    "parameters": [
     {
      "name": "card",
      "in": "query",
      "required": true,
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "game",
      "in": "query",
      "required": false,
      "schema": {
       "type": "string",
       "enum": [
        "pokemon",
        "mtg",
        "yugioh"
       ],
       "default": "pokemon"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "Card price analysis"
     },
     "402": {
      "description": "Payment required"
     }
    },
    "x-price-usd": 0.08,
    "x-agent-use-case": "on-demand",
    "x-agent-chaining": "TCG card prices — TCGPlayer + CardMarket (EU) affiliate links; chain with /api/cards/invest for investment context"
   }
  },
  "/api/cards/invest": {
   "get": {
    "summary": "Set investment analysis",
    "description": "Sleepers, value plays, and overvalued traps within a specific card set.",
    "operationId": "cardsInvest",
    "parameters": [
     {
      "name": "set",
      "in": "query",
      "required": true,
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "game",
      "in": "query",
      "required": false,
      "schema": {
       "type": "string",
       "default": "pokemon"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "Investment analysis"
     },
     "402": {
      "description": "Payment required"
     }
    },
    "x-price-usd": 0.12,
    "x-agent-use-case": "on-demand",
    "x-agent-chaining": "TCG card investment analysis — chain after /api/cards/price; pairs with CollectablesPulse for portfolio view"
   }
  },
  "/api/cards/deal": {
   "get": {
    "summary": "eBay card deal finder",
    "description": "eBay sold vs listed gap analysis — identifies underpriced listings by comparing average sold prices to active asking prices.",
    "operationId": "cardsDeal",
    "parameters": [
     {
      "name": "card",
      "in": "query",
      "required": false,
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "game",
      "in": "query",
      "required": false,
      "schema": {
       "type": "string",
       "default": "pokemon"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "Deal analysis"
     },
     "402": {
      "description": "Payment required"
     }
    },
    "x-price-usd": 0.15,
    "x-agent-use-case": "on-demand"
   }
  },
  "/api/esports/matches": {
   "get": {
    "summary": "Esports matches",
    "description": "Today's match schedule with team context, tournament stakes, and player to watch.",
    "operationId": "esportsMatches",
    "parameters": [
     {
      "name": "game",
      "in": "query",
      "required": false,
      "schema": {
       "type": "string",
       "enum": [
        "lol",
        "valorant",
        "cs2",
        "dota2",
        "overwatch",
        "rocket-league"
       ],
       "default": "valorant"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "Match schedule"
     },
     "402": {
      "description": "Payment required"
     }
    },
    "x-price-usd": 0.1,
    "x-agent-use-case": "on-demand",
    "x-agent-chaining": "Esports match preview + predictions — pairs with StatEdge for betting context"
   }
  },
  "/api/esports/team": {
   "get": {
    "summary": "Esports team profile",
    "description": "Team form, roster, recent results, strengths/weaknesses, and upcoming matches.",
    "operationId": "esportsTeam",
    "parameters": [
     {
      "name": "name",
      "in": "query",
      "required": true,
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "game",
      "in": "query",
      "required": false,
      "schema": {
       "type": "string",
       "default": "lol"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "Team profile"
     },
     "402": {
      "description": "Payment required"
     }
    },
    "x-price-usd": 0.08,
    "x-agent-use-case": "on-demand"
   }
  },
  "/api/esports/betting": {
   "get": {
    "summary": "Esports betting analysis",
    "description": "Pre-match analysis with betting angles, confidence ratings, head-to-head context, and risk factors.",
    "operationId": "esportsBetting",
    "parameters": [
     {
      "name": "game",
      "in": "query",
      "required": false,
      "schema": {
       "type": "string",
       "default": "lol"
      }
     },
     {
      "name": "match",
      "in": "query",
      "required": false,
      "schema": {
       "type": "string"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "Betting analysis"
     },
     "402": {
      "description": "Payment required"
     }
    },
    "x-price-usd": 0.1,
    "x-agent-use-case": "on-demand"
   }
  },
  "/api/esports/tournament": {
   "get": {
    "summary": "Tournament breakdown",
    "description": "Full tournament breakdown — teams, bracket, storylines, predictions, and viewing guide.",
    "operationId": "esportsTournament",
    "parameters": [
     {
      "name": "name",
      "in": "query",
      "required": true,
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "game",
      "in": "query",
      "required": false,
      "schema": {
       "type": "string",
       "default": "lol"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "Tournament breakdown"
     },
     "402": {
      "description": "Payment required"
     }
    },
    "x-price-usd": 0.1,
    "x-agent-use-case": "on-demand"
   }
  },
  "/api/cards/portfolio": {
   "get": {
    "summary": "Trading card portfolio valuation",
    "description": "Current market value across Pokemon, MTG, sports cards, and more.",
    "parameters": [
     {
      "name": "cards",
      "in": "query",
      "required": true,
      "schema": {
       "type": "string"
      },
      "description": "Comma-separated card list"
     },
     {
      "name": "lang",
      "in": "query",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "Response language (default en)"
     }
    ],
    "responses": {
     "200": {
      "description": "Trading card portfolio valuation"
     },
     "402": {
      "description": "Payment required"
     }
    }
   }
  },
  "/api/gaming/achievements": {
   "get": {
    "summary": "Achievement hunting guide",
    "description": "Trophy and achievement tips for 100% completion of any game.",
    "parameters": [
     {
      "name": "game",
      "in": "query",
      "required": true,
      "schema": {
       "type": "string"
      },
      "description": "Game title"
     },
     {
      "name": "achievement",
      "in": "query",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "Specific achievement (optional)"
     },
     {
      "name": "lang",
      "in": "query",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "Response language (default en)"
     }
    ],
    "responses": {
     "200": {
      "description": "Achievement hunting guide"
     },
     "402": {
      "description": "Payment required"
     }
    }
   }
  },
  "/api/gaming/specs": {
   "get": {
    "summary": "PC compatibility check",
    "description": "Whether a PC can run a game, with expected settings and FPS.",
    "parameters": [
     {
      "name": "game",
      "in": "query",
      "required": true,
      "schema": {
       "type": "string"
      },
      "description": "Game title"
     },
     {
      "name": "cpu",
      "in": "query",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "CPU model"
     },
     {
      "name": "gpu",
      "in": "query",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "GPU model"
     },
     {
      "name": "ram",
      "in": "query",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "RAM (GB)"
     },
     {
      "name": "lang",
      "in": "query",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "Response language (default en)"
     }
    ],
    "responses": {
     "200": {
      "description": "PC compatibility check"
     },
     "402": {
      "description": "Payment required"
     }
    }
   }
  },
  "/api/gaming/subscription": {
   "get": {
    "summary": "Gaming subscription value calculator",
    "description": "Compares Game Pass vs PS Plus vs EA Play to find the best value.",
    "parameters": [
     {
      "name": "games",
      "in": "query",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "Comma-separated games you play"
     },
     {
      "name": "lang",
      "in": "query",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "Response language (default en)"
     }
    ],
    "responses": {
     "200": {
      "description": "Gaming subscription value calculator"
     },
     "402": {
      "description": "Payment required"
     }
    }
   }
  },
  "/api/gaming/time": {
   "get": {
    "summary": "Game completion time estimator",
    "description": "Main-story, completionist, and full playtime estimates for any game.",
    "parameters": [
     {
      "name": "game",
      "in": "query",
      "required": true,
      "schema": {
       "type": "string"
      },
      "description": "Game title"
     },
     {
      "name": "lang",
      "in": "query",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "Response language (default en)"
     }
    ],
    "responses": {
     "200": {
      "description": "Game completion time estimator"
     },
     "402": {
      "description": "Payment required"
     }
    }
   }
  }
 }
}