trading-cli 0.3.0__py3-none-any.whl

fastbooks_cli/commands/polymarket.py

@@ -0,0 +1,2215 @@
+"""Polymarket command group — prediction market trading, browsing, and on-chain ops.
+
+Mirrors the full Polymarket CLI feature set: markets, events, CLOB trading,
+CTF token operations, bridging, and portfolio data.
+"""
+
+from __future__ import annotations
+
+import click
+
+from ..client import FastBooksClient
+from ..output import emit, emit_error, format_table, require_experimental
+
+
+# ══════════════════════════════════════════════════════════════════════════
+# Root group
+# ══════════════════════════════════════════════════════════════════════════
+
+@click.group()
+@click.pass_context
+def polymarket(ctx):
+    """[experimental] Polymarket prediction markets — browse, trade, manage positions.
+
+    NOTE: requires the Polymarket router, not enabled on standard FastBooks
+    deployments. Gated behind FASTBOOKS_EXPERIMENTAL=1.
+
+    Browse markets and events without a wallet. Trading requires a Polygon
+    wallet private key (--private-key or POLYMARKET_PRIVATE_KEY env var).
+
+    Examples:
+        fastbooks polymarket markets list --limit 10
+        fastbooks polymarket markets search "bitcoin"
+        fastbooks polymarket clob book TOKEN_ID
+        fastbooks polymarket clob create-order --token TOKEN --side buy --price 0.50 --size 10
+    """
+    require_experimental(ctx, "polymarket")
+
+
+# ══════════════════════════════════════════════════════════════════════════
+# Markets (read-only, no wallet needed)
+# ══════════════════════════════════════════════════════════════════════════
+
+@polymarket.group("markets")
+def pm_markets():
+    """Browse and search prediction markets."""
+    pass
+
+
+@pm_markets.command("list")
+@click.option("--limit", "-n", type=int, default=20, help="Number of markets.")
+@click.option("--offset", type=int, default=0, help="Pagination offset.")
+@click.option("--active/--no-active", default=None, help="Filter by active status.")
+@click.option("--closed/--no-closed", default=None, help="Filter by closed status.")
+@click.option("--order", type=str, default=None, help="Sort field (e.g. volume_num).")
+@click.option("--ascending", is_flag=True, help="Sort ascending.")
+@click.pass_context
+def pm_markets_list(ctx, limit, offset, active, closed, order, ascending):
+    """List prediction markets.
+
+    Examples:
+        fastbooks polymarket markets list --limit 10
+        fastbooks polymarket markets list --active --order volume_num
+        fastbooks polymarket markets list --closed --limit 50 --offset 25
+    """
+    client: FastBooksClient = ctx.obj
+    try:
+        data = client.polymarket_markets_list(
+            limit=limit, offset=offset, active=active,
+            closed=closed, order=order, ascending=ascending,
+        )
+        emit(ctx, data, lambda d: _format_markets_list(d))
+    except Exception as e:
+        emit_error(ctx, str(e))
+        ctx.exit(1)
+
+
+@pm_markets.command("get")
+@click.argument("id_or_slug")
+@click.pass_context
+def pm_markets_get(ctx, id_or_slug):
+    """Get a single market by ID or slug.
+
+    Examples:
+        fastbooks polymarket markets get 12345
+        fastbooks polymarket markets get will-trump-win
+    """
+    client: FastBooksClient = ctx.obj
+    try:
+        data = client.polymarket_market_get(id_or_slug)
+        emit(ctx, data, lambda d: _format_market_detail(d))
+    except Exception as e:
+        emit_error(ctx, str(e))
+        ctx.exit(1)
+
+
+@pm_markets.command("search")
+@click.argument("query")
+@click.option("--limit", "-n", type=int, default=10, help="Max results.")
+@click.pass_context
+def pm_markets_search(ctx, query, limit):
+    """Search markets by keyword.
+
+    Examples:
+        fastbooks polymarket markets search "bitcoin"
+        fastbooks polymarket markets search "election" --limit 20
+    """
+    client: FastBooksClient = ctx.obj
+    try:
+        data = client.polymarket_market_search(query, limit)
+        emit(ctx, data, lambda d: _format_markets_list(d))
+    except Exception as e:
+        emit_error(ctx, str(e))
+        ctx.exit(1)
+
+
+@pm_markets.command("tags")
+@click.argument("market_id")
+@click.pass_context
+def pm_markets_tags(ctx, market_id):
+    """Get tags for a market.
+
+    Example: fastbooks polymarket markets tags 12345
+    """
+    client: FastBooksClient = ctx.obj
+    try:
+        data = client.polymarket_market_tags(market_id)
+        emit(ctx, data)
+    except Exception as e:
+        emit_error(ctx, str(e))
+        ctx.exit(1)
+
+
+# ══════════════════════════════════════════════════════════════════════════
+# Events
+# ══════════════════════════════════════════════════════════════════════════
+
+@polymarket.group("events")
+def pm_events():
+    """Browse events (groups of related markets)."""
+    pass
+
+
+@pm_events.command("list")
+@click.option("--limit", "-n", type=int, default=20)
+@click.option("--offset", type=int, default=0)
+@click.option("--tag", type=str, default=None, help="Filter by tag (e.g. politics, crypto).")
+@click.option("--active/--no-active", default=None)
+@click.option("--closed/--no-closed", default=None)
+@click.pass_context
+def pm_events_list(ctx, limit, offset, tag, active, closed):
+    """List events with optional filters.
+
+    Examples:
+        fastbooks polymarket events list --limit 10
+        fastbooks polymarket events list --tag politics --active
+    """
+    client: FastBooksClient = ctx.obj
+    try:
+        data = client.polymarket_events_list(limit=limit, offset=offset, tag=tag, active=active, closed=closed)
+        emit(ctx, data, lambda d: _format_events_list(d))
+    except Exception as e:
+        emit_error(ctx, str(e))
+        ctx.exit(1)
+
+
+@pm_events.command("get")
+@click.argument("event_id")
+@click.pass_context
+def pm_events_get(ctx, event_id):
+    """Get event details by ID.
+
+    Example: fastbooks polymarket events get 500
+    """
+    client: FastBooksClient = ctx.obj
+    try:
+        data = client.polymarket_event_get(event_id)
+        emit(ctx, data, lambda d: _format_event_detail(d))
+    except Exception as e:
+        emit_error(ctx, str(e))
+        ctx.exit(1)
+
+
+@pm_events.command("tags")
+@click.argument("event_id")
+@click.pass_context
+def pm_events_tags(ctx, event_id):
+    """Get tags for an event.
+
+    Example: fastbooks polymarket events tags 500
+    """
+    client: FastBooksClient = ctx.obj
+    try:
+        data = client.polymarket_event_tags(event_id)
+        emit(ctx, data)
+    except Exception as e:
+        emit_error(ctx, str(e))
+        ctx.exit(1)
+
+
+# ══════════════════════════════════════════════════════════════════════════
+# Tags
+# ══════════════════════════════════════════════════════════════════════════
+
+@polymarket.group("tags")
+@click.pass_context
+def pm_tags(ctx):
+    """Browse and navigate market tags."""
+    pass
+
+
+@pm_tags.command("list")
+@click.pass_context
+def pm_tags_list(ctx):
+    """List all available market tags.
+
+    Example: fastbooks polymarket tags list
+    """
+    client: FastBooksClient = ctx.obj
+    try:
+        data = client.polymarket_tags_list()
+        emit(ctx, data)
+    except Exception as e:
+        emit_error(ctx, str(e))
+        ctx.exit(1)
+
+
+@pm_tags.command("get")
+@click.argument("id_or_slug")
+@click.pass_context
+def pm_tags_get(ctx, id_or_slug):
+    """Get a single tag by ID or slug.
+
+    Example: fastbooks polymarket tags get politics
+    """
+    client: FastBooksClient = ctx.obj
+    try:
+        data = client.polymarket_tag_get(id_or_slug)
+        emit(ctx, data)
+    except Exception as e:
+        emit_error(ctx, str(e))
+        ctx.exit(1)
+
+
+@pm_tags.command("related")
+@click.argument("id_or_slug")
+@click.pass_context
+def pm_tags_related(ctx, id_or_slug):
+    """Get related tags.
+
+    Example: fastbooks polymarket tags related politics
+    """
+    client: FastBooksClient = ctx.obj
+    try:
+        data = client.polymarket_tags_related(id_or_slug)
+        emit(ctx, data)
+    except Exception as e:
+        emit_error(ctx, str(e))
+        ctx.exit(1)
+
+
+# ══════════════════════════════════════════════════════════════════════════
+# Series (recurring events)
+# ══════════════════════════════════════════════════════════════════════════
+
+@polymarket.group("series")
+def pm_series():
+    """Browse recurring event series."""
+    pass
+
+
+@pm_series.command("list")
+@click.option("--limit", "-n", type=int, default=20)
+@click.option("--offset", type=int, default=0)
+@click.pass_context
+def pm_series_list(ctx, limit, offset):
+    """List event series.
+
+    Example: fastbooks polymarket series list --limit 10
+    """
+    client: FastBooksClient = ctx.obj
+    try:
+        data = client.polymarket_series_list(limit, offset)
+        emit(ctx, data)
+    except Exception as e:
+        emit_error(ctx, str(e))
+        ctx.exit(1)
+
+
+@pm_series.command("get")
+@click.argument("series_id")
+@click.pass_context
+def pm_series_get(ctx, series_id):
+    """Get a series by ID.
+
+    Example: fastbooks polymarket series get 42
+    """
+    client: FastBooksClient = ctx.obj
+    try:
+        data = client.polymarket_series_get(series_id)
+        emit(ctx, data)
+    except Exception as e:
+        emit_error(ctx, str(e))
+        ctx.exit(1)
+
+
+# ══════════════════════════════════════════════════════════════════════════
+# Comments
+# ══════════════════════════════════════════════════════════════════════════
+
+@polymarket.group("comments")
+def pm_comments():
+    """Browse comments on markets and events."""
+    pass
+
+
+@pm_comments.command("list")
+@click.option("--entity-type", required=True, type=click.Choice(["event", "market", "series"]))
+@click.option("--entity-id", required=True, help="Entity ID.")
+@click.pass_context
+def pm_comments_list(ctx, entity_type, entity_id):
+    """List comments for an entity.
+
+    Example: fastbooks polymarket comments list --entity-type event --entity-id 500
+    """
+    client: FastBooksClient = ctx.obj
+    try:
+        data = client.polymarket_comments_list(entity_type, entity_id)
+        emit(ctx, data)
+    except Exception as e:
+        emit_error(ctx, str(e))
+        ctx.exit(1)
+
+
+@pm_comments.command("get")
+@click.argument("comment_id")
+@click.pass_context
+def pm_comments_get(ctx, comment_id):
+    """Get a comment by ID.
+
+    Example: fastbooks polymarket comments get abc123
+    """
+    client: FastBooksClient = ctx.obj
+    try:
+        data = client.polymarket_comment_get(comment_id)
+        emit(ctx, data)
+    except Exception as e:
+        emit_error(ctx, str(e))
+        ctx.exit(1)
+
+
+@pm_comments.command("by-user")
+@click.argument("address")
+@click.pass_context
+def pm_comments_by_user(ctx, address):
+    """Get comments by a user address.
+
+    Example: fastbooks polymarket comments by-user 0xf5E6...
+    """
+    client: FastBooksClient = ctx.obj
+    try:
+        data = client.polymarket_comments_by_user(address)
+        emit(ctx, data)
+    except Exception as e:
+        emit_error(ctx, str(e))
+        ctx.exit(1)
+
+
+# ══════════════════════════════════════════════════════════════════════════
+# Profiles
+# ══════════════════════════════════════════════════════════════════════════
+
+@polymarket.group("profiles")
+def pm_profiles():
+    """View public user profiles."""
+    pass
+
+
+@pm_profiles.command("get")
+@click.argument("address")
+@click.pass_context
+def pm_profiles_get(ctx, address):
+    """Get a public profile by wallet address.
+
+    Example: fastbooks polymarket profiles get 0xf5E6...
+    """
+    client: FastBooksClient = ctx.obj
+    try:
+        data = client.polymarket_profile_get(address)
+        emit(ctx, data)
+    except Exception as e:
+        emit_error(ctx, str(e))
+        ctx.exit(1)
+
+
+# ══════════════════════════════════════════════════════════════════════════
+# Sports
+# ══════════════════════════════════════════════════════════════════════════
+
+@polymarket.group("sports")
+def pm_sports():
+    """Sports metadata: leagues, teams, market types."""
+    pass
+
+
+@pm_sports.command("list")
+@click.pass_context
+def pm_sports_list(ctx):
+    """List supported sports.
+
+    Example: fastbooks polymarket sports list
+    """
+    client: FastBooksClient = ctx.obj
+    try:
+        data = client.polymarket_sports_list()
+        emit(ctx, data)
+    except Exception as e:
+        emit_error(ctx, str(e))
+        ctx.exit(1)
+
+
+@pm_sports.command("market-types")
+@click.pass_context
+def pm_sports_market_types(ctx):
+    """List valid sports market types.
+
+    Example: fastbooks polymarket sports market-types
+    """
+    client: FastBooksClient = ctx.obj
+    try:
+        data = client.polymarket_sports_market_types()
+        emit(ctx, data)
+    except Exception as e:
+        emit_error(ctx, str(e))
+        ctx.exit(1)
+
+
+@pm_sports.command("teams")
+@click.option("--league", required=True, help="League name (e.g. NFL, NBA, MLB).")
+@click.option("--limit", "-n", type=int, default=50)
+@click.pass_context
+def pm_sports_teams(ctx, league, limit):
+    """List teams in a league.
+
+    Example: fastbooks polymarket sports teams --league NFL --limit 32
+    """
+    client: FastBooksClient = ctx.obj
+    try:
+        data = client.polymarket_sports_teams(league, limit)
+        emit(ctx, data)
+    except Exception as e:
+        emit_error(ctx, str(e))
+        ctx.exit(1)
+
+
+# ══════════════════════════════════════════════════════════════════════════
+# Wallet Management
+# ══════════════════════════════════════════════════════════════════════════
+
+@polymarket.group("wallet")
+def pm_wallet():
+    """Manage Polymarket wallet (create, import, show, reset).
+
+    The wallet private key is used to sign orders and on-chain transactions.
+    Stored in ~/.config/polymarket/config.json.
+    """
+    pass
+
+
+@pm_wallet.command("create")
+@click.option("--signature-type", type=click.Choice(["proxy", "eoa", "gnosis-safe"]), default="proxy")
+@click.pass_context
+def pm_wallet_create(ctx, signature_type):
+    """Generate a new random wallet.
+
+    Creates a new private key and saves it to config.
+
+    Example: fastbooks polymarket wallet create
+    """
+    client: FastBooksClient = ctx.obj
+    try:
+        data = client.polymarket_wallet_create(signature_type)
+        emit(ctx, data, lambda d: _format_wallet_info(d))
+    except Exception as e:
+        emit_error(ctx, str(e))
+        ctx.exit(1)
+
+
+@pm_wallet.command("import")
+@click.argument("private_key")
+@click.option("--signature-type", type=click.Choice(["proxy", "eoa", "gnosis-safe"]), default="proxy")
+@click.pass_context
+def pm_wallet_import(ctx, private_key, signature_type):
+    """Import an existing private key.
+
+    Example: fastbooks polymarket wallet import 0xabc123...
+    """
+    client: FastBooksClient = ctx.obj
+    try:
+        data = client.polymarket_wallet_import(private_key, signature_type)
+        emit(ctx, data, lambda d: _format_wallet_info(d))
+    except Exception as e:
+        emit_error(ctx, str(e))
+        ctx.exit(1)
+
+
+@pm_wallet.command("address")
+@click.pass_context
+def pm_wallet_address(ctx):
+    """Print the configured wallet address.
+
+    Example: fastbooks polymarket wallet address
+    """
+    client: FastBooksClient = ctx.obj
+    try:
+        data = client.polymarket_wallet_address()
+        emit(ctx, data)
+    except Exception as e:
+        emit_error(ctx, str(e))
+        ctx.exit(1)
+
+
+@pm_wallet.command("show")
+@click.pass_context
+def pm_wallet_show(ctx):
+    """Show full wallet info (address, source, config path).
+
+    Example: fastbooks polymarket wallet show
+    """
+    client: FastBooksClient = ctx.obj
+    try:
+        data = client.polymarket_wallet_show()
+        emit(ctx, data, lambda d: _format_wallet_info(d))
+    except Exception as e:
+        emit_error(ctx, str(e))
+        ctx.exit(1)
+
+
+@pm_wallet.command("reset")
+@click.option("--confirm/--no-confirm", default=True)
+@click.pass_context
+def pm_wallet_reset(ctx, confirm):
+    """Delete wallet config (prompts for confirmation).
+
+    Example: fastbooks polymarket wallet reset
+    """
+    if confirm and not ctx.find_root().params.get("json_output", False):
+        if not click.confirm("  Delete Polymarket wallet config?"):
+            click.echo("  Cancelled.")
+            return
+    client: FastBooksClient = ctx.obj
+    try:
+        data = client.polymarket_wallet_reset()
+        emit(ctx, data, lambda d: "  Wallet config deleted.")
+    except Exception as e:
+        emit_error(ctx, str(e))
+        ctx.exit(1)
+
+
+# ══════════════════════════════════════════════════════════════════════════
+# CLOB — Order Book & Prices (read-only, no wallet)
+# ══════════════════════════════════════════════════════════════════════════
+
+@polymarket.group("clob")
+def pm_clob():
+    """CLOB order book: prices, books, trading, and account queries.
+
+    Read-only commands (book, price, midpoint, spread) work without a wallet.
+    Trading commands require --private-key or POLYMARKET_PRIVATE_KEY.
+    """
+    pass
+
+
+@pm_clob.command("book")
+@click.argument("token_id")
+@click.pass_context
+def pm_clob_book(ctx, token_id):
+    """Get order book for a token.
+
+    Example: fastbooks polymarket clob book 48331043336612883...
+    """
+    client: FastBooksClient = ctx.obj
+    try:
+        data = client.polymarket_clob_book(token_id)
+        emit(ctx, data, lambda d: _format_clob_book(d))
+    except Exception as e:
+        emit_error(ctx, str(e))
+        ctx.exit(1)
+
+
+@pm_clob.command("price")
+@click.argument("token_id")
+@click.option("--side", type=click.Choice(["buy", "sell"]), default="buy", help="Price side.")
+@click.pass_context
+def pm_clob_price(ctx, token_id, side):
+    """Get best price for a token.
+
+    Example: fastbooks polymarket clob price TOKEN_ID --side buy
+    """
+    client: FastBooksClient = ctx.obj
+    try:
+        data = client.polymarket_clob_price(token_id, side)
+        emit(ctx, data)
+    except Exception as e:
+        emit_error(ctx, str(e))
+        ctx.exit(1)
+
+
+@pm_clob.command("midpoint")
+@click.argument("token_id")
+@click.pass_context
+def pm_clob_midpoint(ctx, token_id):
+    """Get midpoint price for a token.
+
+    Example: fastbooks polymarket clob midpoint TOKEN_ID
+    """
+    client: FastBooksClient = ctx.obj
+    try:
+        data = client.polymarket_clob_midpoint(token_id)
+        emit(ctx, data)
+    except Exception as e:
+        emit_error(ctx, str(e))
+        ctx.exit(1)
+
+
+@pm_clob.command("spread")
+@click.argument("token_id")
+@click.pass_context
+def pm_clob_spread(ctx, token_id):
+    """Get bid-ask spread for a token.
+
+    Example: fastbooks polymarket clob spread TOKEN_ID
+    """
+    client: FastBooksClient = ctx.obj
+    try:
+        data = client.polymarket_clob_spread(token_id)
+        emit(ctx, data)
+    except Exception as e:
+        emit_error(ctx, str(e))
+        ctx.exit(1)
+
+
+@pm_clob.command("last-trade")
+@click.argument("token_id")
+@click.pass_context
+def pm_clob_last_trade(ctx, token_id):
+    """Get last trade for a token.
+
+    Example: fastbooks polymarket clob last-trade TOKEN_ID
+    """
+    client: FastBooksClient = ctx.obj
+    try:
+        data = client.polymarket_clob_last_trade(token_id)
+        emit(ctx, data)
+    except Exception as e:
+        emit_error(ctx, str(e))
+        ctx.exit(1)
+
+
+@pm_clob.command("price-history")
+@click.argument("token_id")
+@click.option("--interval", type=click.Choice(["1m", "1h", "6h", "1d", "1w", "max"]), default="1d")
+@click.option("--fidelity", type=int, default=30, help="Number of data points.")
+@click.pass_context
+def pm_clob_price_history(ctx, token_id, interval, fidelity):
+    """Get price history for a token.
+
+    Examples:
+        fastbooks polymarket clob price-history TOKEN_ID --interval 1d --fidelity 30
+        fastbooks polymarket clob price-history TOKEN_ID --interval 1h
+    """
+    client: FastBooksClient = ctx.obj
+    try:
+        data = client.polymarket_clob_price_history(token_id, interval, fidelity)
+        emit(ctx, data, lambda d: _format_price_history(d))
+    except Exception as e:
+        emit_error(ctx, str(e))
+        ctx.exit(1)
+
+
+@pm_clob.command("clob-markets")
+@click.pass_context
+def pm_clob_markets(ctx):
+    """List all CLOB markets.
+
+    Example: fastbooks polymarket clob clob-markets
+    """
+    client: FastBooksClient = ctx.obj
+    try:
+        data = client.polymarket_clob_markets()
+        emit(ctx, data)
+    except Exception as e:
+        emit_error(ctx, str(e))
+        ctx.exit(1)
+
+
+@pm_clob.command("clob-market")
+@click.argument("condition_id")
+@click.pass_context
+def pm_clob_market(ctx, condition_id):
+    """Get CLOB market info by condition ID.
+
+    Example: fastbooks polymarket clob clob-market 0xABC123...
+    """
+    client: FastBooksClient = ctx.obj
+    try:
+        data = client.polymarket_clob_market(condition_id)
+        emit(ctx, data)
+    except Exception as e:
+        emit_error(ctx, str(e))
+        ctx.exit(1)
+
+
+# ── CLOB batch queries (read-only) ───────────────────────────────────
+
+@pm_clob.command("ok")
+@click.pass_context
+def pm_clob_ok(ctx):
+    """Check CLOB API health.
+
+    Example: fastbooks polymarket clob ok
+    """
+    client: FastBooksClient = ctx.obj
+    try:
+        data = client.polymarket_clob_ok()
+        emit(ctx, data)
+    except Exception as e:
+        emit_error(ctx, str(e))
+        ctx.exit(1)
+
+
+@pm_clob.command("books")
+@click.argument("token_ids", metavar="TOKEN_IDS")
+@click.pass_context
+def pm_clob_books(ctx, token_ids):
+    """Get order books for multiple tokens (comma-separated).
+
+    Example: fastbooks polymarket clob books "TOKEN1,TOKEN2"
+    """
+    client: FastBooksClient = ctx.obj
+    try:
+        data = client.polymarket_clob_books(token_ids)
+        emit(ctx, data)
+    except Exception as e:
+        emit_error(ctx, str(e))
+        ctx.exit(1)
+
+
+@pm_clob.command("batch-prices")
+@click.argument("token_ids", metavar="TOKEN_IDS")
+@click.option("--side", type=click.Choice(["buy", "sell"]), default="buy")
+@click.pass_context
+def pm_clob_batch_prices(ctx, token_ids, side):
+    """Get prices for multiple tokens (comma-separated).
+
+    Example: fastbooks polymarket clob batch-prices "TOKEN1,TOKEN2" --side buy
+    """
+    client: FastBooksClient = ctx.obj
+    try:
+        data = client.polymarket_clob_batch_prices(token_ids, side)
+        emit(ctx, data)
+    except Exception as e:
+        emit_error(ctx, str(e))
+        ctx.exit(1)
+
+
+@pm_clob.command("midpoints")
+@click.argument("token_ids", metavar="TOKEN_IDS")
+@click.pass_context
+def pm_clob_midpoints(ctx, token_ids):
+    """Get midpoints for multiple tokens (comma-separated).
+
+    Example: fastbooks polymarket clob midpoints "TOKEN1,TOKEN2"
+    """
+    client: FastBooksClient = ctx.obj
+    try:
+        data = client.polymarket_clob_midpoints(token_ids)
+        emit(ctx, data)
+    except Exception as e:
+        emit_error(ctx, str(e))
+        ctx.exit(1)
+
+
+@pm_clob.command("spreads")
+@click.argument("token_ids", metavar="TOKEN_IDS")
+@click.pass_context
+def pm_clob_spreads(ctx, token_ids):
+    """Get spreads for multiple tokens (comma-separated).
+
+    Example: fastbooks polymarket clob spreads "TOKEN1,TOKEN2"
+    """
+    client: FastBooksClient = ctx.obj
+    try:
+        data = client.polymarket_clob_spreads(token_ids)
+        emit(ctx, data)
+    except Exception as e:
+        emit_error(ctx, str(e))
+        ctx.exit(1)
+
+
+@pm_clob.command("last-trades")
+@click.argument("token_ids", metavar="TOKEN_IDS")
+@click.pass_context
+def pm_clob_last_trades(ctx, token_ids):
+    """Get last trades for multiple tokens (comma-separated).
+
+    Example: fastbooks polymarket clob last-trades "TOKEN1,TOKEN2"
+    """
+    client: FastBooksClient = ctx.obj
+    try:
+        data = client.polymarket_clob_last_trades(token_ids)
+        emit(ctx, data)
+    except Exception as e:
+        emit_error(ctx, str(e))
+        ctx.exit(1)
+
+
+@pm_clob.command("tick-size")
+@click.argument("token_id")
+@click.pass_context
+def pm_clob_tick_size(ctx, token_id):
+    """Get tick size for a token.
+
+    Example: fastbooks polymarket clob tick-size TOKEN_ID
+    """
+    client: FastBooksClient = ctx.obj
+    try:
+        data = client.polymarket_clob_tick_size(token_id)
+        emit(ctx, data)
+    except Exception as e:
+        emit_error(ctx, str(e))
+        ctx.exit(1)
+
+
+@pm_clob.command("fee-rate")
+@click.argument("token_id")
+@click.pass_context
+def pm_clob_fee_rate(ctx, token_id):
+    """Get fee rate (in bps) for a token.
+
+    Example: fastbooks polymarket clob fee-rate TOKEN_ID
+    """
+    client: FastBooksClient = ctx.obj
+    try:
+        data = client.polymarket_clob_fee_rate(token_id)
+        emit(ctx, data)
+    except Exception as e:
+        emit_error(ctx, str(e))
+        ctx.exit(1)
+
+
+@pm_clob.command("neg-risk")
+@click.argument("token_id")
+@click.pass_context
+def pm_clob_neg_risk(ctx, token_id):
+    """Get negative risk status for a token.
+
+    Example: fastbooks polymarket clob neg-risk TOKEN_ID
+    """
+    client: FastBooksClient = ctx.obj
+    try:
+        data = client.polymarket_clob_neg_risk(token_id)
+        emit(ctx, data)
+    except Exception as e:
+        emit_error(ctx, str(e))
+        ctx.exit(1)
+
+
+@pm_clob.command("time")
+@click.pass_context
+def pm_clob_time(ctx):
+    """Get CLOB server time.
+
+    Example: fastbooks polymarket clob time
+    """
+    client: FastBooksClient = ctx.obj
+    try:
+        data = client.polymarket_clob_time()
+        emit(ctx, data)
+    except Exception as e:
+        emit_error(ctx, str(e))
+        ctx.exit(1)
+
+
+@pm_clob.command("geoblock")
+@click.pass_context
+def pm_clob_geoblock(ctx):
+    """Check geoblock status.
+
+    Example: fastbooks polymarket clob geoblock
+    """
+    client: FastBooksClient = ctx.obj
+    try:
+        data = client.polymarket_clob_geoblock()
+        emit(ctx, data)
+    except Exception as e:
+        emit_error(ctx, str(e))
+        ctx.exit(1)
+
+
+# ── CLOB trading (authenticated) ─────────────────────────────────────
+
+@pm_clob.command("create-order")
+@click.option("--token", required=True, help="Token ID to trade.")
+@click.option("--side", type=click.Choice(["buy", "sell"]), required=True)
+@click.option("--price", type=float, required=True, help="Limit price (0-1).")
+@click.option("--size", type=float, required=True, help="Number of shares.")
+@click.option("--order-type", type=click.Choice(["GTC", "FOK", "GTD", "FAK"]), default="GTC")
+@click.option("--private-key", envvar="POLYMARKET_PRIVATE_KEY", default=None)
+@click.option("--confirm/--no-confirm", default=True)
+@click.pass_context
+def pm_clob_create_order(ctx, token, side, price, size, order_type, private_key, confirm):
+    """Place a limit order on Polymarket.
+
+    Examples:
+        fastbooks polymarket clob create-order --token TOKEN --side buy --price 0.50 --size 10
+        fastbooks polymarket clob create-order --token TOKEN --side sell --price 0.80 --size 5 --order-type FOK
+    """
+    client: FastBooksClient = ctx.obj
+    if not private_key:
+        emit_error(ctx, "Wallet required. Use --private-key or set POLYMARKET_PRIVATE_KEY.")
+        ctx.exit(1)
+        return
+
+    if confirm and not ctx.find_root().params.get("json_output", False):
+        click.echo(f"\n  Polymarket LIMIT {side.upper()} {size} shares @ ${price:.2f} ({order_type})")
+        click.echo(f"  Token: {token[:20]}...")
+        if not click.confirm("\n  Execute?"):
+            click.echo("  Cancelled.")
+            return
+
+    try:
+        data = client.polymarket_create_order(
+            token_id=token, side=side, price=price, size=size,
+            order_type=order_type, private_key=private_key,
+        )
+        emit(ctx, data, lambda d: _format_order_result(d))
+    except Exception as e:
+        emit_error(ctx, str(e))
+        ctx.exit(1)
+
+
+@pm_clob.command("market-order")
+@click.option("--token", required=True, help="Token ID to trade.")
+@click.option("--side", type=click.Choice(["buy", "sell"]), required=True)
+@click.option("--amount", type=float, required=True, help="Amount in USD to spend.")
+@click.option("--private-key", envvar="POLYMARKET_PRIVATE_KEY", default=None)
+@click.option("--confirm/--no-confirm", default=True)
+@click.pass_context
+def pm_clob_market_order(ctx, token, side, amount, private_key, confirm):
+    """Place a market order on Polymarket.
+
+    Examples:
+        fastbooks polymarket clob market-order --token TOKEN --side buy --amount 5
+        fastbooks polymarket clob market-order --token TOKEN --side sell --amount 10
+    """
+    client: FastBooksClient = ctx.obj
+    if not private_key:
+        emit_error(ctx, "Wallet required. Use --private-key or set POLYMARKET_PRIVATE_KEY.")
+        ctx.exit(1)
+        return
+
+    if confirm and not ctx.find_root().params.get("json_output", False):
+        click.echo(f"\n  Polymarket MARKET {side.upper()} ${amount:.2f}")
+        click.echo(f"  Token: {token[:20]}...")
+        if not click.confirm("\n  Execute?"):
+            click.echo("  Cancelled.")
+            return
+
+    try:
+        data = client.polymarket_market_order(
+            token_id=token, side=side, amount=amount, private_key=private_key,
+        )
+        emit(ctx, data, lambda d: _format_order_result(d))
+    except Exception as e:
+        emit_error(ctx, str(e))
+        ctx.exit(1)
+
+
+@pm_clob.command("cancel")
+@click.argument("order_id")
+@click.option("--private-key", envvar="POLYMARKET_PRIVATE_KEY", default=None)
+@click.pass_context
+def pm_clob_cancel(ctx, order_id, private_key):
+    """Cancel a specific order.
+
+    Example: fastbooks polymarket clob cancel ORDER_ID
+    """
+    client: FastBooksClient = ctx.obj
+    if not private_key:
+        emit_error(ctx, "Wallet required.")
+        ctx.exit(1)
+        return
+    try:
+        data = client.polymarket_cancel_order(order_id, private_key)
+        emit(ctx, data, lambda d: f"  Order {order_id} cancelled.")
+    except Exception as e:
+        emit_error(ctx, str(e))
+        ctx.exit(1)
+
+
+@pm_clob.command("cancel-all")
+@click.option("--private-key", envvar="POLYMARKET_PRIVATE_KEY", default=None)
+@click.option("--confirm/--no-confirm", default=True)
+@click.pass_context
+def pm_clob_cancel_all(ctx, private_key, confirm):
+    """Cancel all open orders.
+
+    Example: fastbooks polymarket clob cancel-all
+    """
+    client: FastBooksClient = ctx.obj
+    if not private_key:
+        emit_error(ctx, "Wallet required.")
+        ctx.exit(1)
+        return
+    if confirm and not ctx.find_root().params.get("json_output", False):
+        if not click.confirm("  Cancel ALL open orders?"):
+            click.echo("  Cancelled.")
+            return
+    try:
+        data = client.polymarket_cancel_all(private_key)
+        emit(ctx, data, lambda d: "  All orders cancelled.")
+    except Exception as e:
+        emit_error(ctx, str(e))
+        ctx.exit(1)
+
+
+@pm_clob.command("cancel-market")
+@click.argument("condition_id")
+@click.option("--private-key", envvar="POLYMARKET_PRIVATE_KEY", default=None)
+@click.pass_context
+def pm_clob_cancel_market(ctx, condition_id, private_key):
+    """Cancel all orders for a specific market.
+
+    Example: fastbooks polymarket clob cancel-market 0xCONDITION...
+    """
+    client: FastBooksClient = ctx.obj
+    if not private_key:
+        emit_error(ctx, "Wallet required.")
+        ctx.exit(1)
+        return
+    try:
+        data = client.polymarket_cancel_market(condition_id, private_key)
+        emit(ctx, data, lambda d: f"  Orders for market {condition_id[:16]}... cancelled.")
+    except Exception as e:
+        emit_error(ctx, str(e))
+        ctx.exit(1)
+
+
+@pm_clob.command("cancel-orders")
+@click.argument("order_ids", metavar="ORDER_IDS")
+@click.option("--private-key", envvar="POLYMARKET_PRIVATE_KEY", default=None)
+@click.pass_context
+def pm_clob_cancel_orders(ctx, order_ids, private_key):
+    """Cancel multiple orders (comma-separated IDs).
+
+    Example: fastbooks polymarket clob cancel-orders "ORDER1,ORDER2"
+    """
+    client: FastBooksClient = ctx.obj
+    if not private_key:
+        emit_error(ctx, "Wallet required.")
+        ctx.exit(1)
+        return
+    try:
+        data = client.polymarket_cancel_orders(order_ids, private_key)
+        emit(ctx, data, lambda d: f"  Orders cancelled.")
+    except Exception as e:
+        emit_error(ctx, str(e))
+        ctx.exit(1)
+
+
+@pm_clob.command("post-orders")
+@click.option("--tokens", required=True, help="Token IDs (comma-separated).")
+@click.option("--side", type=click.Choice(["buy", "sell"]), required=True)
+@click.option("--prices", required=True, help="Prices (comma-separated).")
+@click.option("--sizes", required=True, help="Sizes (comma-separated).")
+@click.option("--order-type", type=click.Choice(["GTC", "FOK", "GTD", "FAK"]), default="GTC")
+@click.option("--private-key", envvar="POLYMARKET_PRIVATE_KEY", default=None)
+@click.option("--confirm/--no-confirm", default=True)
+@click.pass_context
+def pm_clob_post_orders(ctx, tokens, side, prices, sizes, order_type, private_key, confirm):
+    """Post multiple orders at once.
+
+    Example: fastbooks polymarket clob post-orders --tokens "T1,T2" --side buy --prices "0.40,0.60" --sizes "10,10"
+    """
+    client: FastBooksClient = ctx.obj
+    if not private_key:
+        emit_error(ctx, "Wallet required.")
+        ctx.exit(1)
+        return
+    if confirm and not ctx.find_root().params.get("json_output", False):
+        click.echo(f"\n  Polymarket BATCH {side.upper()} ({order_type})")
+        click.echo(f"  Tokens: {tokens}")
+        click.echo(f"  Prices: {prices}")
+        click.echo(f"  Sizes:  {sizes}")
+        if not click.confirm("\n  Execute all?"):
+            click.echo("  Cancelled.")
+            return
+    try:
+        data = client.polymarket_post_orders(tokens, side, prices, sizes, order_type, private_key)
+        emit(ctx, data)
+    except Exception as e:
+        emit_error(ctx, str(e))
+        ctx.exit(1)
+
+
+# ── CLOB account queries (authenticated) ─────────────────────────────
+
+@pm_clob.command("orders")
+@click.option("--market", type=str, default=None, help="Filter by condition ID.")
+@click.option("--private-key", envvar="POLYMARKET_PRIVATE_KEY", default=None)
+@click.pass_context
+def pm_clob_orders(ctx, market, private_key):
+    """List your open orders.
+
+    Examples:
+        fastbooks polymarket clob orders
+        fastbooks polymarket clob orders --market 0xCONDITION...
+    """
+    client: FastBooksClient = ctx.obj
+    if not private_key:
+        emit_error(ctx, "Wallet required.")
+        ctx.exit(1)
+        return
+    try:
+        data = client.polymarket_orders(market, private_key)
+        emit(ctx, data, lambda d: _format_orders_list(d))
+    except Exception as e:
+        emit_error(ctx, str(e))
+        ctx.exit(1)
+
+
+@pm_clob.command("trades")
+@click.option("--private-key", envvar="POLYMARKET_PRIVATE_KEY", default=None)
+@click.pass_context
+def pm_clob_trades(ctx, private_key):
+    """List your recent trades.
+
+    Example: fastbooks polymarket clob trades
+    """
+    client: FastBooksClient = ctx.obj
+    if not private_key:
+        emit_error(ctx, "Wallet required.")
+        ctx.exit(1)
+        return
+    try:
+        data = client.polymarket_trades(private_key)
+        emit(ctx, data, lambda d: _format_trades_list(d))
+    except Exception as e:
+        emit_error(ctx, str(e))
+        ctx.exit(1)
+
+
+@pm_clob.command("balance")
+@click.option("--asset-type", type=click.Choice(["collateral", "conditional"]), default="collateral")
+@click.option("--token", type=str, default=None, help="Token ID (for conditional balance).")
+@click.option("--private-key", envvar="POLYMARKET_PRIVATE_KEY", default=None)
+@click.pass_context
+def pm_clob_balance(ctx, asset_type, token, private_key):
+    """Check your Polymarket balance.
+
+    Examples:
+        fastbooks polymarket clob balance --asset-type collateral
+        fastbooks polymarket clob balance --asset-type conditional --token TOKEN_ID
+    """
+    client: FastBooksClient = ctx.obj
+    if not private_key:
+        emit_error(ctx, "Wallet required.")
+        ctx.exit(1)
+        return
+    try:
+        data = client.polymarket_balance(asset_type, token, private_key)
+        emit(ctx, data, lambda d: _format_balance(d))
+    except Exception as e:
+        emit_error(ctx, str(e))
+        ctx.exit(1)
+
+
+@pm_clob.command("order")
+@click.argument("order_id")
+@click.option("--private-key", envvar="POLYMARKET_PRIVATE_KEY", default=None)
+@click.pass_context
+def pm_clob_order_get(ctx, order_id, private_key):
+    """Get a single order by ID.
+
+    Example: fastbooks polymarket clob order ORDER_ID
+    """
+    client: FastBooksClient = ctx.obj
+    if not private_key:
+        emit_error(ctx, "Wallet required.")
+        ctx.exit(1)
+        return
+    try:
+        data = client.polymarket_order_get(order_id, private_key)
+        emit(ctx, data, lambda d: _format_order_result(d))
+    except Exception as e:
+        emit_error(ctx, str(e))
+        ctx.exit(1)
+
+
+@pm_clob.command("update-balance")
+@click.option("--asset-type", type=click.Choice(["collateral", "conditional"]), default="collateral")
+@click.option("--token", type=str, default=None, help="Token ID (for conditional).")
+@click.option("--private-key", envvar="POLYMARKET_PRIVATE_KEY", default=None)
+@click.pass_context
+def pm_clob_update_balance(ctx, asset_type, token, private_key):
+    """Refresh balance from on-chain.
+
+    Example: fastbooks polymarket clob update-balance --asset-type collateral
+    """
+    client: FastBooksClient = ctx.obj
+    if not private_key:
+        emit_error(ctx, "Wallet required.")
+        ctx.exit(1)
+        return
+    try:
+        data = client.polymarket_update_balance(asset_type, token, private_key)
+        emit(ctx, data)
+    except Exception as e:
+        emit_error(ctx, str(e))
+        ctx.exit(1)
+
+
+# ── CLOB rewards & API keys (authenticated) ──────────────────────────
+
+@pm_clob.command("rewards")
+@click.option("--date", required=True, help="Date (YYYY-MM-DD).")
+@click.option("--private-key", envvar="POLYMARKET_PRIVATE_KEY", default=None)
+@click.pass_context
+def pm_clob_rewards(ctx, date, private_key):
+    """List earnings for a date.
+
+    Example: fastbooks polymarket clob rewards --date 2024-06-15
+    """
+    client: FastBooksClient = ctx.obj
+    if not private_key:
+        emit_error(ctx, "Wallet required.")
+        ctx.exit(1)
+        return
+    try:
+        data = client.polymarket_rewards(date, private_key)
+        emit(ctx, data)
+    except Exception as e:
+        emit_error(ctx, str(e))
+        ctx.exit(1)
+
+
+@pm_clob.command("earnings")
+@click.option("--date", required=True, help="Date (YYYY-MM-DD).")
+@click.option("--private-key", envvar="POLYMARKET_PRIVATE_KEY", default=None)
+@click.pass_context
+def pm_clob_earnings(ctx, date, private_key):
+    """Get total earnings for a date.
+
+    Example: fastbooks polymarket clob earnings --date 2024-06-15
+    """
+    client: FastBooksClient = ctx.obj
+    if not private_key:
+        emit_error(ctx, "Wallet required.")
+        ctx.exit(1)
+        return
+    try:
+        data = client.polymarket_earnings(date, private_key)
+        emit(ctx, data)
+    except Exception as e:
+        emit_error(ctx, str(e))
+        ctx.exit(1)
+
+
+@pm_clob.command("earnings-markets")
+@click.option("--date", required=True, help="Date (YYYY-MM-DD).")
+@click.option("--private-key", envvar="POLYMARKET_PRIVATE_KEY", default=None)
+@click.pass_context
+def pm_clob_earnings_markets(ctx, date, private_key):
+    """Get earnings with market configs for a date.
+
+    Example: fastbooks polymarket clob earnings-markets --date 2024-06-15
+    """
+    client: FastBooksClient = ctx.obj
+    if not private_key:
+        emit_error(ctx, "Wallet required.")
+        ctx.exit(1)
+        return
+    try:
+        data = client.polymarket_earnings_markets(date, private_key)
+        emit(ctx, data)
+    except Exception as e:
+        emit_error(ctx, str(e))
+        ctx.exit(1)
+
+
+@pm_clob.command("reward-percentages")
+@click.pass_context
+def pm_clob_reward_percentages(ctx):
+    """Get reward percentages.
+
+    Example: fastbooks polymarket clob reward-percentages
+    """
+    client: FastBooksClient = ctx.obj
+    try:
+        data = client.polymarket_reward_percentages()
+        emit(ctx, data)
+    except Exception as e:
+        emit_error(ctx, str(e))
+        ctx.exit(1)
+
+
+@pm_clob.command("current-rewards")
+@click.pass_context
+def pm_clob_current_rewards(ctx):
+    """List current reward programs.
+
+    Example: fastbooks polymarket clob current-rewards
+    """
+    client: FastBooksClient = ctx.obj
+    try:
+        data = client.polymarket_current_rewards()
+        emit(ctx, data)
+    except Exception as e:
+        emit_error(ctx, str(e))
+        ctx.exit(1)
+
+
+@pm_clob.command("market-reward")
+@click.argument("condition_id")
+@click.pass_context
+def pm_clob_market_reward(ctx, condition_id):
+    """Get reward details for a market.
+
+    Example: fastbooks polymarket clob market-reward 0xCONDITION...
+    """
+    client: FastBooksClient = ctx.obj
+    try:
+        data = client.polymarket_market_reward(condition_id)
+        emit(ctx, data)
+    except Exception as e:
+        emit_error(ctx, str(e))
+        ctx.exit(1)
+
+
+@pm_clob.command("order-scoring")
+@click.argument("order_id")
+@click.option("--private-key", envvar="POLYMARKET_PRIVATE_KEY", default=None)
+@click.pass_context
+def pm_clob_order_scoring(ctx, order_id, private_key):
+    """Check if an order is scoring rewards.
+
+    Example: fastbooks polymarket clob order-scoring ORDER_ID
+    """
+    client: FastBooksClient = ctx.obj
+    try:
+        data = client.polymarket_order_scoring(order_id, private_key)
+        emit(ctx, data)
+    except Exception as e:
+        emit_error(ctx, str(e))
+        ctx.exit(1)
+
+
+@pm_clob.command("orders-scoring")
+@click.argument("order_ids", metavar="ORDER_IDS")
+@click.option("--private-key", envvar="POLYMARKET_PRIVATE_KEY", default=None)
+@click.pass_context
+def pm_clob_orders_scoring(ctx, order_ids, private_key):
+    """Check multiple orders for reward scoring (comma-separated).
+
+    Example: fastbooks polymarket clob orders-scoring "ORDER1,ORDER2"
+    """
+    client: FastBooksClient = ctx.obj
+    try:
+        data = client.polymarket_orders_scoring(order_ids, private_key)
+        emit(ctx, data)
+    except Exception as e:
+        emit_error(ctx, str(e))
+        ctx.exit(1)
+
+
+@pm_clob.command("api-keys")
+@click.option("--private-key", envvar="POLYMARKET_PRIVATE_KEY", default=None)
+@click.pass_context
+def pm_clob_api_keys(ctx, private_key):
+    """List your API keys.
+
+    Example: fastbooks polymarket clob api-keys
+    """
+    client: FastBooksClient = ctx.obj
+    if not private_key:
+        emit_error(ctx, "Wallet required.")
+        ctx.exit(1)
+        return
+    try:
+        data = client.polymarket_api_keys(private_key)
+        emit(ctx, data)
+    except Exception as e:
+        emit_error(ctx, str(e))
+        ctx.exit(1)
+
+
+@pm_clob.command("create-api-key")
+@click.option("--private-key", envvar="POLYMARKET_PRIVATE_KEY", default=None)
+@click.pass_context
+def pm_clob_create_api_key(ctx, private_key):
+    """Create or derive a new API key.
+
+    Example: fastbooks polymarket clob create-api-key
+    """
+    client: FastBooksClient = ctx.obj
+    if not private_key:
+        emit_error(ctx, "Wallet required.")
+        ctx.exit(1)
+        return
+    try:
+        data = client.polymarket_create_api_key(private_key)
+        emit(ctx, data)
+    except Exception as e:
+        emit_error(ctx, str(e))
+        ctx.exit(1)
+
+
+@pm_clob.command("delete-api-key")
+@click.option("--private-key", envvar="POLYMARKET_PRIVATE_KEY", default=None)
+@click.option("--confirm/--no-confirm", default=True)
+@click.pass_context
+def pm_clob_delete_api_key(ctx, private_key, confirm):
+    """Delete current API key.
+
+    Example: fastbooks polymarket clob delete-api-key
+    """
+    client: FastBooksClient = ctx.obj
+    if not private_key:
+        emit_error(ctx, "Wallet required.")
+        ctx.exit(1)
+        return
+    if confirm and not ctx.find_root().params.get("json_output", False):
+        if not click.confirm("  Delete API key?"):
+            click.echo("  Cancelled.")
+            return
+    try:
+        data = client.polymarket_delete_api_key(private_key)
+        emit(ctx, data, lambda d: "  API key deleted.")
+    except Exception as e:
+        emit_error(ctx, str(e))
+        ctx.exit(1)
+
+
+@pm_clob.command("account-status")
+@click.option("--private-key", envvar="POLYMARKET_PRIVATE_KEY", default=None)
+@click.pass_context
+def pm_clob_account_status(ctx, private_key):
+    """Check account status.
+
+    Example: fastbooks polymarket clob account-status
+    """
+    client: FastBooksClient = ctx.obj
+    if not private_key:
+        emit_error(ctx, "Wallet required.")
+        ctx.exit(1)
+        return
+    try:
+        data = client.polymarket_account_status(private_key)
+        emit(ctx, data)
+    except Exception as e:
+        emit_error(ctx, str(e))
+        ctx.exit(1)
+
+
+@pm_clob.command("notifications")
+@click.option("--private-key", envvar="POLYMARKET_PRIVATE_KEY", default=None)
+@click.pass_context
+def pm_clob_notifications(ctx, private_key):
+    """List notifications.
+
+    Example: fastbooks polymarket clob notifications
+    """
+    client: FastBooksClient = ctx.obj
+    if not private_key:
+        emit_error(ctx, "Wallet required.")
+        ctx.exit(1)
+        return
+    try:
+        data = client.polymarket_notifications(private_key)
+        emit(ctx, data)
+    except Exception as e:
+        emit_error(ctx, str(e))
+        ctx.exit(1)
+
+
+@pm_clob.command("delete-notifications")
+@click.argument("notification_ids", metavar="NOTIFICATION_IDS")
+@click.option("--private-key", envvar="POLYMARKET_PRIVATE_KEY", default=None)
+@click.pass_context
+def pm_clob_delete_notifications(ctx, notification_ids, private_key):
+    """Delete notifications (comma-separated IDs).
+
+    Example: fastbooks polymarket clob delete-notifications "NOTIF1,NOTIF2"
+    """
+    client: FastBooksClient = ctx.obj
+    if not private_key:
+        emit_error(ctx, "Wallet required.")
+        ctx.exit(1)
+        return
+    try:
+        data = client.polymarket_delete_notifications(notification_ids, private_key)
+        emit(ctx, data, lambda d: "  Notifications deleted.")
+    except Exception as e:
+        emit_error(ctx, str(e))
+        ctx.exit(1)
+
+
+# ══════════════════════════════════════════════════════════════════════════
+# Data — on-chain portfolio & leaderboards (public, no wallet)
+# ══════════════════════════════════════════════════════════════════════════
+
+@polymarket.group("data")
+def pm_data():
+    """On-chain data: positions, portfolio value, trades, leaderboards."""
+    pass
+
+
+@pm_data.command("positions")
+@click.argument("address")
+@click.pass_context
+def pm_data_positions(ctx, address):
+    """View positions for a wallet address.
+
+    Example: fastbooks polymarket data positions 0xWALLET_ADDRESS
+    """
+    client: FastBooksClient = ctx.obj
+    try:
+        data = client.polymarket_data_positions(address)
+        emit(ctx, data, lambda d: _format_positions(d))
+    except Exception as e:
+        emit_error(ctx, str(e))
+        ctx.exit(1)
+
+
+@pm_data.command("value")
+@click.argument("address")
+@click.pass_context
+def pm_data_value(ctx, address):
+    """Get portfolio value for a wallet address.
+
+    Example: fastbooks polymarket data value 0xWALLET_ADDRESS
+    """
+    client: FastBooksClient = ctx.obj
+    try:
+        data = client.polymarket_data_value(address)
+        emit(ctx, data)
+    except Exception as e:
+        emit_error(ctx, str(e))
+        ctx.exit(1)
+
+
+@pm_data.command("trades")
+@click.argument("address")
+@click.option("--limit", "-n", type=int, default=50)
+@click.pass_context
+def pm_data_trades(ctx, address, limit):
+    """View trade history for a wallet address.
+
+    Example: fastbooks polymarket data trades 0xWALLET_ADDRESS --limit 20
+    """
+    client: FastBooksClient = ctx.obj
+    try:
+        data = client.polymarket_data_trades(address, limit)
+        emit(ctx, data, lambda d: _format_trades_list(d))
+    except Exception as e:
+        emit_error(ctx, str(e))
+        ctx.exit(1)
+
+
+@pm_data.command("leaderboard")
+@click.option("--period", type=click.Choice(["day", "week", "month", "all"]), default="month")
+@click.option("--order-by", type=click.Choice(["pnl", "volume", "markets_traded"]), default="pnl")
+@click.option("--limit", "-n", type=int, default=20)
+@click.pass_context
+def pm_data_leaderboard(ctx, period, order_by, limit):
+    """View the Polymarket leaderboard.
+
+    Examples:
+        fastbooks polymarket data leaderboard --period month --order-by pnl
+        fastbooks polymarket data leaderboard --period week --limit 10
+    """
+    client: FastBooksClient = ctx.obj
+    try:
+        data = client.polymarket_data_leaderboard(period, order_by, limit)
+        emit(ctx, data, lambda d: _format_leaderboard(d))
+    except Exception as e:
+        emit_error(ctx, str(e))
+        ctx.exit(1)
+
+
+@pm_data.command("closed-positions")
+@click.argument("address")
+@click.option("--limit", "-n", type=int, default=25)
+@click.option("--offset", type=int, default=0)
+@click.pass_context
+def pm_data_closed_positions(ctx, address, limit, offset):
+    """View closed positions for a wallet.
+
+    Example: fastbooks polymarket data closed-positions 0xWALLET
+    """
+    client: FastBooksClient = ctx.obj
+    try:
+        data = client.polymarket_data_closed_positions(address, limit, offset)
+        emit(ctx, data, lambda d: _format_positions(d))
+    except Exception as e:
+        emit_error(ctx, str(e))
+        ctx.exit(1)
+
+
+@pm_data.command("traded")
+@click.argument("address")
+@click.pass_context
+def pm_data_traded(ctx, address):
+    """Get count of unique markets traded by a wallet.
+
+    Example: fastbooks polymarket data traded 0xWALLET
+    """
+    client: FastBooksClient = ctx.obj
+    try:
+        data = client.polymarket_data_traded(address)
+        emit(ctx, data)
+    except Exception as e:
+        emit_error(ctx, str(e))
+        ctx.exit(1)
+
+
+@pm_data.command("activity")
+@click.argument("address")
+@click.option("--limit", "-n", type=int, default=25)
+@click.option("--offset", type=int, default=0)
+@click.pass_context
+def pm_data_activity(ctx, address, limit, offset):
+    """View on-chain activity for a wallet.
+
+    Example: fastbooks polymarket data activity 0xWALLET
+    """
+    client: FastBooksClient = ctx.obj
+    try:
+        data = client.polymarket_data_activity(address, limit, offset)
+        emit(ctx, data)
+    except Exception as e:
+        emit_error(ctx, str(e))
+        ctx.exit(1)
+
+
+@pm_data.command("holders")
+@click.argument("condition_id")
+@click.option("--limit", "-n", type=int, default=10)
+@click.pass_context
+def pm_data_holders(ctx, condition_id, limit):
+    """Get top token holders for a market.
+
+    Example: fastbooks polymarket data holders 0xCONDITION_ID
+    """
+    client: FastBooksClient = ctx.obj
+    try:
+        data = client.polymarket_data_holders(condition_id, limit)
+        emit(ctx, data)
+    except Exception as e:
+        emit_error(ctx, str(e))
+        ctx.exit(1)
+
+
+@pm_data.command("open-interest")
+@click.argument("condition_id")
+@click.pass_context
+def pm_data_open_interest(ctx, condition_id):
+    """Get open interest for a market.
+
+    Example: fastbooks polymarket data open-interest 0xCONDITION_ID
+    """
+    client: FastBooksClient = ctx.obj
+    try:
+        data = client.polymarket_data_open_interest(condition_id)
+        emit(ctx, data)
+    except Exception as e:
+        emit_error(ctx, str(e))
+        ctx.exit(1)
+
+
+@pm_data.command("volume")
+@click.argument("event_id")
+@click.pass_context
+def pm_data_volume(ctx, event_id):
+    """Get live volume for an event.
+
+    Example: fastbooks polymarket data volume 12345
+    """
+    client: FastBooksClient = ctx.obj
+    try:
+        data = client.polymarket_data_volume(event_id)
+        emit(ctx, data)
+    except Exception as e:
+        emit_error(ctx, str(e))
+        ctx.exit(1)
+
+
+@pm_data.command("builder-leaderboard")
+@click.option("--period", type=click.Choice(["day", "week", "month", "all"]), default="month")
+@click.option("--limit", "-n", type=int, default=25)
+@click.option("--offset", type=int, default=0)
+@click.pass_context
+def pm_data_builder_leaderboard(ctx, period, limit, offset):
+    """View builder leaderboard.
+
+    Example: fastbooks polymarket data builder-leaderboard --period week
+    """
+    client: FastBooksClient = ctx.obj
+    try:
+        data = client.polymarket_data_builder_leaderboard(period, limit, offset)
+        emit(ctx, data)
+    except Exception as e:
+        emit_error(ctx, str(e))
+        ctx.exit(1)
+
+
+@pm_data.command("builder-volume")
+@click.option("--period", type=click.Choice(["day", "week", "month", "all"]), default="month")
+@click.pass_context
+def pm_data_builder_volume(ctx, period):
+    """Get builder volume time-series.
+
+    Example: fastbooks polymarket data builder-volume --period month
+    """
+    client: FastBooksClient = ctx.obj
+    try:
+        data = client.polymarket_data_builder_volume(period)
+        emit(ctx, data)
+    except Exception as e:
+        emit_error(ctx, str(e))
+        ctx.exit(1)
+
+
+# ══════════════════════════════════════════════════════════════════════════
+# CTF — Conditional Token Framework (on-chain, authenticated)
+# ══════════════════════════════════════════════════════════════════════════
+
+@polymarket.group("ctf")
+def pm_ctf():
+    """CTF token operations: split, merge, redeem conditional tokens on-chain.
+
+    Requires MATIC for gas on Polygon. Amounts are in USDC.
+    """
+    pass
+
+
+@pm_ctf.command("split")
+@click.option("--condition", required=True, help="Condition ID.")
+@click.option("--amount", type=float, required=True, help="Amount in USDC to split.")
+@click.option("--private-key", envvar="POLYMARKET_PRIVATE_KEY", default=None)
+@click.option("--confirm/--no-confirm", default=True)
+@click.pass_context
+def pm_ctf_split(ctx, condition, amount, private_key, confirm):
+    """Split USDC into YES/NO conditional tokens.
+
+    Example: fastbooks polymarket ctf split --condition 0xCOND... --amount 10
+    """
+    client: FastBooksClient = ctx.obj
+    if not private_key:
+        emit_error(ctx, "Wallet required.")
+        ctx.exit(1)
+        return
+    if confirm and not ctx.find_root().params.get("json_output", False):
+        click.echo(f"\n  Split ${amount} USDC into YES/NO tokens")
+        click.echo(f"  Condition: {condition[:20]}...")
+        if not click.confirm("\n  Execute? (requires MATIC for gas)"):
+            click.echo("  Cancelled.")
+            return
+    try:
+        data = client.polymarket_ctf_split(condition, amount, private_key)
+        emit(ctx, data, lambda d: f"  Split complete. Tx: {d.get('txHash', '?')}")
+    except Exception as e:
+        emit_error(ctx, str(e))
+        ctx.exit(1)
+
+
+@pm_ctf.command("merge")
+@click.option("--condition", required=True, help="Condition ID.")
+@click.option("--amount", type=float, required=True, help="Amount to merge back to USDC.")
+@click.option("--private-key", envvar="POLYMARKET_PRIVATE_KEY", default=None)
+@click.option("--confirm/--no-confirm", default=True)
+@click.pass_context
+def pm_ctf_merge(ctx, condition, amount, private_key, confirm):
+    """Merge YES/NO tokens back into USDC.
+
+    Example: fastbooks polymarket ctf merge --condition 0xCOND... --amount 10
+    """
+    client: FastBooksClient = ctx.obj
+    if not private_key:
+        emit_error(ctx, "Wallet required.")
+        ctx.exit(1)
+        return
+    if confirm and not ctx.find_root().params.get("json_output", False):
+        click.echo(f"\n  Merge ${amount} YES/NO tokens back to USDC")
+        if not click.confirm("\n  Execute?"):
+            click.echo("  Cancelled.")
+            return
+    try:
+        data = client.polymarket_ctf_merge(condition, amount, private_key)
+        emit(ctx, data, lambda d: f"  Merge complete. Tx: {d.get('txHash', '?')}")
+    except Exception as e:
+        emit_error(ctx, str(e))
+        ctx.exit(1)
+
+
+@pm_ctf.command("redeem")
+@click.option("--condition", required=True, help="Condition ID (resolved market).")
+@click.option("--private-key", envvar="POLYMARKET_PRIVATE_KEY", default=None)
+@click.option("--confirm/--no-confirm", default=True)
+@click.pass_context
+def pm_ctf_redeem(ctx, condition, private_key, confirm):
+    """Redeem winning tokens after market resolution.
+
+    Example: fastbooks polymarket ctf redeem --condition 0xCOND...
+    """
+    client: FastBooksClient = ctx.obj
+    if not private_key:
+        emit_error(ctx, "Wallet required.")
+        ctx.exit(1)
+        return
+    if confirm and not ctx.find_root().params.get("json_output", False):
+        click.echo(f"\n  Redeem winning tokens for condition {condition[:20]}...")
+        if not click.confirm("\n  Execute?"):
+            click.echo("  Cancelled.")
+            return
+    try:
+        data = client.polymarket_ctf_redeem(condition, private_key)
+        emit(ctx, data, lambda d: f"  Redemption complete. Tx: {d.get('txHash', '?')}")
+    except Exception as e:
+        emit_error(ctx, str(e))
+        ctx.exit(1)
+
+
+@pm_ctf.command("redeem-neg-risk")
+@click.option("--condition", required=True, help="Condition ID.")
+@click.option("--amounts", required=True, help="Amounts (comma-separated).")
+@click.option("--private-key", envvar="POLYMARKET_PRIVATE_KEY", default=None)
+@click.option("--confirm/--no-confirm", default=True)
+@click.pass_context
+def pm_ctf_redeem_neg_risk(ctx, condition, amounts, private_key, confirm):
+    """Redeem neg-risk positions.
+
+    Example: fastbooks polymarket ctf redeem-neg-risk --condition 0xCOND... --amounts "10,5"
+    """
+    client: FastBooksClient = ctx.obj
+    if not private_key:
+        emit_error(ctx, "Wallet required.")
+        ctx.exit(1)
+        return
+    if confirm and not ctx.find_root().params.get("json_output", False):
+        click.echo(f"\n  Redeem neg-risk for {condition[:20]}... amounts: {amounts}")
+        if not click.confirm("\n  Execute?"):
+            click.echo("  Cancelled.")
+            return
+    try:
+        data = client.polymarket_ctf_redeem_neg_risk(condition, amounts, private_key)
+        emit(ctx, data, lambda d: f"  Neg-risk redemption complete. Tx: {d.get('txHash', '?')}")
+    except Exception as e:
+        emit_error(ctx, str(e))
+        ctx.exit(1)
+
+
+@pm_ctf.command("condition-id")
+@click.option("--oracle", required=True, help="Oracle address.")
+@click.option("--question", required=True, help="Question ID.")
+@click.option("--outcomes", required=True, type=int, help="Number of outcomes.")
+@click.pass_context
+def pm_ctf_condition_id(ctx, oracle, question, outcomes):
+    """Calculate condition ID (read-only).
+
+    Example: fastbooks polymarket ctf condition-id --oracle 0xORACLE... --question 0xQUESTION... --outcomes 2
+    """
+    client: FastBooksClient = ctx.obj
+    try:
+        data = client.polymarket_ctf_condition_id(oracle, question, outcomes)
+        emit(ctx, data)
+    except Exception as e:
+        emit_error(ctx, str(e))
+        ctx.exit(1)
+
+
+@pm_ctf.command("collection-id")
+@click.option("--condition", required=True, help="Condition ID.")
+@click.option("--index-set", required=True, type=int, help="Index set.")
+@click.option("--parent-collection", default=None, help="Parent collection ID.")
+@click.pass_context
+def pm_ctf_collection_id(ctx, condition, index_set, parent_collection):
+    """Calculate collection ID (read-only).
+
+    Example: fastbooks polymarket ctf collection-id --condition 0xCOND... --index-set 1
+    """
+    client: FastBooksClient = ctx.obj
+    try:
+        data = client.polymarket_ctf_collection_id(condition, index_set, parent_collection)
+        emit(ctx, data)
+    except Exception as e:
+        emit_error(ctx, str(e))
+        ctx.exit(1)
+
+
+@pm_ctf.command("position-id")
+@click.option("--collateral", required=True, help="Collateral address.")
+@click.option("--collection", required=True, help="Collection ID.")
+@click.pass_context
+def pm_ctf_position_id(ctx, collateral, collection):
+    """Calculate position ID (read-only).
+
+    Example: fastbooks polymarket ctf position-id --collateral 0xUSDC... --collection 0xCOLL...
+    """
+    client: FastBooksClient = ctx.obj
+    try:
+        data = client.polymarket_ctf_position_id(collateral, collection)
+        emit(ctx, data)
+    except Exception as e:
+        emit_error(ctx, str(e))
+        ctx.exit(1)
+
+
+# ══════════════════════════════════════════════════════════════════════════
+# Approve — contract approvals
+# ══════════════════════════════════════════════════════════════════════════
+
+@polymarket.group("approve")
+def pm_approve():
+    """Manage Polymarket contract approvals (ERC-20 & ERC-1155)."""
+    pass
+
+
+@pm_approve.command("check")
+@click.option("--address", type=str, default=None, help="Address to check (defaults to your wallet).")
+@click.pass_context
+def pm_approve_check(ctx, address):
+    """Check current contract approval status.
+
+    Example: fastbooks polymarket approve check
+    """
+    client: FastBooksClient = ctx.obj
+    try:
+        data = client.polymarket_approve_check(address)
+        emit(ctx, data)
+    except Exception as e:
+        emit_error(ctx, str(e))
+        ctx.exit(1)
+
+
+@pm_approve.command("set")
+@click.option("--private-key", envvar="POLYMARKET_PRIVATE_KEY", default=None)
+@click.option("--confirm/--no-confirm", default=True)
+@click.pass_context
+def pm_approve_set(ctx, private_key, confirm):
+    """Approve all Polymarket contracts (sends on-chain transactions).
+
+    Requires MATIC for gas. Sends 6 approval transactions.
+
+    Example: fastbooks polymarket approve set
+    """
+    client: FastBooksClient = ctx.obj
+    if not private_key:
+        emit_error(ctx, "Wallet required.")
+        ctx.exit(1)
+        return
+    if confirm and not ctx.find_root().params.get("json_output", False):
+        click.echo("\n  This will send 6 approval transactions on Polygon.")
+        click.echo("  Requires MATIC for gas fees.")
+        if not click.confirm("\n  Proceed?"):
+            click.echo("  Cancelled.")
+            return
+    try:
+        data = client.polymarket_approve_set(private_key)
+        emit(ctx, data, lambda d: "  All contracts approved.")
+    except Exception as e:
+        emit_error(ctx, str(e))
+        ctx.exit(1)
+
+
+# ══════════════════════════════════════════════════════════════════════════
+# Bridge — deposit assets from other chains
+# ══════════════════════════════════════════════════════════════════════════
+
+@polymarket.group("bridge")
+def pm_bridge():
+    """Bridge assets into Polymarket from other chains."""
+    pass
+
+
+@pm_bridge.command("deposit")
+@click.argument("address")
+@click.pass_context
+def pm_bridge_deposit(ctx, address):
+    """Get deposit addresses for a wallet (EVM, Solana, Bitcoin).
+
+    Example: fastbooks polymarket bridge deposit 0xWALLET...
+    """
+    client: FastBooksClient = ctx.obj
+    try:
+        data = client.polymarket_bridge_deposit(address)
+        emit(ctx, data)
+    except Exception as e:
+        emit_error(ctx, str(e))
+        ctx.exit(1)
+
+
+@pm_bridge.command("supported-assets")
+@click.pass_context
+def pm_bridge_supported_assets(ctx):
+    """List supported chains and tokens for bridging.
+
+    Example: fastbooks polymarket bridge supported-assets
+    """
+    client: FastBooksClient = ctx.obj
+    try:
+        data = client.polymarket_bridge_supported_assets()
+        emit(ctx, data)
+    except Exception as e:
+        emit_error(ctx, str(e))
+        ctx.exit(1)
+
+
+@pm_bridge.command("status")
+@click.argument("deposit_address")
+@click.pass_context
+def pm_bridge_status(ctx, deposit_address):
+    """Check deposit status.
+
+    Example: fastbooks polymarket bridge status 0xDEPOSIT_ADDRESS
+    """
+    client: FastBooksClient = ctx.obj
+    try:
+        data = client.polymarket_bridge_status(deposit_address)
+        emit(ctx, data)
+    except Exception as e:
+        emit_error(ctx, str(e))
+        ctx.exit(1)
+
+
+# ══════════════════════════════════════════════════════════════════════════
+# Formatters
+# ══════════════════════════════════════════════════════════════════════════
+
+def _format_markets_list(data) -> str:
+    items = data if isinstance(data, list) else data.get("data", data.get("markets", []))
+    if not isinstance(items, list) or not items:
+        return str(data)
+    return format_table(
+        items[:30],
+        ["question", "outcomePrices", "volume", "liquidity", "active"],
+        ["Question", "Price (Yes/No)", "Volume", "Liquidity", "Active"],
+    )
+
+
+def _format_market_detail(data: dict) -> str:
+    d = data.get("data", data)
+    lines = [
+        "",
+        f"  {d.get('question', '?')}",
+        f"  ──────────────────────────────────",
+    ]
+    if d.get("outcomePrices"):
+        prices = d["outcomePrices"]
+        if isinstance(prices, list) and len(prices) >= 2:
+            lines.append(f"  Yes: {prices[0]}  |  No: {prices[1]}")
+    for field in ["volume", "liquidity", "startDate", "endDate", "active", "closed"]:
+        if field in d:
+            lines.append(f"  {field.replace('_', ' ').title()}: {d[field]}")
+    if d.get("description"):
+        lines.append(f"\n  {d['description'][:200]}")
+    return "\n".join(lines)
+
+
+def _format_events_list(data) -> str:
+    items = data if isinstance(data, list) else data.get("data", data.get("events", []))
+    if not isinstance(items, list) or not items:
+        return str(data)
+    return format_table(
+        items[:30],
+        ["title", "volume", "liquidity", "active", "marketsCount"],
+        ["Event", "Volume", "Liquidity", "Active", "Markets"],
+    )
+
+
+def _format_event_detail(data: dict) -> str:
+    d = data.get("data", data)
+    lines = [
+        "",
+        f"  {d.get('title', '?')}",
+        f"  ──────────────────────────────────",
+    ]
+    for field in ["volume", "liquidity", "active", "closed", "startDate", "endDate"]:
+        if field in d:
+            lines.append(f"  {field.title()}: {d[field]}")
+    markets = d.get("markets", [])
+    if markets:
+        lines.append(f"\n  Markets ({len(markets)}):")
+        for m in markets[:10]:
+            q = m.get("question", "?")
+            p = m.get("outcomePrices", ["?", "?"])
+            lines.append(f"    • {q}  [{p[0] if isinstance(p, list) else p}]")
+    return "\n".join(lines)
+
+
+def _format_clob_book(data: dict) -> str:
+    lines = []
+    ob = data.get("data", data)
+    lines.append("")
+    if ob.get("market"):
+        lines.append(f"  Market: {ob['market']}")
+    lines.append("")
+    asks = ob.get("asks", [])[:8]
+    bids = ob.get("bids", [])[:8]
+    lines.append("  ASKS:")
+    for entry in reversed(asks):
+        price = entry.get("price", entry[0] if isinstance(entry, list) else "?")
+        size = entry.get("size", entry[1] if isinstance(entry, list) else "?")
+        lines.append(f"    {price:>10}  {size:>12}")
+    lines.append("  ─────────────────────────")
+    lines.append("  BIDS:")
+    for entry in bids:
+        price = entry.get("price", entry[0] if isinstance(entry, list) else "?")
+        size = entry.get("size", entry[1] if isinstance(entry, list) else "?")
+        lines.append(f"    {price:>10}  {size:>12}")
+    return "\n".join(lines)
+
+
+def _format_price_history(data) -> str:
+    items = data if isinstance(data, list) else data.get("history", data.get("data", []))
+    if not isinstance(items, list) or not items:
+        return str(data)
+    return format_table(
+        items[:30],
+        ["t", "p"],
+        ["Time", "Price"],
+    )
+
+
+def _format_order_result(data: dict) -> str:
+    d = data.get("data", data)
+    lines = ["\n  Polymarket Order"]
+    if d.get("orderID") or d.get("id"):
+        lines.append(f"  ID: {d.get('orderID', d.get('id', '?'))}")
+    if d.get("status"):
+        lines.append(f"  Status: {d['status']}")
+    if d.get("side"):
+        lines.append(f"  Side: {d['side']}")
+    if d.get("price"):
+        lines.append(f"  Price: {d['price']}")
+    if d.get("size") or d.get("original_size"):
+        lines.append(f"  Size: {d.get('size', d.get('original_size', '?'))}")
+    return "\n".join(lines)
+
+
+def _format_orders_list(data) -> str:
+    items = data if isinstance(data, list) else data.get("data", data.get("orders", []))
+    if not isinstance(items, list) or not items:
+        return "  No open orders."
+    return format_table(
+        items[:30],
+        ["id", "side", "price", "original_size", "size_matched", "status", "market"],
+        ["ID", "Side", "Price", "Size", "Filled", "Status", "Market"],
+    )
+
+
+def _format_trades_list(data) -> str:
+    items = data if isinstance(data, list) else data.get("data", data.get("trades", []))
+    if not isinstance(items, list) or not items:
+        return "  No trades."
+    return format_table(
+        items[:30],
+        ["id", "side", "price", "size", "market", "timestamp"],
+        ["ID", "Side", "Price", "Size", "Market", "Time"],
+    )
+
+
+def _format_balance(data: dict) -> str:
+    d = data.get("data", data)
+    lines = ["\n  Polymarket Balance"]
+    if isinstance(d, dict):
+        for k, v in d.items():
+            lines.append(f"  {k}: {v}")
+    else:
+        lines.append(f"  {d}")
+    return "\n".join(lines)
+
+
+def _format_positions(data) -> str:
+    items = data if isinstance(data, list) else data.get("data", data.get("positions", []))
+    if not isinstance(items, list) or not items:
+        return "  No positions."
+    return format_table(
+        items[:30],
+        ["market", "outcome", "size", "avgPrice", "currentPrice", "pnl"],
+        ["Market", "Outcome", "Size", "Avg Price", "Current", "PnL"],
+    )
+
+
+def _format_leaderboard(data) -> str:
+    items = data if isinstance(data, list) else data.get("data", data.get("leaderboard", []))
+    if not isinstance(items, list) or not items:
+        return "  No leaderboard data."
+    return format_table(
+        items[:20],
+        ["rank", "address", "pnl", "volume", "marketsTraded"],
+        ["Rank", "Address", "PnL", "Volume", "Markets"],
+    )
+
+
+def _format_wallet_info(data: dict) -> str:
+    d = data.get("data", data)
+    lines = ["\n  Polymarket Wallet"]
+    for field in ["address", "proxyAddress", "signatureType", "source", "configPath"]:
+        if field in d:
+            lines.append(f"  {field}: {d[field]}")
+    if d.get("privateKey"):
+        key = d["privateKey"]
+        lines.append(f"  privateKey: {key[:6]}...{key[-4:]}")
+    return "\n".join(lines)