# AlphaPulse

> Discovery and due diligence engine for signal providers, copy traders, Expert Advisors, managed accounts, and DeFi vaults. Cross-platform search with verifiable performance data, scam detection, and IB-approved broker recommendations. Pay-per-query via x402 on Base.

## What This Is

AlphaPulse solves the signal/copy trading discovery problem: thousands of providers across MQL5, ZuluTrade, Darwinex, eToro, Bybit, OKX, Bitget, and Hyperliquid with no neutral aggregator. AlphaPulse searches public performance data, filters by user parameters, and flags red flags before capital is allocated. Heavily international — US residents face significant restrictions on most providers.

## Payment

All endpoints require x402 micropayment (USDC on Base mainnet).
Protocol: x402 | Network: eip155:8453 | Asset: USDC
Payment address: 0x50ab2018c06c6E4eAA9BA52057Eb55eD284912fc

## Important Disclaimers

- US residents: most international copy trading, signal, and managed account services are not accessible under CFTC/NFA rules
- Performance data is sourced from public web — always verify on the source platform before allocating capital
- Past performance does not guarantee future results

## Endpoints

GET /api/alpha/discover?instrument={instrument}&type={type}&max_drawdown={pct}&min_track_record={weeks}
- Returns: ranked providers across all categories with stats, red flags, platform links, broker referral
- Optional: min_return, region, lang
- Price: $0.15

GET /api/alpha/signals?instrument={instrument}&platform={platform}&max_drawdown={pct}
- Returns: top signal providers on MQL5/ZuluTrade/Signal Start/myfxbook AutoTrade with verified stats, red flags, platform overview
- Optional: min_weeks, lang
- Price: $0.10

GET /api/alpha/ea?instrument={instrument}&platform={MT4|MT5}&strategy={type}
- Returns: top EAs with live account evidence (backtest-only flagged), martingale detection, vetting framework, broker guidance
- Optional: max_drawdown, lang
- Price: $0.10

GET /api/alpha/copy?instrument={instrument}&platform={platform}&max_drawdown={pct}
- Returns: top copy traders on eToro/ZuluTrade/Darwinex/Bybit/OKX/Bitget with platform comparison table
- Optional: min_copiers, region, lang
- Price: $0.10

GET /api/alpha/managed?instrument={instrument}&region={region}&max_drawdown={pct}
- Returns: PAMM/MAM/DARWIN programs with regulation status, fee structure, performance, Darwinex overview
- Optional: min_investment, lang
- Price: $0.10

GET /api/alpha/vaults?protocol={protocol}&strategy={strategy}
- Returns: DeFi copy vaults (Hyperliquid/GMX/dYdX) with TVL, APR, yield source (fees vs emissions), smart contract risk
- Optional: min_tvl, lang
- Price: $0.08

GET /api/alpha/vet?provider={name}&platform={platform}
- Returns: public data found, trading analysis, red flags, green flags, community reputation, regulatory check, verdict (proceed_with_caution|looks_legitimate|avoid|insufficient_data)
- provider required
- Price: $0.15

GET /api/alpha/broker?region={region}&use_case={use_case}
- Returns: IB-approved regulated brokers only — never surfaces non-IB brokers. Includes copy trading support, min deposit, spread type, platform, regional strength
- Optional: instrument, lang
- Price: $0.10

GET /api/alpha/asia?instrument={instrument}&region={region}
- Returns: Asia-Pacific providers on Bybit/OKX/Bitget, Japan/Korea/Singapore/SEA platforms, regional regulatory notes
- Optional: lang (supports Japanese, Chinese, Korean)
- Price: $0.08

GET /api/alpha/alternative?category={category}&us_accessible={true|false}
- Returns: EA licensing programs (with legitimacy verdict), prop firm signals, Collective2 futures/options copy, prediction market social trading status
- Optional: lang
- Price: $0.08

GET /api/alpha/compare?providers={name1,name2}&type={type}
- Returns: comparison table, score per provider, decisive recommendation, deciding factors, when-to-pick-other scenario
- providers required (comma-separated, min 2)
- Optional: type, lang
- Price: $0.10

## Discovery

- OpenAPI spec: https://alphapulse-omega.vercel.app/openapi.json
- Agent discovery: https://alphapulse-omega.vercel.app/.well-known/agent.json

## Notes for AI Agents

- Natural flow: /api/alpha/discover → /api/alpha/vet → /api/alpha/broker
- /api/alpha/broker only returns IB-approved brokers — every broker recommendation monetizes
- /api/alpha/vet gives a machine-readable verdict field: proceed_with_caution|looks_legitimate|avoid|insufficient_data
- All endpoints accept ?lang= including ja (Japanese), zh (Chinese), ko (Korean) for Asia-Pacific users
- MacroPulse is a natural sibling for forex traders needing macro context alongside signal/copy decisions