{
  "protocolVersion": "0.3.0",
  "name": "papertrade-x402",
  "description": "Unofficial pay-per-call intelligence over Papertrade (1000x synthetic perps on Hyperliquid HyperEVM): free live markets and previews, plus paid x402 endpoints for wallet liquidation risk, liquidation maps, settlement estimates and top-trader stats. Not affiliated with Papertrade.",
  "url": "https://papertrade-x402.pages.dev",
  "version": "0.1.0",
  "documentationUrl": "https://papertrade-x402.pages.dev/docs/",
  "provider": {
    "organization": "nirholas",
    "url": "https://github.com/nirholas"
  },
  "capabilities": {
    "streaming": false,
    "pushNotifications": false,
    "stateTransitionHistory": false
  },
  "defaultInputModes": [
    "application/json"
  ],
  "defaultOutputModes": [
    "application/json"
  ],
  "supportsAuthenticatedExtendedCard": false,
  "securitySchemes": {},
  "interfaces": {
    "mcp": {
      "type": "streamable-http",
      "url": "https://papertrade-x402.pages.dev/mcp",
      "serverCard": "https://papertrade-x402.pages.dev/.well-known/mcp/server-card.json"
    },
    "openapi": "https://papertrade-x402.pages.dev/openapi.json",
    "x402": "https://papertrade-x402.pages.dev/.well-known/x402"
  },
  "skills": [
    {
      "id": "get_markets",
      "name": "Live Papertrade markets",
      "description": "Free. Live Papertrade perpetual markets: mark price, max leverage, open interest and caps in USD, and whether each market is open for new positions.",
      "tags": [
        "papertrade",
        "perps",
        "hyperliquid",
        "free"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "get_service_status",
      "name": "Service and payment status",
      "description": "Free. Whether the Papertrade upstream is reachable and whether this deployment currently accepts x402 payments (and on which networks), plus current per-call prices.",
      "tags": [
        "papertrade",
        "perps",
        "hyperliquid",
        "free"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "preview_wallet_risk",
      "name": "Wallet liquidation risk (preview)",
      "description": "Account-level liquidation risk of a Papertrade wallet: balance, open position count, notional, effective leverage, highest risk score and nearest bust distance. Free preview: the live computation behind the paid endpoint, with the detail withheld that the paid response adds. Free, rate limited.",
      "tags": [
        "papertrade",
        "perps",
        "hyperliquid",
        "free"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "preview_liquidations_nearby",
      "name": "Nearby liquidations (preview)",
      "description": "Long and short liquidation totals within pct percent of the mark, from the top 5 accounts by open notional, plus protocol-wide totals for the same window. Free preview: the live computation behind the paid endpoint, with the detail withheld that the paid response adds. Free, rate limited.",
      "tags": [
        "papertrade",
        "perps",
        "hyperliquid",
        "free"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "preview_estimate_position",
      "name": "Position bust estimate (preview)",
      "description": "Bust (liquidation) price, distance to bust and whether Papertrade would accept a hypothetical position right now, using the protocol formula and live limits. Quote only: it never opens a position. Free preview: the live computation behind the paid endpoint, with the detail withheld that the paid response adds. Free, rate limited.",
      "tags": [
        "papertrade",
        "perps",
        "hyperliquid",
        "free"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "preview_top_traders",
      "name": "Top traders (preview)",
      "description": "The top 3 Papertrade traders by windowed PnL. Free preview: the live computation behind the paid endpoint, with the detail withheld that the paid response adds. Free, rate limited.",
      "tags": [
        "papertrade",
        "perps",
        "hyperliquid",
        "free"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "wallet_risk",
      "name": "Wallet liquidation risk (paid, x402)",
      "description": "PAID endpoint (x402, USDC on Solana first, Base second). Open Papertrade positions of a wallet with bust price, distance to liquidation, a 0-100 liquidation-risk score, effective leverage, unrealized PnL and the net settlement if closed at the live mark. This tool does NOT return that data and never pays: it validates your input and returns the x402 payment requirements plus the exact HTTP request your own agent wallet must send. For free data use the matching preview tool.",
      "tags": [
        "papertrade",
        "perps",
        "hyperliquid",
        "x402"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "liquidations_nearby",
      "name": "Nearby liquidation map (paid, x402)",
      "description": "PAID endpoint (x402, USDC on Solana first, Base second). Open positions of the top leaderboard accounts whose bust price is within pct percent of the live mark, aggregated into 20 price buckets (a liquidation map), plus protocol-wide totals for the same window. This tool does NOT return that data and never pays: it validates your input and returns the x402 payment requirements plus the exact HTTP request your own agent wallet must send. For free data use the matching preview tool.",
      "tags": [
        "papertrade",
        "perps",
        "hyperliquid",
        "x402"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "estimate_position",
      "name": "Position settlement estimate (paid, x402)",
      "description": "PAID endpoint (x402, USDC on Solana first, Base second). Estimate what a hypothetical Papertrade position settles for: bust price, limit checks, the close at a chosen exit (deadband, impact, 2% win fee), PAPER minted on a loss, and a ladder of price-move scenarios. This tool does NOT return that data and never pays: it validates your input and returns the x402 payment requirements plus the exact HTTP request your own agent wallet must send. For free data use the matching preview tool.",
      "tags": [
        "papertrade",
        "perps",
        "hyperliquid",
        "x402"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "top_traders",
      "name": "Top traders with stats (paid, x402)",
      "description": "PAID endpoint (x402, USDC on Solana first, Base second). Top Papertrade traders by windowed PnL with open exposure and stats derived from their recent closed trades: win rate, average and margin-weighted leverage, liquidations and average hold time. This tool does NOT return that data and never pays: it validates your input and returns the x402 payment requirements plus the exact HTTP request your own agent wallet must send. For free data use the matching preview tool.",
      "tags": [
        "papertrade",
        "perps",
        "hyperliquid",
        "x402"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    }
  ]
}