{
  "openapi": "3.1.0",
  "info": {
    "title": "x402 Alpha Hub",
    "version": "1.0.0",
    "description": "India stock market, Solana token security scanning, Google Ad transparency, and AI Overviews. 10 paid endpoints for AI agents and researchers.",
    "x-guidance": "All endpoints require POST with JSON body. Payment via x402 protocol (USDC on Base). Send request, receive 402 with payment options, pay via wallet, retry with x-payment header.",
    "contact": { "email": "sna4an@users.noreply.github.com" }
  },
  "servers": [{ "url": "https://x402-alpha-hub.vercel.app" }],
  "paths": {
    "/api/india/trending": {
      "post": {
        "operationId": "indiaTrending",
        "summary": "India stock market top gainers & losers",
        "tags": ["India Market"],
        "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.050000" }, "protocols": [{ "x402": {} }] },
        "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": {} } } } },
        "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object" } } } } } }, "402": { "description": "Payment Required" } }
      }
    },
    "/api/india/stock": {
      "post": {
        "operationId": "indiaStock",
        "summary": "India stock details by name",
        "tags": ["India Market"],
        "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.050000" }, "protocols": [{ "x402": {} }] },
        "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string", "description": "Stock name, e.g. RELIANCE" } }, "required": ["name"] } } } },
        "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object" } } } } } }, "402": { "description": "Payment Required" } }
      }
    },
    "/api/india/corporate-actions": {
      "post": {
        "operationId": "indiaCorporateActions",
        "summary": "Corporate actions: dividends, splits, bonuses",
        "tags": ["India Market"],
        "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.050000" }, "protocols": [{ "x402": {} }] },
        "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "stock_name": { "type": "string", "description": "Stock name, e.g. TCS" } }, "required": ["stock_name"] } } } },
        "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object" } } } } } }, "402": { "description": "Payment Required" } }
      }
    },
    "/api/india/mutual-funds": {
      "post": {
        "operationId": "indiaMutualFunds",
        "summary": "India mutual fund data by category",
        "tags": ["India Market"],
        "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.050000" }, "protocols": [{ "x402": {} }] },
        "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": {} } } } },
        "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object" } } } } } }, "402": { "description": "Payment Required" } }
      }
    },
    "/api/india/ipo": {
      "post": {
        "operationId": "indiaIPO",
        "summary": "Upcoming and past IPO listings",
        "tags": ["India Market"],
        "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.050000" }, "protocols": [{ "x402": {} }] },
        "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": {} } } } },
        "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object" } } } } } }, "402": { "description": "Payment Required" } }
      }
    },
    "/api/india/commodities": {
      "post": {
        "operationId": "indiaCommodities",
        "summary": "MCX/NCDEX commodity market data",
        "tags": ["India Market"],
        "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.050000" }, "protocols": [{ "x402": {} }] },
        "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": {} } } } },
        "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object" } } } } } }, "402": { "description": "Payment Required" } }
      }
    },
    "/api/india/price-shockers": {
      "post": {
        "operationId": "indiaPriceShockers",
        "summary": "BSE & NSE price shockers",
        "tags": ["India Market"],
        "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.050000" }, "protocols": [{ "x402": {} }] },
        "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": {} } } } },
        "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object" } } } } } }, "402": { "description": "Payment Required" } }
      }
    },
    "/api/solana/token-scan": {
      "post": {
        "operationId": "solanaTokenScan",
        "summary": "Solana token risk analysis & safety scan",
        "tags": ["Solana Security"],
        "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.100000" }, "protocols": [{ "x402": {} }] },
        "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "address": { "type": "string", "description": "Solana token address to scan" } }, "required": ["address"] } } } },
        "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object" } } } } } }, "402": { "description": "Payment Required" } }
      }
    },
    "/api/google/ads": {
      "post": {
        "operationId": "googleAds",
        "summary": "Google Ad Transparency library data",
        "tags": ["Google Intel"],
        "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.050000" }, "protocols": [{ "x402": {} }] },
        "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "domain": { "type": "string", "description": "Domain to search ads for, e.g. apple.com" } }, "required": ["domain"] } } } },
        "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object" } } } } } }, "402": { "description": "Payment Required" } }
      }
    },
    "/api/google/ai-overviews": {
      "post": {
        "operationId": "googleAIOverviews",
        "summary": "Google AI Overviews search summaries",
        "tags": ["Google Intel"],
        "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.050000" }, "protocols": [{ "x402": {} }] },
        "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "query": { "type": "string", "description": "Search query to get AI overview for" } }, "required": ["query"] } } } },
        "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object" } } } } } }, "402": { "description": "Payment Required" } }
      }
    }
  }
}