API توسعه‌دهندگان · نسخهٔ ۱٫۱

از هر عامل هوشمند، اسکریپت یا برنامه‌ای در پلی‌مارکت کپی‌ترید کنید.

پلی‌زیگ یک API کامل REST و سرور اختصاصی پروتکل زمینهٔ مدل (MCP) ارائه می‌کند. کلاینت‌های میزبانی‌شده مانند Poke با OAuth پلی‌زیگ متصل می‌شوند؛ بنابراین کاربر با Apple یا ایمیل وارد می‌شود و نیازی به چسباندن کلید ندارد. کلاینت‌های توسعه‌دهندگان همچنان می‌توانند از کلیدهای محدودشدهٔ pzk_* استفاده کنند. عامل‌ها می‌توانند معامله‌گران برتر را پیدا کنند، معامله را پیش‌نمایش دهند، کانفیگ کپی بسازند، سود و زیان را پایش کنند و سفارش را با اجرای زیر ۵۰۰ میلی‌ثانیه ثبت کنند.

ساخته‌شده برای عامل‌های خودکار

ورود OAuth یا کلیدهای محدودشده

Poke از OAuth پلی‌زیگ استفاده می‌کند تا کاربر با Apple یا ایمیل دسترسی را تأیید کند. کلاینت‌های توسعه‌دهندگان می‌توانند کلید API با سطح دسترسی دقیق بسازند و مسیرها به‌طور پیش‌فرض دسترسی نوشتن را رد می‌کنند.

اجرای یک‌باره و امن درخواست‌های معاملاتی

درخواست‌های نوشتن REST از سرآیند Idempotency-Key و ابزارهای MCP از آرگومان idempotency_key استفاده می‌کنند. سفارش زنده و ساخت کانفیگ کپی نیز به preview_id معتبر و منقضی‌نشده نیاز دارد.

قراردادهای مناسب ماشین

هر خطا کد پایدار دارد، اطلاعات صفحه‌بندی در سرآیند پاسخ است و مقادیر پولی نسخهٔ رشته‌ای اعشاری دارند. مشخصات OpenAPI 3.1 و Swagger UI نیز عمومی‌اند.

شروع سریع

۱. کلاینت‌های میزبانی‌شده از OAuth استفاده می‌کنند

دستورهای Poke باید از طریق OAuth پلی‌زیگ ثبت و متصل شوند. کاربر با Apple، ایمیل یا یکی از هویت‌های متصل وارد می‌شود، سطح دسترسی را تأیید می‌کند و Poke یک توکن محدودشدهٔ pzo_* دریافت می‌کند.

OAuth برای Poke
Authorization server: https://api.polyzig.com/.well-known/oauth-authorization-server
Protected resource:    https://api.polyzig.com/.well-known/oauth-protected-resource
MCP URL:               https://api.polyzig.com/api/mcp
Credential mode:       OAuth user login (Apple/email/connected identity)
Recommended scopes:    read:account read:positions read:trades read:markets trade:execute trade:cancel

۲. کلاینت توسعه‌دهنده می‌تواند کلید بسازد

وارد شوید، به /dashboard/keys بروید و فقط دسترسی‌های لازم عامل را انتخاب کنید. مقدار محرمانهٔ کلید فقط یک بار نمایش داده می‌شود.

۳. اتصال را با curl بررسی کنید

bash
curl https://api.polyzig.com/api/users/me \
  -H "Authorization: Bearer pzk_live_..."

۴. کپی یک معامله‌گر را آغاز کنید

برای نخستین اجرای هر هدف جدید همیشه paper_trading: true را تنظیم کنید؛ یک نشست را پایش کنید، سود و زیان را بسنجید و سپس به حالت زنده بروید.

bash
# Create a paper-trading copy config for a target wallet
curl -X POST https://api.polyzig.com/api/configs \
  -H "Authorization: Bearer pzk_live_..." \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "target_address": "0xWHALE_ADDRESS",
    "target_name":    "polymarket-whale",
    "size_multiplier": "0.1",
    "paper_trading":   true
  }'

یا مستقیماً از MCP استفاده کنید

Poke از فرادادهٔ OAuth بالا استفاده می‌کند. برای کلاینت توسعه‌دهنده، تنظیم زیر را در فایل claude_desktop_config.json Claude Desktop یا فایل مشابه Cursor قرار دهید. عامل فقط ابزارهای مجاز برای کلید شما را می‌بیند.

claude_desktop_config.json
{
  "mcpServers": {
    "polyzig": {
      "type": "http",
      "url": "https://api.polyzig.com/api/mcp",
      "headers": {
        "Authorization": "Bearer pzk_live_..."
      }
    }
  }
}
کشف خودکار

کلاینت‌هایی که /.well-known/mcp.json را می‌خوانند، مسیر، روش انتقال و فهرست دسترسی‌ها را خودکار دریافت می‌کنند.

سطوح دسترسی

