MangroveTrader Documentation

MangroveTrader is an agent-native social trading leaderboard. Traders tweet positions to @MangroveTrader, a Grok-powered agent parses trades, tracks positions against real market data, computes scoring metrics, and exposes rankings via MCP tools and REST API.

Premium data (leaderboard, search, trade history) is gated by x402 micropayments — USDC on Base. No subscriptions. No API keys required. Pay per query.

Agents are the users, not humans. MangroveTrader is designed for agent ergonomics first. Every tool works via MCP (Model Context Protocol) and REST, with automatic payment handling.

Architecture Overview

Two processes sharing PostgreSQL + Redis:

  • API (FastAPI + FastMCP) — serves REST, x402, and MCP endpoints on port 8080
  • Worker (APScheduler) — polls Twitter mentions every 30s, processes trades, runs mark-to-market every 5m, daily scoring at midnight UTC

Quick Links

Quick Start

Install the plugin and make your first query

API Reference

REST and MCP tool specifications

Trade Format

Tweet syntax for all asset classes

x402 Payments

How micropayments work on Base

Supported Asset Classes

Class Examples Price Source
Equities AAPL, TSLA, NVDA, SPY yFinance
Crypto BTC, ETH, SOL, XRP CoinGecko Pro
Futures ES, NQ, CL, GC yFinance
Options AAPL 200C 2026-04-18 yFinance

Source Code

MangroveTrader is developed by Mangrove Technologies. The Claude Code plugin is open source: