Bumuo ng isang Polymarket bot: scanner, sizing, execution, monitoring

Ipinapakita ng gabay na ito kung paano bumuo ng isang Polymarket bot na tuloy-tuloy na nag-i-scan ng mga market, nagsusukat ng oportunidad, nagpapatupad sa pamamagitan ng CLOB, at nagmomonitor ng performance. Nakatuon ito sa arkitektura at mga pattern para sa developer na maaari mong ipatupad gamit ang mga pampublikong API ng Polymarket at ang Relayer model.

Mga pangunahing aral

• I-architect ang bot bilang apat na magkakahiwalay na serbisyo: scanner, sizer, executor, at monitor.
• Gumamit ng Gamma at CLOB APIs ng Polymarket para sa listings at paglalagay ng order; WebSocket para sa real-time na book updates.
• Mas gusto ang FAK market orders para sa mabilis na execution ngunit laging isaalang-alang ang slippage at fees.
• Mag-instrument ng monitoring at mabilis na kill switch para sa mga oracle disputes, delay sa settlement, o hindi inaasahang fills.

Bakit ganitong istruktura

Mas madaling maintindihan ang trading systems kapag nahahati ang mga responsibilidad. Naghahanap ang scanner ng candidate edges, kino-convert ng sizer ang edge sa posisyon, naglalagay ng orders ang executor sa pamamagitan ng CLOB, at tinitiyak ng monitor ang correctness at kaligtasan. Pinapahintulutan ng paghihiwalay na ito ang scaling, testing, at hiwalay na pag-analisa ng latency at risk.

H2: Mga pinanggagalingan ng data at API

Magsimula sa pag-wire ng mga sumusunod na endpoints ng Polymarket sa iyong mga serbisyo:

• Gamma (market metadata): https://gamma-api.polymarket.com — markets, events, tags, series. Gumamit ng pagination gamit ang after_cursor; iwasan ang offset.
• CLOB (order book at trading): https://clob.polymarket.com — ang pagbasa ng orderbook ay pampubliko; nangangailangan ng API key + HMAC para sa trading. Inaalagaan ng CLOB SDKs ang paglalagay ng order.
• Market WebSocket (real-time book): wss://ws-subscriptions-clob.polymarket.com/ws/market — mag-subscribe para sa book, price_change, best_bid_ask, at tick_size_change. PING bawat 10s.
• Data API (positions, open interest): https://data-api.polymarket.com para sa post-trade analytics.

Design note: pagsamahin ang Gamma listings sa WebSocket feed para sa epektibong live scanning. Igalang ang Gamma rate limits (hal. ang /markets cap) at ang mga kinakailangan sa CLOB key para sa paglalagay ng order.

H2: Scanner — paghahanap ng candidate opportunities

Function

Nagdede-cover ang scanner ng mga oportunidad na tumutugma sa iyong strategy: intra-market binary spreads, multi-outcome sums, o endgame patterns. Dapat itong stateless, horizontally scalable, at nakatuon sa pagkalkula ng raw edges.

Inputs at cadence

• Mag-subscribe sa Market WebSocket na may custom_feature_enabled: true upang makatanggap ng best_bid_ask at tick changes.
• Backfill gamit ang Gamma /markets kapag unang nakatagpo ang isang bagong instrument para makuha ang metadata at outcomes.
• Panatilihin ang maliit na in-memory view ng best asks/bids para sa bawat outcome.

Edge computation

• Binary intra-market: kalkulahin ang edge = 1.00 - (bestAsk(YES) + bestAsk(NO)). Positibong edge ay isang candidate.
• Multi-outcome: edge = 1.00 - sum(bestAsk(outcomes)).

Thresholds at filters

• Minimum edge threshold (hal., > configured cents) para masakop ang taker fees at execution risk.
• Minimum liquidity checks: ang depth sa best ask ay dapat sumunod sa minimum fill size.
• Tick-size awareness: isama ang tick_size_change events — maaaring magbago ang price granularity sa $0.001 kapag malapit na sa extremes.