کمترین دسترسی مورد نیاز عامل را انتخاب کنید. عامل پایش نباید trade:execute داشته باشد و عامل کپی‌ترید نیز تا زمانی که لازم نیست نباید wallet:write دریافت کند.

دسترسیامکانات مجاز
read:accountپروفایل، موجودی و خلاصهٔ سود و زیان
read:positionsپوزیشن‌های باز و آزمایشی
read:tradesتاریخچهٔ معاملات و پرشدن سفارش‌ها
read:marketsجست‌وجوی بازار، عمق، تاریخچه، سفارش‌های باز و جدول برترین‌ها
trade:executeثبت سفارش و ساخت، شروع یا توقف کانفیگ‌های کپی
trade:cancelلغو سفارش‌های باز دفتر سفارش
wallet:writeدریافت پوزیشن‌های نتیجه‌گذاری‌شده، برداشت و تبدیل به pUSD

فهرست ابزارهای MCP

۲۶ ابزار اختصاصی در دسترس است. سرور MCP فقط ابزارهایی را برمی‌گرداند که کلید شما اجازه می‌دهد؛ بنابراین عامل فقط‌خواندنی ابزارهای نوشتن را نمی‌بیند.

کشف و بررسی بازار

  • get_platform_stats
    میانه و صدک ۹۵ تأخیر اجرا و حجم پرشدن‌های اخیر.
  • get_trading_readinessread:account
    موجودی، وضعیت کیف پول، دسترسی‌ها، موانع راه‌اندازی و اقدام‌های لازم برای iMessage.
  • search_marketsread:markets
    کارت بازار آمادهٔ iMessage همراه با نشان، تصویر، گزینه‌ها، قیمت‌ها و شناسهٔ توکن.
  • get_market_detailsread:markets
    فرادادهٔ کامل بازار، زمینهٔ محلی‌سازی‌شده، قیمت زنده، نقدینگی، نتایج و اقدام‌های بعدی.
  • get_market_depthread:markets
    سطوح دفتر سفارش، اسپرد و عمق در فاصلهٔ ۱، ۲ و ۵ سنت.
  • get_market_price_historyread:markets
    تاریخچهٔ نمونه‌برداری‌شدهٔ CLOB با بازشدن، آخرین، بیشینه، کمینه و تغییر قیمت.
  • list_top_tradersread:markets
    کارت معامله‌گران برتر قابل کپی همراه با نشان و اقدام پیش‌نمایش کپی.

خواندن وضعیت حساب

  • list_open_positionsread:positions
    پوزیشن‌های روی زنجیرهٔ پلی‌مارکت همراه با سود و زیان.
  • list_paper_positionsread:positions
    پوزیشن‌های آزمایشی بدون استفاده از پول واقعی.
  • list_tradesread:trades
    تاریخچهٔ پرشدن سفارش با تأخیر تشخیص و اجرا.
  • get_user_summaryread:account
    تعداد کل معاملات و کارمزد پرداخت‌شده.

مدیریت کانفیگ‌های کپی

  • list_copy_configsread:account
    همهٔ کیف پول‌هایی که اکنون کپی می‌کنید.
  • get_copy_configread:account
    جزئیات یک کانفیگ کپی.
  • get_config_pnlread:account
    تفکیک سود و زیان یک کانفیگ.
  • get_config_tradesread:trades
    معاملات منتسب به یک کانفیگ.
  • suggest_multiplierread:markets
    پیشنهاد اندازهٔ معامله بر اساس موجودی کاربر.
  • preview_copy_configtrade:execute
    تأیید هدف، اندازه، سقف‌ها، حد سود و زیان و حالت زنده یا آزمایشی.
  • create_copy_configtrade:execute
    ساخت کانفیگ غیرفعال از یک preview_id.
  • start_copyingtrade:execute
    فعال کردن کانفیگ کپی.
  • stop_copyingtrade:execute
    غیرفعال کردن کپی؛ پوزیشن‌های موجود باز می‌مانند.
  • delete_copy_configtrade:execute
    حذف دائمی کانفیگ.

معاملهٔ مستقیم

  • preview_market_ordertrade:execute
    پیش‌نمایش دقیق سفارش شامل قیمت، سهم، توکن و متن تأیید.
  • place_market_ordertrade:execute
    ثبت سفارش زنده از یک preview_id.
  • list_open_ordersread:markets
    سفارش‌های باز CLOB.
  • cancel_ordertrade:cancel
    لغو یک سفارش با شناسهٔ آن.
  • claim_positionswallet:write
    دریافت پوزیشن‌های نتیجه‌گذاری‌شده روی زنجیره.

آمادهٔ ساخت هستید؟

وارد شوید و نخستین کلید خود را در کمتر از یک دقیقه بسازید. با دسترسی‌های read:* شروع کنید و پس از اطمینان از چرخهٔ عامل، دسترسی نوشتن را اضافه کنید.

باز کردن داشبورد کلیدهای API