DreamNet Trading Trappers

Portable, agent-readable market research that can be rehearsed in Whale Intelligence League and preserved in Warper Keeper.

A Trading Trapper captures:

• the observed market, price, timeframe, venue, and freshness;
• a thesis, entry condition, targets, and explicit invalidation;
• paper position size and maximum paper loss;
• evidence references and agent attribution;
• TradingView research plus Alpaca market-data evidence;
• a deterministic SHA-256 receipt;
• a mandatory no-wallet, no-execution, zero-funds-moved policy.

Why this exists

TradingView is excellent for charting, alerts, Pine Script, and human research. Whale Intelligence League is the paper-trading arena. Warper Keeper is the portable context and evidence layer. This contract lets them complement one another without turning a charting integration into an autonomous brokerage.

TradingView / approved data / user research
  -> Trading Trapper
  -> Warper Keeper bundle
  -> agent analysis and counter-analysis
  -> Whale League paper rehearsal
  -> receipted result

Agent API

The Cloudflare Worker exposes:

GET  /.well-known/agent.json
GET  /v1/schema
POST /v1/trappers/build
POST /v1/trappers/validate
POST /v1/trappers/to-warper
POST /mcp

Remote MCP tools:

• get_trading_trapper_contract
• build_trading_trapper
• validate_trading_trapper
• to_warper_keeper_bundle

These tools are public because they are stateless and cannot execute trades. Durable writes to Warper Keeper require a separate assignment-scoped key.

Local development

npm install
npm run check
npm run dev

TradingView boundary

Whale League already uses TradingView Lightweight Charts, the official Apache-2.0 rendering library. The community TradingView Desktop MCP bridge is optional, local-only, unofficial, and based on undocumented internal interfaces. Read docs/TRADINGVIEW_HYBRID.md before connecting it.

This repository does not provide investment advice or live trading.