H2: Sizing — risk at allocation ng kapital

Goals

Ang sizing ang nagko-convert ng raw edge sa order plan: ilan ang shares na bibilhin bawat outcome, at paano hatiin sa mga order para limitahan ang slippage.

Mga bahagi

• Exposure caps: per-market at global pUSD exposure limits.
• Depth-limited sizing: kalkulahin ang cumulative volume na available sa sunod-sunod na price levels sa ask side; i-size lamang hanggang sa dami na nagpapanatili ng inaasahang slippage sa loob ng tolerance.
• Fee allowance: ibawas ang inaasahang taker fee (nag-iiba, hanggang 1.8% sa ilang kategorya) mula sa gross edge bago mag-desisyon mag-trade.

Praktikal na pattern

• Magsimula sa konserbatibong fills: mas piliin ang maraming maliit na FAK market orders kaysa isang malaking order maliban kung kontrolado mo ang book.
• Kung bibili ka ng complete set sa pamamagitan ng CTF split/merge flows, isama ang halaga ng split/merge gas (inaasikaso ng Relayer) at posibleng rounding dahil sa tick size.

H2: Executor — paglalagay ng mga order at paghawak ng fills

Order types at constraints

• Gamitin ang CLOB trading endpoint para sa paglalagay ng order: https://clob.polymarket.com. Ang CLOB SDK at Relayer ang nagma-manage ng wallet deployment, approvals, at order signing.
• Para sa bilis, gumamit ng FAK (Fill-And-Kill) market orders kung naaangkop. Ang FAKs ay agad na nag-e-execute o nagka-cancel; tumutulong silang iwasan ang lingering exposure ngunit maaari ring mag-partial-fill.

Execution flow

1. Ihanda ang trade intent: listahan ng outcome token ids at target quantities na ibinabalik ng sizer.
2. Kung nagpapatupad ng multi-outcome complete-set, maaari ding magsagawa ng CTF split (mint ng complete set) at pagkatapos ay ibenta ang mga legs — ina-abstract ng Relayer at SDK ang CTF ops.
3. Isumite ang mga order sa pamamagitan ng CLOB trading API na may tamang attribution headers kung bahagi ka ng Builder Program.
4. Obserbahan ang fills mula sa WebSocket last_trade_price at best_bid_ask updates o mula sa CLOB trade responses.

Kaligtasan at reconciliation

• Subaybayan ang partial fills at kanselahin ang natitira o i-reprice agad.
• I-reconcile ang on-chain CTF balances (sa pamamagitan ng Data API) pagkatapos ng fills upang matiyak na hawak mo talaga ang outcome tokens na inaasahan.
• Mag-implement ng idempotency keys at nonce handling para sa order retries.

H2: Monitoring at operational na kaligtasan

Ano ang imo-monitor

• Fill rates, average slippage kumpara sa inaasahan, realized edge pagkatapos ng fees.
• Latency sa pagitan ng WebSocket updates at order submission.
• Hindi pangkaraniwang pangyayari: UMA disputes, tick_size_change, marketplace-wide outages.

Alerts at kill-switches

• Automated soft kill: i-pause ang bagong paglalagay ng order kapag ang net realized P&L ay bumaba sa ilalim ng threshold o kapag ang fill slippage ay lumampas sa limit.
• Hard kill: agad na itigil ang lahat ng traffic kung nag-uulat ang UMA ng dispute para sa market na may hawak kang posisyon, o kung nagpahiwatig ang Relayer ng mga isyu sa settlement.

Audit logs at observability

• Itala ang lahat ng order intents, raw market snapshots, at mga executed fills. Gamitin ang mga log na ito para sa post-mortem at backtesting.
• I-tag ang mga log ng market id, condition_ids, at request ids para itugma sa Gamma at CLOB records.

H2: Builder Program, credentials, at rate limits

