# ToutCreer — EcoChain AI Trading Platform

> EcoChain is a custodial AI trading platform with ECO (EUR-pegged stablecoin), BTC, and ETH. Multi-pool AMM, order book trading, 4 automated AI strategies, strategy marketplace, copy trading, and leaderboard. Accessible to AI agents via the FINOPTIMA MCP server (35 tools). Secured by EcoAuth mobile 2FA.

## FINOPTIMA — MCP Server for AI Agents (v1.3.0)

FINOPTIMA is a Model Context Protocol (MCP) server that gives AI agents full access to the EcoChain trading platform. 35 tools for portfolio management, multi-pool AMM swaps, liquidity provision, order placement, automated trading strategies, strategy marketplace, and copy trading.

### Quick Install

For EcoAuth (interactive, phone 2FA):
```json
{
  "mcpServers": {
    "ecochain": {
      "command": "npx",
      "args": ["-y", "finoptima"],
      "env": { "ECOCHAIN_API_URL": "https://api.toutcreer.com" }
    }
  }
}
```

For API Key (autonomous agents, no 2FA):
```json
{
  "mcpServers": {
    "ecochain": {
      "command": "npx",
      "args": ["-y", "finoptima"],
      "env": {
        "ECOCHAIN_API_URL": "https://api.toutcreer.com",
        "ECOCHAIN_API_KEY": "eco_ak_..."
      }
    }
  }
}
```

### Authentication

Two modes:
1. **EcoAuth 2FA** (default): Call `login` with phone number → push notification → approve → JWT session
2. **API Key** (agents): Set `ECOCHAIN_API_KEY` env var → auto-authenticated, no login needed

### Available Tools (35)

**Auth:** login
**Portfolio:** get_balances, get_balance, get_portfolio, get_prices, get_lp_positions, get_transaction_history
**Market:** get_pools, get_pool_details, get_orderbook, get_ticker, get_candles, get_trading_pairs
**Trading:** place_order, cancel_order, get_my_orders, get_trade_history
**Swap AMM:** get_swap_quote, execute_swap (0.3% fee, 70% to LPs)
**Liquidity:** add_liquidity, remove_liquidity
**Transfer:** send_funds (internal, no blockchain fees)
**AI Strategies:** create_strategy, activate_strategy, pause_strategy, list_strategies, get_strategy
**Intents:** create_intent, list_intents
**Performance:** get_strategy_performance
**Marketplace:** get_leaderboard, get_templates, subscribe_template, follow_strategy, unfollow_strategy

### Multi-Pool AMM

Two active liquidity pools with ECO as hub token:
- **ECO/BTC** — ECO ↔ Bitcoin direct swaps
- **ECO/ETH** — ECO ↔ Ethereum direct swaps
- **BTC ↔ ETH** — Smart router multi-hop via ECO hub (BTC → ECO → ETH)

Swap fee: 0.3% per transaction. LP reward: 70% of fees (0.21% per swap).

### AI Trading Strategies

4 automated strategies:
- **DCA**: Periodic purchases with configurable amount, interval, and budget.
- **BTC Hedge**: Monitors BTC via 6h TWAP. Auto-converts to ECO on drops > threshold.
- **LP Yield**: Monitors pool APR and impermanent loss. Auto-rebalances liquidity.
- **Eco Pilot**: Regime-based composite strategy (accumulate in bull, hedge in bear, yield in sideways).

Pipeline: Strategy evaluates (60s) → Create Intent → Policy Engine (8 rules) → Auto-approve < 0.01 BTC / Manual ≥ 0.01 BTC → Execute → PnL Snapshot.

### Strategy Marketplace

- **Templates**: Browse and subscribe to published strategies from top providers
- **Copy Trading**: Follow live strategies with configurable scale factor (0.1x–2.0x)
- **Leaderboard**: Top 50 public strategies ranked by return, drawdown, followers

### Subscription Tiers

| Plan | Price | Strategies | Templates | API Keys | Copy Trading |
|------|-------|-----------|-----------|----------|-------------|
| Free | 0 EUR | 0 | Browse | No | No |
| Pilot | 9 EUR/mo | 5 | Subscribe | No | Follow only |
| Pro | 29 EUR/mo | 20 | Publish + Subscribe | 3 keys | Follow + Provide |
| API | 99 EUR/mo | Unlimited | All | 10 keys | All |

### Links

- Platform: https://www.toutcreer.com/trading
- FINOPTIMA page: https://www.toutcreer.com/finoptima
- Documentation: https://www.toutcreer.com/trading/finoptima.md
- API health: https://api.toutcreer.com/health
- npm: https://www.npmjs.com/package/finoptima

### Security

- EcoAuth 2FA mobile authentication + API key auth (HMAC-SHA256, scoped, rate-limited)
- Custodial platform (no private keys exposed)
- Policy engine validates all automated trades (8 rules)
- Auto-approve only below 0.01 BTC threshold
- Circuit breaker pauses strategy on 10% loss
- GRC governance framework: 139 documents, 14 security audits, 50+ traced decisions