Polymarket 永續合約 API 教學【2026】Perps 行情端點、下單簽名、SDK 範例與 WebSocket 訂閱

# 全部合約（截至 2026-10 共 88 個）
curl "https://api.perpetuals.polymarket.com/v1/info/instruments"

# BTC 的訂單簿（instrument_id=1 是 BTC-USD）
curl -G "https://api.perpetuals.polymarket.com/v1/info/book" \
  --data-urlencode "instrument_id=1" \
  --data-urlencode "depth=100"

# 1 分鐘 K 線
curl -G "https://api.perpetuals.polymarket.com/v1/info/klines" \
  --data-urlencode "instrument_id=1" \
  --data-urlencode "interval=1m" \
  --data-urlencode "start_timestamp=1766120400000"

# 歷史資金費率
curl -G "https://api.perpetuals.polymarket.com/v1/info/funding" \
  --data-urlencode "instrument_id=1"

import requests

rows = requests.get("https://api.perpetuals.polymarket.com/v1/info/instruments", timeout=10).json()
for r in sorted(rows, key=lambda x: (x["category"], x["symbol"])):
    mmr = 0.5 / r["max_leverage"]
    print(f'{r["category"]:10} {r["symbol"]:14} 槓桿 {r["max_leverage"]:>2}x  MMR {mmr:.2%}  強平費 {float(r["liquidation_fee"]):.1%}')

polymarket-proxy: <代理地址>
polymarket-secret: <代理密鑰>

import { createSecureClient, privateKey } from "@polymarket/client";

const client = await createSecureClient({
  wallet: process.env.POLYMARKET_WALLET_ADDRESS!,   // 你在 polymarket.com 的帳戶錢包地址
  signer: privateKey(process.env.PRIVATE_KEY!),     // 該帳戶的簽名私鑰
});
const session = await client.openPerpsSession({ label: "my-bot" });

import os
from polymarket_client import AsyncSecureClient

client = await AsyncSecureClient.create(
    private_key=os.environ["PRIVATE_KEY"],
    wallet=os.environ["POLYMARKET_WALLET_ADDRESS"],
)
session = await client.open_perps_session(label="my-bot")

await client.setupTradingApprovals();          // 一次性授權
const deposit = await client.depositToPerps({ amount: 10_000_000n }); // 10 pUSD，單位是 6 位小數的最小單位
await deposit.wait();                           // 等鏈上確認，Perps 入帳會再晚幾秒

await session.updateLeverage({
  instrumentId: 1,        // BTC-USD
  leverage: 5,
  crossMargin: false,     // false = 逐倉，true = 全倉
});

import { OrderSide, PerpsTimeInForce } from "@polymarket/client";

// 掛一張限價買單
const order = await session.placeOrder({
  instrumentId: 1,
  side: OrderSide.BUY,
  price: "65000",
  quantity: "0.01",
  timeInForce: PerpsTimeInForce.GTC,
  postOnly: true,          // 只做 Maker，會吃單就拒絕
});

// 撤單
await session.cancelOrder({ orderId: order.id });

// 平倉：反方向、全數量、reduce-only
const portfolio = await session.fetchPortfolio();
const pos = portfolio.positions.find(p => p.instrumentId === 1);
if (pos) {
  await session.placeOrder({
    instrumentId: 1,
    side: pos.size > 0 ? OrderSide.SELL : OrderSide.BUY,
    quantity: Math.abs(pos.size).toString(),
    timeInForce: PerpsTimeInForce.IOC,
    reduceOnly: true,
  });
}

result = await session.place_order(
    instrument_id=1,
    side="BUY",
    price="65000",
    quantity="0.01",
    time_in_force="gtc",
    post_only=True,
)
await session.cancel_order(order_id=result.id)

{ "id": 1, "req": "sub", "chs": ["bbo::1", "trades::1", "tickers::all"] }

{ "id": 1, "req": "post", "op": { "type": "auth", "args": { "proxy": "<代理地址>", "secret": "<代理密鑰>" } } }