Quote, stream and sign Papertrade perps. From code or from any AI.

What is inside

Connect your AI

One URL, no API key: https://papertrade-sdk.pages.dev/mcp

claude mcp add --transport http papertrade-sdk https://papertrade-sdk.pages.dev/mcp

codex mcp add papertrade-sdk --url https://papertrade-sdk.pages.dev/mcp

gemini mcp add --transport http papertrade-sdk https://papertrade-sdk.pages.dev/mcp

{
  "mcpServers": {
    "papertrade-sdk": { "url": "https://papertrade-sdk.pages.dev/mcp" }
  }
}

{
  "servers": {
    "papertrade-sdk": { "type": "http", "url": "https://papertrade-sdk.pages.dev/mcp" }
  }
}

{
  "mcpServers": {
    "papertrade-sdk": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://papertrade-sdk.pages.dev/mcp"]
    }
  }
}

Setup for Claude API, ChatGPT, Windsurf, Zed, Cline, Goose, Continue and more

Install the SDK

npm install papertrade-sdk viem

import { PapertradeClient, streamWallet } from 'papertrade-sdk';

const client = new PapertradeClient();
const { instruments } = await client.tradingState();

streamWallet({
  wallet: '0x...',
  onState: (state) => console.log(state.positions.length, 'open positions'),
});

Verified against mainnet

• Signatures. A real batched Close from HyperEVM recovers the trader's session key, and the SDK reproduces the relayer's intent ids.
• Staking domain. The PaperStaking EIP-712 domain hashes to the contract's on-chain separator.
• Liquidation prices. Exact on 205 of 205 sampled live positions.
• Closes. Reproduces 15 of 15 leaderboard wins, a losing close's PAPER basis, and a mainnet liquidation.
• Staking rewards. Matches PaperStaking.pendingReward to the wei.

The Papertrade toolkit