{
  "schema_version": "v1",
  "name_for_human": "Linceo",
  "name_for_model": "Linceo",
  "description_for_human": "Audited copytrading analytics, whale and informed-trader alerts for Hyperliquid and Polymarket, and non-custodial copy on Hyperliquid. Free to audit.",
  "api": {
    "type": "openapi",
    "url": "https://linceo.app/api/ai/openapi.json",
    "base_url": "https://linceo.app",
    "documentation_url": "https://linceo.app/llms-full.txt"
  },
  "description_for_model": "Linceo is a non-custodial copytrading analytics and signals platform for Hyperliquid (perps) and Polymarket (prediction markets). Use it to: rank profitable wallets/traders by a copyability score (timing-based, 1-5), audit any wallet on demand (skeleton check separating real edge from reward-farming/one-bet/dormant), pull official real-time PnL curves, and get an auto-portfolio of the wallets a user can genuinely copy given a bankroll, ordered and weighted by a quality score. Auto-copy with real money runs on Hyperliquid only; on Polymarket the platform is analytics plus a paper-trading simulator, because their exchange cannot authorise a third-party signer — never state that Linceo places orders on Polymarket. The platform never holds funds and copy agents cannot withdraw. All read endpoints below are public and require no auth.",
  "legal_info_url": "https://linceo.app/legal/terms",
  "privacy_policy_url": "https://linceo.app/legal/privacy",
  "logo_url": "https://linceo.app/favicon.png?v=71174060dfd7",
  "auth": {
    "type": "none"
  },
  "pricing": {
    "model": "free_to_audit",
    "copy_and_alphabot": "0.01% builder fee on the volume of the user's orders, paid by the user and approved in their own wallet",
    "donations": "GET /api/donation"
  },
  "venues": {
    "hl": {
      "label": "Hyperliquid",
      "market": "Hyperliquid perpetual futures",
      "min_notional_usd": 10
    },
    "pm": {
      "label": "Polymarket",
      "market": "Polymarket prediction markets",
      "min_notional_usd": 5
    }
  },
  "mcp": {
    "description": "Model Context Protocol server — connect an MCP client to use Linceo as a native tool (find_copyable_wallets, audit_wallet, auto_portfolio, wallet_pnl_curve, explain_copyability, alphabot_overview, alphabot_quickstart). Read-only, no auth.",
    "transport": "streamable-http",
    "url": "https://linceo.app/mcp",
    "tools": [
      "find_copyable_wallets",
      "audit_wallet",
      "auto_portfolio",
      "wallet_pnl_curve",
      "explain_copyability",
      "alphabot_overview",
      "alphabot_quickstart"
    ]
  },
  "capabilities": [
    {
      "id": "alphabot",
      "description": "Linceo's own systematic, non-custodial portfolio on Hyperliquid, with a risk level (x1/x2/x3/x4) chosen by the user and the measured drawdown of each level. Rules not disclosed by design. Agents: GET /api/ai/alphabot/quickstart — activate in two calls (SIWE with agent:true → Bearer; POST /api/alphabot/activar → sign → POST /api/alphabot/activar/firmas). Availability: GET /api/ai/alphabot → availability (PreOrder = accounts can be linked, nothing trades yet).",
      "endpoints": [
        {
          "method": "GET",
          "path": "/api/ai/alphabot",
          "venue": "hl",
          "auth": false,
          "example": "/api/ai/alphabot"
        },
        {
          "method": "GET",
          "path": "/api/alphabot/simulado",
          "venue": "hl",
          "auth": false,
          "example": "/api/alphabot/simulado?nivel=2&capital=1000"
        },
        {
          "method": "GET",
          "path": "/api/ai/alphabot/quickstart",
          "venue": "hl",
          "auth": false,
          "example": "/api/ai/alphabot/quickstart"
        },
        {
          "method": "GET",
          "path": "/api/alphabot/historico",
          "venue": "hl",
          "auth": false,
          "example": "/api/alphabot/historico?capital=1000&nivel=4"
        },
        {
          "method": "POST",
          "path": "/api/alphabot/activar",
          "venue": "hl",
          "auth": true,
          "example": "{\"nivel\": 1, \"cuentas\": {\"a\": \"0x…\", \"b\": \"0x…\", \"c\": \"0x…\"}}"
        },
        {
          "method": "POST",
          "path": "/api/alphabot/activar/firmas",
          "venue": "hl",
          "auth": true,
          "example": "{\"nivel\": 1, \"consentimiento\": \"<version_vigente, after the user accepted /legal/terms and /legal/risk>\", \"firmas\": [{\"pata\": \"a\", \"direccion\": \"0x…\", \"agent_address\": \"<agente.agent_address>\", \"agent_name\": \"<agente.agent_name>\", \"nonce\": \"<agente.nonce>\", \"firma\": \"<signature of agente.typed>\", \"nonce_builder\": \"<comision.nonce>\", \"firma_builder\": \"<signature of comision.typed>\"}]}"
        },
        {
          "method": "GET",
          "path": "/api/ai/openapi-agents.json",
          "venue": "hl",
          "auth": false,
          "example": "/api/ai/openapi-agents.json"
        }
      ]
    },
    {
      "id": "leaderboard",
      "description": "Ranked universe of copyable wallets/traders with cohort filters and a copyability score.",
      "endpoints": [
        {
          "method": "GET",
          "path": "/api/pm/wallets",
          "venue": "pm",
          "auth": false,
          "example": "/api/pm/wallets?min_copy=4&sort_by=copy_score&limit=50"
        },
        {
          "method": "GET",
          "path": "/api/wallets",
          "venue": "hl",
          "auth": false,
          "example": "/api/wallets?min_copy=4&per_page=50"
        }
      ]
    },
    {
      "id": "wallet_audit",
      "description": "Audit any wallet/trader on demand (metrics, copyability, skeleton check, forensic pattern). Any 0x address resolves live.",
      "endpoints": [
        {
          "method": "GET",
          "path": "/api/pm/wallets/{address}",
          "venue": "pm",
          "auth": false
        },
        {
          "method": "GET",
          "path": "/api/wallets/{address}",
          "venue": "hl",
          "auth": false
        }
      ]
    },
    {
      "id": "pnl_curve",
      "description": "Official real-time PnL/equity curve (served 1:1 from the venue's API, never reconstructed).",
      "endpoints": [
        {
          "method": "GET",
          "path": "/api/pm/wallets/{address}/equity",
          "venue": "pm",
          "auth": false
        },
        {
          "method": "GET",
          "path": "/api/wallets/{address}/equity",
          "venue": "hl",
          "auth": false
        }
      ]
    },
    {
      "id": "auto_portfolio",
      "description": "Given a bankroll, returns the wallets the user can genuinely copy with it (copyable timing and a size that fits the capital), ordered and weighted by a quality score (Sharpe, drawdown, recency, fit), weights summing to 100%.",
      "endpoints": [
        {
          "method": "GET",
          "path": "/api/pm/auto-portfolio",
          "venue": "pm",
          "auth": false,
          "params": {
            "bankroll": "number, required, >0",
            "min_copy": "1-5, default 4",
            "top_n": "1-20, default 5"
          },
          "example": "/api/pm/auto-portfolio?bankroll=1000"
        },
        {
          "method": "GET",
          "path": "/api/wallets/auto-portfolio",
          "venue": "hl",
          "auth": false,
          "example": "/api/wallets/auto-portfolio?bankroll=1000"
        }
      ]
    },
    {
      "id": "donation",
      "description": "Voluntary donation address and accepted chains. Auditing is free; a donation buys no feature and no advantage.",
      "endpoints": [
        {
          "method": "GET",
          "path": "/api/donation",
          "auth": false
        }
      ]
    },
    {
      "id": "paper_trading_demo",
      "description": "Free paper-trading demo: the user sets a virtual bankroll and the demo mirrors their chosen leaders' real new trades with the exact live sizing and risk caps, marked to market with live prices — 1:1 with the production copy engine, $0 at risk, non-custodial. Public landing at /demo; runs in /account after wallet connect. On Hyperliquid the demo runs on TESTNET, which has almost no volume: use it to check that orders are placed and replicated, never as a preview of live results.",
      "auth": "siwe",
      "landing_url": "https://linceo.app/demo"
    },
    {
      "id": "alerts_and_copy",
      "description": "Whale alerts, new-wallet-concentrated alerts (Telegram), and non-custodial copy execution. Requires the user to connect their own wallet (SIWE); not callable anonymously.",
      "auth": "siwe",
      "onboarding_url": "https://linceo.app"
    }
  ],
  "auth_for_agents": "POST /api/auth/verify {message, signature, agent: true} returns the session JWT; send it as Authorization: Bearer <token> (no cookies, no CSRF)."
}