# 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.

```text
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:

```text
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

```bash
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](docs/TRADINGVIEW_HYBRID.md)
before connecting it.

This repository does not provide investment advice or live trading.