Kung plano mong i-route ang mga order na may attribution, sumali sa Builder Program at i-manage ang mga key sa pamamagitan ng Polymarket settings. Kinokontrol ng mga tier ng Builder ang daily relayer limits at rewards. Para mag-trade sa pamamagitan ng CLOB kakailanganin mo ang API key + HMAC at dapat igalang ang rate limits at relayer quotas.

H2: Karaniwang mga panganib at mga mitigations

Huwag asumihin na garantisado ang mathematical edge. Mga panganib na isasaalang-alang:

• Resolution risk: maaaring i-pause o baguhin ng UMA disputes ang payouts.
• Slippage at partial fills: maaaring mag-partial fill ang FAKs; magplano para sa natirang exposure.
• Fees: nag-iiba ang taker fees ayon sa kategorya at maaaring lamunin ang maliliit na edges (fee-free ang Geopolitics).
• Settlement timing: ang redeem/merge timing at mga pagkaantala sa oracle resolution ay maaaring makulong ang kapital.
• Smart-contract o Relayer failures: maghanda ng fallbacks at human alerting.

Paano nito naaapektuhan ang iyong trading

I-disenyo ang bot mo upang bawat trade unit ay maliit, nasusukat, at nare-reverse sa loob ng iyong risk limits. Ang konserbatibong sizing, mabilis na monitoring, at malinaw na kill conditions ay nagpapababa ng tail risk. Gamitin ang Gamma at CLOB endpoints para sa deterministic market state at paboran ang FAK orders para sa mabilis na execution, ngunit laging sukatin ang realized slippage laban sa mga inaasahan.

Pangwakas

Ang arkitekturang nasa itaas ay nagbibigay ng pragmatic na blueprint para bumuo ng isang Polymarket trading bot: isang high-throughput scanner, konserbatibong sizer, matibay na executor gamit ang CLOB at Relayer, at layered monitoring. Magsimula sa maliit, mag-instrument nang mabuti, at ulitin ang sizing at filters habang nag-iipon ka ng live na data.

Mga Madalas na Itanong

Aling mga API ang dapat kong gamitin para makuha ang market listings at live book data?

Gamitin ang https://gamma-api.polymarket.com para sa market metadata (/markets) at wss://ws-subscriptions-clob.polymarket.com/ws/market para sa real-time order book at best_bid_ask events. Gamitin ang https://clob.polymarket.com para sa order-book reads at trading; pampubliko ang reads ngunit nangangailangan ng API key + HMAC ang trading.

Dapat ba akong gumamit ng limit orders o market (FAK) orders para sa arbitrage?

Karaniwang ginagamit ang FAK (Fill-And-Kill) market orders para sa bilis at para iwasan ang lingering exposure. Maaari silang mag-partial-fill, kaya disenyo ang sizing at reconciliation ng naaayon. Nag-eexpose ang CLOB SDK ng mga helper para gumawa ng FAK market orders.

Paano ko isasaalang-alang ang fees kapag nagsu-size ng trades?

Ibawas ang inaasahang taker fees mula sa iyong gross edge bago mag-trade. Nag-iiba ang taker fees ayon sa kategorya (0% hanggang 1.8% kasalukuyang). Gumamit ng net-edge threshold na sumasaklaw sa fees pati na ang inaasahang slippage at monitoring buffers.

Ano ang mahalagang i-monitor para sa live bot?

I-monitor ang fill rates, realized slippage, latency, UMA dispute notices, tick_size_change events, at Relayer health. Mag-implement ng soft at hard kill-switches para sa malaking slippage, P&L drawdowns, o oracle disputes.

Maaari ko bang i-route ang mga order sa pamamagitan ng Builder Program?

Oo. Pinahihintulutan ng Builder Program ang third parties na i-route ang mga order na may attribution at kumita ng builder fees. Kinokontrol ng mga tier ang daily relayer limits at rewards; nakakakuha ng credentials sa polymarket.com/settings.