API · Mawakala wa AI

Boti nyingi za Polymarket mnamo 2026 hujengwa kwa kuelekeza wakala wa AI wa uandishi msimbo - Claude Code, Cursor, Copilot. Hilo ni sawa, ikiwa utamweka wakala kwenye API ya sasa ya V2 na kwenye reli ya usalama. Ukurasa huu unaonyesha jinsi: sakinisha sheria zetu + zana za kusoma-tu ili msimbo unaotolewa uwe sahihi na uanze katika hali ya karatasi, na fuata orodha ya ukaguzi kabla ya chochote kugusa pesa halisi.

Mpe wakala wako sheria kwanza. Weka faili letu la AGENTS.md ndani ya hazina yako (Claude Code, Cursor, Copilot na zingine huisoma). Linabainisha SDK za V2, URL za msingi, mikataba ya pUSD, vikwazo, na njia ya pesa ya karatasi kwa chaguomsingi - hivyo wakala huacha kuandika msimbo uliokufa wa V1 (py-clob-client 0.34 / USDC.e).

Sanidi wakala wako

  • Sheria: ongeza AGENTS.md kwenye mzizi wa hazina yako (na kiungo cha CLAUDE.md / nakala ya .cursor/rules).
  • Muktadha: elekeza wakala kwenye llms.txt yetu na marejeleo ya API ili ajibu kwa kutegemea nyaraka za sasa, si kisio la mafunzo yake.
  • Data ya msingi: sakinisha MCP ya kusoma-tu ili vitambulisho vya tokeni vitoke kwenye masoko hai, si kubuni.
  • Utoaji msimbo: kwa wateja wenye aina, elekeza kizalishaji chako kwenye spec zinazosomeka na mashine za Polymarket - CLOB OpenAPI, Data OpenAPI na spec ya AsyncAPI (WebSocket) - ili wakala ajenge kwa kutegemea schema halisi, si kisio.

Orodha ya ukaguzi ya uandishi-msimbo salama

Shikilia kila boti ya biashara iliyotolewa na AI kwenye orodha hii kabla ya kuiruhusu iendeshe halisi:

  1. Anza kusoma-tu - data ya soko kwanza, bila oda.
  2. Hali ya karatasi kwa chaguomsingi; biashara halisi inahitaji bendera dhahiri ya --live.
  3. Funguo katika mabadiliko ya mazingira (env) pekee - kamwe zisihifadhiwe ndani ya msimbo, kwenye kumbukumbu, wala kuwekwa kwenye hazina.
  4. Bainisha SDK rasmi ya V2 + URL za msingi ili wakala asiweze kubuni endpoint.
  5. Tegemea spec / MCP - usiamini endpoint ambayo wakala "anaikumbuka".
  6. Simama data ikiwa mbaya - kamwe usiweke biashara kwa upataji uliofeli au tupu.
  7. Ukaguzi wa binadamu kabla ya kuendesha halisi kwa mara ya kwanza.
  8. Vikomo vikali vya nafasi na hasara + swichi ya kuzima.
Kwa nini hili ni muhimu. Boti za biashara zilizoandikwa kwa vibe hushindwa kwa njia zinazojulikana: kufanya biashara kwa bei za kubuni, kutumia mifumo iliyokufa ya V1, kusakinisha vifurushi vya kubuni (slopsquatting), na kuhifadhi funguo ndani ya msimbo. Faili la sheria + MCP ya kusoma-tu + kiunzi cha karatasi-kwanza hufunga kila mojawapo ya hizo kwa chaguomsingi.

Kielekezo kizuri cha kwanza

Using the Polymarket V2 API (py-clob-client-v2) and the AGENTS.md rules in this repo,
write a PAPER bot that finds the BTC-above-150k market, reads its order book, and would
buy Yes under 0.40. Do NOT place live orders. Keys from env only. Fail closed on bad data.

Wakala anapaswa kutoa msimbo wa hali ya karatasi, wenye vitambulisho halisi vya tokeni (kutoka MCP/data hai), funguo zinazosomwa kutoka mazingira, na bila njia ya oda halisi isipokuwa uongeze --live mwenyewe.

Mpe wakala wako masoko halisi

Vitambulisho vya tokeni vya kubuni ni kosa namba #1 la uandishi wa vibe. Tafuta soko halisi hapa, nakili vitambulisho vyake, na uvikabidhi kwa wakala (au acha MCP ifanye hivyo):

Kifuatacho: Sheria za AGENTS.md · SDK ipi ya kutumia · Mapishi ya kunakili-kubandika · Marejeleo ya CLOB · Rekebisha hitilafu · Boilerplates.

Si ushauri wa kifedha. Biashara ya kiotomatiki huhatarisha pesa halisi - jaribu kwa hali ya karatasi na kagua kabla ya kuendesha halisi.