{
  "openapi": "3.1.0",
  "info": {
    "title": "AlphaPulse API",
    "description": "Global alternative trading intelligence API. AI-synthesized signal provider rankings, managed account analysis, copy trading discovery, expert advisor (EA/robot) vetting, multi-asset arbitrage, crypto vault APY comparison, and broker comparative analysis. Covers forex, CFDs, indices, commodities, and crypto. Serves retail traders, prop firm candidates, fund allocators, and AI trading agents. IB broker referral links (IC Markets, Pepperstone, Bybit, Bitget) included. All endpoints support any language via ?lang=. Pricing: $0.08\u2013$0.20 USDC/call via x402 micropayment.",
    "version": "1.2.0"
  },
  "servers": [
    {
      "url": "https://alphapulse-omega.vercel.app"
    }
  ],
  "paths": {
    "/api/alpha/discover": {
      "get": {
        "summary": "Cross-platform provider discovery",
        "parameters": [
          {
            "name": "PAYMENT-SIGNATURE",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "instrument",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "type",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "description": "signal|copy|EA|managed|vault|any"
          },
          {
            "name": "max_drawdown",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "min_track_record",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "min_return",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "region",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "lang",
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Ranked providers with stats, red flags, and broker referral links"
          },
          "402": {
            "description": "$0.15"
          }
        },
        "x-agent-use-case": "on-demand",
        "x-agent-chaining": "Discovery endpoint \u2014 widest strategy search; start here when user has no specific signal provider in mind",
        "x-price-usd": 0.08
      }
    },
    "/api/alpha/signals": {
      "get": {
        "summary": "Signal provider discovery",
        "parameters": [
          {
            "name": "PAYMENT-SIGNATURE",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "instrument",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "platform",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "max_drawdown",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "min_weeks",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "lang",
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Top signal providers with verified stats and red flags"
          },
          "402": {
            "description": "$0.10"
          }
        },
        "x-agent-use-case": "scheduled",
        "x-agent-chaining": "Start here to find signal providers; chain to /api/alpha/broker for account opening; pairs with MacroPulse for macro overlay on signal provider performance",
        "x-price-usd": 0.1
      }
    },
    "/api/alpha/ea": {
      "get": {
        "summary": "Expert Advisor discovery",
        "parameters": [
          {
            "name": "PAYMENT-SIGNATURE",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "instrument",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "platform",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "max_drawdown",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "strategy",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "lang",
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Top EAs with live account evidence, martingale flag, vetting framework"
          },
          "402": {
            "description": "$0.10"
          }
        },
        "x-agent-use-case": "on-demand",
        "x-agent-chaining": "Expert advisor vetting \u2014 chain with /api/alpha/broker for MT4/MT5 broker selection; pairs with MacroPulse for EA parameter optimization",
        "x-price-usd": 0.1
      }
    },
    "/api/alpha/copy": {
      "get": {
        "summary": "Copy trading discovery",
        "parameters": [
          {
            "name": "PAYMENT-SIGNATURE",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "instrument",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "platform",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "max_drawdown",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "min_copiers",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "region",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "lang",
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Top copy traders with platform comparison"
          },
          "402": {
            "description": "$0.10"
          }
        },
        "x-agent-use-case": "on-demand",
        "x-agent-chaining": "Copy trading platform analysis \u2014 pairs with /api/alpha/signals; focus on eToro, ZuluTrade, Bybit copy for retail users",
        "x-price-usd": 0.1
      }
    },
    "/api/alpha/managed": {
      "get": {
        "summary": "Managed account discovery",
        "parameters": [
          {
            "name": "PAYMENT-SIGNATURE",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "instrument",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "region",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "min_investment",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "max_drawdown",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "lang",
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "PAMM/MAM/DARWIN programs with regulation and fee analysis"
          },
          "402": {
            "description": "$0.10"
          }
        },
        "x-agent-use-case": "on-demand",
        "x-agent-chaining": "Managed account / DARWIN fund analysis \u2014 highest AUM per call; chain with /api/alpha/vet for due diligence",
        "x-price-usd": 0.15
      }
    },
    "/api/alpha/vaults": {
      "get": {
        "summary": "DeFi vault discovery",
        "parameters": [
          {
            "name": "PAYMENT-SIGNATURE",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "protocol",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "min_tvl",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "strategy",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "lang",
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "DeFi copy vaults with TVL, APR, yield source, smart contract risk"
          },
          "402": {
            "description": "$0.08"
          }
        },
        "x-agent-use-case": "on-demand",
        "x-agent-chaining": "DeFi vault APY comparison \u2014 chain with OnchainPulse for smart contract risk assessment; highest crypto affiliate revenue",
        "x-price-usd": 0.15
      }
    },
    "/api/alpha/vet": {
      "get": {
        "summary": "Provider due diligence",
        "parameters": [
          {
            "name": "PAYMENT-SIGNATURE",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "provider",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "platform",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "lang",
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Due diligence report with verdict: proceed_with_caution|looks_legitimate|avoid|insufficient_data"
          },
          "402": {
            "description": "$0.15"
          }
        },
        "x-agent-use-case": "on-demand",
        "x-agent-chaining": "Risk vetting \u2014 run before any capital allocation; pairs with /api/alpha/managed and /api/alpha/signals",
        "x-price-usd": 0.1
      }
    },
    "/api/alpha/broker": {
      "get": {
        "summary": "IB-approved broker recommendation",
        "parameters": [
          {
            "name": "PAYMENT-SIGNATURE",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "region",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "use_case",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "instrument",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "lang",
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Regulated broker recommendations from IB-approved allowlist"
          },
          "402": {
            "description": "$0.10"
          }
        },
        "x-agent-use-case": "on-demand",
        "x-agent-chaining": "Broker comparison \u2014 chain after /api/alpha/signals to find brokers that support chosen signal platform; pairs with /api/alpha/managed for fund allocation",
        "x-price-usd": 0.1
      }
    },
    "/api/alpha/asia": {
      "get": {
        "summary": "Asia-Pacific copy trading discovery",
        "parameters": [
          {
            "name": "PAYMENT-SIGNATURE",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "instrument",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "region",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "lang",
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Asia-Pacific providers with regional platform notes"
          },
          "402": {
            "description": "$0.08"
          }
        },
        "x-agent-use-case": "on-demand",
        "x-agent-chaining": "Asia-focused signal intelligence \u2014 covers Japan, Korea, Singapore, Hong Kong, India markets; Bybit/OKX crypto copy trading dominant here",
        "x-price-usd": 0.1
      }
    },
    "/api/alpha/alternative": {
      "get": {
        "summary": "Alternative and niche strategies",
        "parameters": [
          {
            "name": "PAYMENT-SIGNATURE",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "category",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "us_accessible",
            "in": "query",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "lang",
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "EA licensing, prop signals, Collective2, prediction markets with legitimacy assessment"
          },
          "402": {
            "description": "$0.08"
          }
        },
        "x-agent-use-case": "on-demand",
        "x-agent-chaining": "Non-traditional alpha: sentiment-based, social, ML-derived strategies; pairs with MacroPulse /api/macro/sentiment",
        "x-price-usd": 0.1
      }
    },
    "/api/alpha/compare": {
      "get": {
        "summary": "Side-by-side provider comparison",
        "parameters": [
          {
            "name": "PAYMENT-SIGNATURE",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "providers",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Comma-separated provider names (min 2)"
          },
          {
            "name": "type",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "lang",
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Comparison table with decisive recommendation and deciding factors"
          },
          "402": {
            "description": "$0.10"
          }
        },
        "x-agent-use-case": "on-demand",
        "x-agent-chaining": "Side-by-side comparison of multiple strategies \u2014 chain after /api/alpha/discover to shortlist candidates",
        "x-price-usd": 0.1
      }
    }
  }
}