{
  "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–$0.20 USDC/call via x402 micropayment.",
    "version": "1.2.0"
  },
  "servers": [
    {
      "url": "https://alphapulse.theaslangroupllc.com"
    }
  ],
  "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 — widest strategy search; start here when user has no specific signal provider in mind",
        "x-price-usd": 0.15
      }
    },
    "/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 — 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 — 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 — highest AUM per call; chain with /api/alpha/vet for due diligence",
        "x-price-usd": 0.1
      }
    },
    "/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 — chain with OnchainPulse for smart contract risk assessment; highest crypto affiliate revenue",
        "x-price-usd": 0.08
      }
    },
    "/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 — run before any capital allocation; pairs with /api/alpha/managed and /api/alpha/signals",
        "x-price-usd": 0.15
      }
    },
    "/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 — 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 — covers Japan, Korea, Singapore, Hong Kong, India markets; Bybit/OKX crypto copy trading dominant here",
        "x-price-usd": 0.08
      }
    },
    "/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.08
      }
    },
    "/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",
              "example": "Darwinex Zero, ZuluTrade"
            },
            "description": "Comma-separated provider names (min 2)"
          },
          {
            "name": "type",
            "in": "query",
            "schema": {
              "type": "string",
              "example": "copy"
            }
          },
          {
            "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 — chain after /api/alpha/discover to shortlist candidates",
        "x-price-usd": 0.1
      }
    }
  }
}
