آموزش Polymarket Bot · فصل 10 از 32
توضیح order typeهای Polymarket برای bot builderها: Fill-or-Kill (FOK)، Fill-and-Kill (FAK)، Good-til-Cancelled (GTC)، و trade-offهای limit در برابر market. همراه با decision ruleهای production-grade.
این فصل چه چیزهایی را پوشش میدهد
ابهام در order typeها، پرهزینهترین دسته bug برای bot builderهای تازهکار است. فرستادن FOK وقتی GTC لازم بود باعث از دست رفتن entryها میشود؛ فرستادن GTC وقتی FOK لازم بود orderهای معلقی باقی میگذارد که ساعتها بعد با قیمتهای وحشتناک fill میشوند. این فصل، decision tree و defaultهای production است که در هزاران order دوام آوردهاند.
- Quick decision tree
- FOK: وقتی باید fill شود یا skip شود
- FAK: وقتی partialها قابل قبولاند
- GTC: وقتی میخواهید روی book بمانید
- Limit در برابر market و spread tax
- Defaultهای production ما (FOK buys، GTC sells)
- Code: ثبت هر نوع order
Quick decision tree
سه سؤال، هر order placement را تعیین میکنند.
- آیا به یک fill تضمینی همین الان نیاز دارید، و اگر نتواند همین الان fill شود اصلاً نمیخواهید؟ → FOK.
- آیا میخواهید هر مقدار fill که همین الان میشود بگیرید، partial را بپذیرید، و هیچ resting orderی نداشته باشید؟ → FAK.
- آیا میخواهید روی book با قیمت خودتان بمانید و منتظر بمانید کسی به شما برسد؟ → GTC.
همین. بیشتر bugهای bot حول order typeها از انتخاب #1 وقتی #3 را میخواستید میآیند (یک «buy» تبدیل میشود به «no position چون spread خیلی باز بود») یا انتخاب #3 وقتی #1 را میخواستید (یک «buy» تبدیل میشود به resting orderی که ساعتها بعد در زمان اشتباه fill میشود).
FOK: وقتی باید fill شود یا skip شود
Fill-or-Kill کل order را با قیمت درخواستی یا بهتر، بلافاصله match میکند. اگر کل size نتواند فوراً fill شود، order رد میشود و هیچ اتفاقی نمیافتد. نه resting، نه partial.
از FOK استفاده کنید برای: ورودهای news-arbitrage (فقط در قیمت خبر میخواهید وارد شوید، نه جایی که بازار 30 ثانیه بعد است)؛ exitهای take-profit در یک target مشخص که partialها bookkeeping را بههم میزنند؛ هر زمانی که strategy اجرای atomic را فرض میکند.
trade-off این است که FOK بیشتر از سایر order typeها reject میشود، مخصوصاً روی bookهای illiquid. همیشه یک fallback path داشته باشید - conditionهای strategy را دوباره ارزیابی کنید و اگر هنوز معتبر بود retry کنید، یا به مرحله بعد بروید.
FAK: وقتی partialها قابل قبولاند
Fill-and-Kill (که به آن "immediate or cancel" هم گفته میشود) هر مقدار که بتواند را همین الان match میکند، سپس باقیمانده fill نشده را cancel میکند. ممکن است size کامل، یک partial، یا صفر بگیرید.
از FAK استفاده کنید برای: market-buy با یک price ceiling مشخص (ask را تا N cents بالاتر از mid بالا بکشید)؛ sellهای sweep-the-book وقتی باید urgently inventory را کم کنید؛ هر strategyای که در آن «بعضی position بهتر از هیچچیز است».
از نظر عملی پیچیدهتر از FOK است، چون bot باید قبل از تصمیمگیری برای قدم بعدی بداند 100% گرفته یا 30%. پاسخ fill شامل فیلد filled_size است - همیشه آن را بخوانید.
GTC: وقتی میخواهید روی book بمانید
Good-til-Cancelled روی book با قیمت شما میماند تا وقتی fill شود یا خودتان cancel کنید. هیچ timeoutی ندارد (سایر order typeها در API v2 شامل GTD با expiry هستند).
از GTC استفاده کنید برای: take-profit sellها در +Nc بالاتر از entry؛ stop-loss sellها در -Nc پایینتر از entry (با caveatها - پایینتر را ببینید)؛ market-making با quoteهای دوطرفه؛ هر positionی که bot حاضر است برای قیمت بهتر صبر کند.
قانون سخت: GTC به ≥ 5 shares نیاز دارد. orderهای زیر 5 shares توسط CLOB رد میشوند با Size (X) lower than the minimum: 5. یک bot که یک GTC sell چهار-share ثبت میکند، بیسروصدا fail میشود و exit را تنظیم نمیکند و position را تا resolution نگه میدارد. همیشه قبل از ثبت GTC بررسی کنید inventory ≥ 5 باشد؛ اگر کمتر بود به FAK یا ride-to-resolve fallback کنید.
Limit در برابر market و spread tax
هر order در Polymarket از نظر فنی یک limit order است - حتی چیزی که botها آن را «market buy» مینامند هم یک price ceiling مشخص میکند. تفاوت این است که آیا آن قیمت روی بهترین ask است (عملاً یک market order، و در برابر book fill میشود) یا پایینتر از آن است (و روی book میماند).
spread tax هزینه crossing است - bid 0.45، ask 0.47، mid 0.46. یک round trip که ask میخرد و bid میفروشد، به ازای هر share دو سنت پرداخت میکند. در یک strategy با win-rate 60% و targetهای +3c/-4c، همان spread 2c تفاوت بین سود و زیان است.
الگوی maker (ثبت GTC در bid یا پایینتر، و منتظر hit شدن ماندن) بهجای پرداخت spread، آن را جمع میکند. هزینهاش fill نامطمئن است - ممکن است هیچوقت hit نشوید. برای tradeهای با conviction بالا، spread را بپردازید. برای accumulation passive، book را کار کنید.
Defaultهای production ما (FOK buys، GTC sells)
الگویی که بیشتر botهای production ما به آن میرسند:
- Entryها: FOK در ask + 0-2 cents. اگر bot تصمیم به buy گرفته، باید همین الان buy کند یا skip شود. معلق گذاشتن یک entry order بهندرت ارزش دارد - موقعیتی که باعث تصمیم buy شده سریعتر از مدت معلق ماندن order تغییر میکند.
- Exitهای take-profit: GTC در target price. بلافاصله بعد از fill شدن entry ثبت میشود. میگذاریم بازار به سمت ما بیاید؛ bid را پایین تعقیب نمیکنیم. با ≥ 5 shares.
- Stop-loss: case-by-case. GTC برای strategyهای کند که تغییرات قیمت در آنها bounded است خوب کار میکند. برای بازارهای سریع، یک GTC stop اگر قیمت از روی آن بپرد fill نمیشود؛ ما به سبک option-D تا resolution میرویم (memory: trader-gtc-sell.md).
این الگو محافظهکارانه است - fill کمتر، slippage کمتر. یک variant تهاجمیتر از FAK برای entry و FAK برای exit استفاده میکند و partial fillها را میپذیرد. یکی را انتخاب کنید و ثابت بمانید؛ مخلوط کردن تصمیمها در هر trade باعث ابهام میشود.
Code: ثبت هر نوع order
نمونه order placement در Python با py-clob-client (v0.34.6).
from py_clob_client.client import ClobClient
from py_clob_client.clob_types import OrderArgs, OrderType
c = ClobClient(host="https://clob.polymarket.com", chain_id=137,
key=PRIVATE_KEY, signature_type=2, funder=PROXY)
c.set_api_creds(creds)
# FOK buy: fill 10 shares at price 0.45 or skip
args = OrderArgs(token_id=TOKEN, price=0.45, size=10, side="BUY")
resp = c.create_and_post_order(args, OrderType.FOK)
# FAK buy: take as much as you can at 0.45 or below
resp = c.create_and_post_order(args, OrderType.FAK)
# GTC sell: rest a sell at 0.85 for 10 shares
sell_args = OrderArgs(token_id=TOKEN, price=0.85, size=10, side="SELL")
resp = c.create_and_post_order(sell_args, OrderType.GTC)همین عملیات در Node با @polymarket/clob-client-v2: بهجای OrderType.FOK از clob.OrderType.GTC و غیره استفاده کنید؛ method برابر createAndPostOrder است. flag مربوط به negRisk (فصل 11) باید در آرگومان دوم برای بازارهای multi-outcome تنظیم شود - اگر نباشد، درخواست به contract اشتباه exchange route میشود.
