{"service": "PolyXray / HL-XRay signals API (beta)", "auth": "pass ?key=YOUR_KEY or header X-API-Key for the metered REST tier. Keyless agents can use the open MCP endpoint at https://blacklight.observer/mcp (no signup).", "rate_limit": "per-key requests/minute (see your key tier)", "endpoints": {"GET /api/v1/hl/vaults": "Hyperliquid vault ranking (risk-scored). params: limit, offset, verdict", "GET /api/v1/hl/traders": "Hyperliquid trader ranking (drawdown/Sharpe). params: limit, offset, verdict", "GET /api/v1/pm/traders": "Polymarket trader ranking (style/edge/drawdown). params: limit, offset, verdict", "GET /api/v1/wallet": "On-demand wallet X-Ray. params: addr (0x..), venue=hl|pm", "GET /api/v1/hl/record": "Track-record assessment of ONE Hyperliquid wallet (history only). params: addr (0x..)", "GET /api/v1/hl/records": "Track-record assessments, bulk (pro/feed keys). params: limit (<=500), offset, family, flag", "GET /api/v1/hl/records/sample": "20-wallet sample of the track-record feed, mixed styles (any key)"}, "track_record_feed": "History-only assessments: style, past results, past risk, how followable the record was, plain-language flags. Not a forecast, not a recommendation.", "note": "Cached rankings refresh on a schedule (minutes-to-hours). Not for HFT."}