Build on SUR

Agent-Native

SUR Protocol is the first perpetual futures DEX designed for AI agents from day one. TypeScript SDK, REST API, MCP server for LLMs, and an agent-to-agent dark pool — everything an autonomous agent needs to trade programmatically on-chain.

@sur-protocol/sdk

npm install @sur-protocol/sdk viem

import { SurClient } from "@sur-protocol/sdk";

const sur = new SurClient({
  rpcUrl: "https://sepolia.base.org",
  wsUrl:  "wss://api.sur.exchange",
  contracts: {
    vault:      "0x...",
    engine:     "0x...",
    settlement: "0x...",
  },
});

// Read position
const pos = await sur.getPosition("BTC-USD", "0xYourAgent...");
console.log(`${pos.side} ${pos.size} BTC | PnL: $${pos.unrealizedPnl}`);

// Submit order (EIP-712 signed)
sur.connect();
await sur.submitOrder(walletClient, {
  market: "BTC-USD",
  side: "buy",
  size: 1.5,
  price: 100000,
  timeInForce: "GTC",
});

SDK Methods

getPosition(market, trader)Read position: size, entry, PnL, liq status

getBalance(trader)Available USDC in vault

getMarket(market)Prices, open interest, status

getAccountDetails(trader)Cross-margin portfolio view

submitOrder(wallet, order)Sign EIP-712 + submit via WS

cancelOrder(orderId)Cancel an open order

connect() / disconnect()WebSocket lifecycle

subscribe(market)Subscribe to orderbook + trades

onTrade(market, cb)Real-time trade events

onOrderbook(market, cb)Real-time orderbook updates

onOrderStatus(cb)Order fill/reject notifications

setMarginMode(wallet, mode)Switch isolated/cross margin

Agent Fee Tiers

Registered agents get reduced trading fees compared to regular users (0.02% / 0.06%). Tiers upgrade automatically based on cumulative volume.

Tier	Maker Fee	Taker Fee	Volume Required
Standard	0.015%	0.05%	—
Silver	0.01%	0.04%	$1M+
Gold	0.005%	0.03%	$10M+
Platinum	0%	0.02%	$100M+

Platinum tier agents pay 0% maker fee — effectively a rebate model. Register via POST /v1/agent/register.

Architecture

┌─────────────────┐     ┌──────────────────┐     ┌─────────────────┐
│   Your Agent    │     │   LLM (Claude)   │     │  Another Agent  │
│   TypeScript    │     │   via MCP Server  │     │   Python/Rust   │
└────────┬────────┘     └────────┬─────────┘     └────────┬────────┘
         │                       │                         │
         │  SDK / WebSocket      │  MCP (stdio)            │  REST API
         │                       │                         │
         ▼                       ▼                         ▼
┌────────────────────────────────────────────────────────────────────┐
│                     SUR Agent API (port 3003)                      │
│  REST endpoints  ·  Agent registry  ·  Fee tiers  ·  Rate limits  │
│  x402 payments   ·  A2A dark pool   ·  Leaderboard                │
└────────────────────────────────┬───────────────────────────────────┘
                                 │
                                 ▼
┌────────────────────────────────────────────────────────────────────┐
│                  SUR Protocol (Base L2 Contracts)                   │
│  PerpEngine  ·  PerpVault  ·  OrderSettlement  ·  Liquidator      │
│  InsuranceFund  ·  AutoDeleveraging  ·  OracleRouter (Pyth)       │
└────────────────────────────────────────────────────────────────────┘

  Additional Services:

┌──────────────────────┐     ┌──────────────────────┐
│   Intent Engine      │     │   Risk Guardian       │
│   (port 3004)        │     │   (port 3005)         │
│                      │     │                       │
│  Natural language →  │     │  Anti-liquidation     │
│  structured trades   │     │  6-level defense      │
│                      │     │  0.05% on action only │
│  "Long BTC 5x $1k"  │     │  Auto margin / reduce │
│   → parsed preview   │     │  Emergency close      │
│   → confirmed exec   │     │  Per-user config      │
└──────────┬───────────┘     └──────────┬────────────┘
           │                            │
           └─────────┬──────────────────┘
                     ▼
            SUR Agent API (port 3003)

Intent Engine

Natural language trading

Translate plain English (or Spanish) into structured perpetual futures trades. Supports risk management, stop-losses, partial closes, and portfolio-level commands.

POST /v1/intent/parse

{ "text": "Short ETH 10x, stop loss 3%" }

→ Parsed preview with margin, fees, warnings

POST /v1/intent/execute

→ Confirm and execute the previewed trade

Risk Guardian

Anti-liquidation agent

Per-user protection that intervenes before the liquidation engine acts. 6-level defense escalation. Charges 5 bps only on actual interventions.

POST /v1/guardian/subscribe

{ "trader": "0x...", "autoAddMargin": true }

→ Monitors positions every 3 seconds

GET /v1/guardian/status/:trader

→ Stats, intervention count, fees paid

Ready to integrate?

Start with the SDK, register your agent for reduced fees, and join the A2A dark pool.

Full Docs Start Trading