openapi: 3.1.0
info:
  title: x402 Market Intelligence MCP
  version: 0.2.0
paths:
  /healthz:
    get:
      summary: Health check
      responses: {"200": {description: OK}}
  /v1/x402/market_map:
    post:
      summary: Paid x402 market map
      x-x402-price-usd: "0.25"
      responses: {"200": {description: OK}, "402": {description: x402 payment required}}
  /v1/x402/paid_api_discovery:
    post:
      summary: Paid API discovery for verified x402 APIs
      description: Search and rank pay-per-call x402 endpoints by buyer demand, price, registry coverage, schema/examples, seller score, and route reliability.
      x-x402-price-usd: "0.25"
      responses: {"200": {description: OK}, "402": {description: x402 payment required}}
  /v1/x402/verified_endpoints:
    post:
      summary: Verified x402 APIs directory
      description: Discover x402 pay-per-call endpoints with settlement proof, schema quality, examples, freshness, seller score, and registry coverage.
      x-x402-price-usd: "0.15"
      responses: {"200": {description: OK}, "402": {description: x402 payment required}}
  /v1/x402/endpoint_rankings:
    post:
      summary: x402 endpoint rankings
      description: Compare paid x402 resources by revenue proof, buyer breadth, price, metadata quality, and reliability signals.
      x-x402-price-usd: "0.15"
      responses: {"200": {description: OK}, "402": {description: x402 payment required}}
  /v1/x402/search_rank_monitor:
    post:
      summary: x402 search rank monitor
      description: Hosted marketplace search-rank monitor for paid API discovery terms; records Money Tree rank, competing resources, rank deltas, freshness, and next proof action from recurring D1 marketplace snapshots.
      x-x402-price-usd: "0.20"
      responses: {"200": {description: OK}, "402": {description: x402 payment required}}
  /v1/x402/buyer_intent_gap_report:
    post:
      summary: x402 buyer intent gap report
      description: Hosted buyer-intent gap report ranking urgent agent search queries, under-indexed Money Tree routes, competitor coverage, and next dataset/MCP route to ship from recurring D1 marketplace snapshots and rank observations.
      x-x402-price-usd: "0.30"
      responses: {"200": {description: OK}, "402": {description: x402 payment required}}
  /v1/x402/autopay_readiness_matrix:
    post:
      summary: x402 autopay readiness matrix
      description: Hosted autopay readiness matrix for agents choosing paid x402 APIs; scores routes by payment envelope quality, schema/examples, buyer proof, registry coverage, price risk, seller breadth, and freshness before autonomous spend.
      x-x402-price-usd: "0.20"
      responses: {"200": {description: OK}, "402": {description: x402 payment required}}
  /v1/x402/proof_lift_report:
    post:
      summary: x402 proof lift report
      description: Hosted proof-lift report for x402 paid API discovery campaigns; combines paid-call telemetry with recurring marketplace rank observations to show route proof coverage, index/rank movement, buyer-query lift, and the next bounded proof action.
      x-x402-price-usd: "0.20"
      responses: {"200": {description: OK}, "402": {description: x402 payment required}}
  /v1/x402/keyword_visibility_pack:
    post:
      summary: x402 keyword visibility pack
      description: Hosted keyword visibility pack for paid API discovery; derives buyer search vocabulary, listing copy, schema/example gaps, route aliases, and proof terms from recurring CDP+PayAI resources, rank observations, and seller-score signals.
      x-x402-price-usd: "0.15"
      responses: {"200": {description: OK}, "402": {description: x402 payment required}}
  /v1/x402/seller_score:
    post:
      summary: Score x402 seller/resource
      x-x402-price-usd: "0.10"
      responses: {"200": {description: OK}, "402": {description: x402 payment required}}
  /v1/x402/emerging_categories:
    post:
      summary: Emerging x402 categories
      x-x402-price-usd: "0.50"
      responses: {"200": {description: OK}, "402": {description: x402 payment required}}
  /v1/x402/category_gap_report:
    post:
      summary: x402 category gap report
      description: Hosted proprietary category-gap report ranking paid-service categories by demand, seller scarcity, schema/example gaps, registry coverage, and freshness deltas from recurring D1 snapshots.
      x-x402-price-usd: "0.35"
      responses: {"200": {description: OK}, "402": {description: x402 payment required}}
  /v1/x402/category_trends:
    post:
      summary: x402 category trends
      description: Time-series trend report from hosted D1 x402 observations, including demand deltas, new resources, seller concentration shifts, metadata-quality drift, and next build/proof recommendation.
      x-x402-price-usd: "0.25"
      responses: {"200": {description: OK}, "402": {description: x402 payment required}}
  /v1/x402/resource_due_diligence:
    post:
      summary: Resource route due diligence
      x-x402-price-usd: "0.15"
      responses: {"200": {description: OK}, "402": {description: x402 payment required}}
