پلیزیگ یک API کامل REST و سرور اختصاصی پروتکل زمینهٔ مدل (MCP) ارائه میکند. کلاینتهای میزبانیشده مانند Poke با OAuth پلیزیگ متصل میشوند؛ بنابراین کاربر با Apple یا ایمیل وارد میشود و نیازی به چسباندن کلید ندارد. کلاینتهای توسعهدهندگان همچنان میتوانند از کلیدهای محدودشدهٔ pzk_* استفاده کنند. عاملها میتوانند معاملهگران برتر را پیدا کنند، معامله را پیشنمایش دهند، کانفیگ کپی بسازند، سود و زیان را پایش کنند و سفارش را با اجرای زیر ۵۰۰ میلیثانیه ثبت کنند.
Poke از OAuth پلیزیگ استفاده میکند تا کاربر با Apple یا ایمیل دسترسی را تأیید کند. کلاینتهای توسعهدهندگان میتوانند کلید API با سطح دسترسی دقیق بسازند و مسیرها بهطور پیشفرض دسترسی نوشتن را رد میکنند.
درخواستهای نوشتن REST از سرآیند Idempotency-Key و ابزارهای MCP از آرگومان idempotency_key استفاده میکنند. سفارش زنده و ساخت کانفیگ کپی نیز به preview_id معتبر و منقضینشده نیاز دارد.
هر خطا کد پایدار دارد، اطلاعات صفحهبندی در سرآیند پاسخ است و مقادیر پولی نسخهٔ رشتهای اعشاری دارند. مشخصات OpenAPI 3.1 و Swagger UI نیز عمومیاند.
دستورهای Poke باید از طریق OAuth پلیزیگ ثبت و متصل شوند. کاربر با Apple، ایمیل یا یکی از هویتهای متصل وارد میشود، سطح دسترسی را تأیید میکند و Poke یک توکن محدودشدهٔ pzo_* دریافت میکند.
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 https://api.polyzig.com/api/users/me \
-H "Authorization: Bearer pzk_live_..."برای نخستین اجرای هر هدف جدید همیشه paper_trading: true را تنظیم کنید؛ یک نشست را پایش کنید، سود و زیان را بسنجید و سپس به حالت زنده بروید.
# 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
}'Poke از فرادادهٔ OAuth بالا استفاده میکند. برای کلاینت توسعهدهنده، تنظیم زیر را در فایل claude_desktop_config.json Claude Desktop یا فایل مشابه Cursor قرار دهید. عامل فقط ابزارهای مجاز برای کلید شما را میبیند.
{
"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 فقط ابزارهایی را برمیگرداند که کلید شما اجازه میدهد؛ بنابراین عامل فقطخواندنی ابزارهای نوشتن را نمیبیند.
get_platform_statsget_trading_readinessread:accountsearch_marketsread:marketsget_market_detailsread:marketsget_market_depthread:marketsget_market_price_historyread:marketslist_top_tradersread:marketslist_open_positionsread:positionslist_paper_positionsread:positionslist_tradesread:tradesget_user_summaryread:accountlist_copy_configsread:accountget_copy_configread:accountget_config_pnlread:accountget_config_tradesread:tradessuggest_multiplierread:marketspreview_copy_configtrade:executecreate_copy_configtrade:executestart_copyingtrade:executestop_copyingtrade:executedelete_copy_configtrade:executepreview_market_ordertrade:executeplace_market_ordertrade:executelist_open_ordersread:marketscancel_ordertrade:cancelclaim_positionswallet:writeوارد شوید و نخستین کلید خود را در کمتر از یک دقیقه بسازید. با دسترسیهای read:* شروع کنید و پس از اطمینان از چرخهٔ عامل، دسترسی نوشتن را اضافه کنید.