Glossary

Plain-English definitions of every acronym, term, and Polymarket concept this guide uses. If a word appears in a bot page and is not defined here, file an issue.

A–C

Authority hierarchy: Risk > Security > Execution > Strategy > Discovery > Intelligence > Governance. A higher-authority layer can always block a lower one.
Bot class: One of: Guardrail, Execution Utility, Alpha Strategy, Signal Service, Governance Service, User Tool. Class describes what a bot does; layer describes where it sits.
Builder attribution: Polymarket's mechanism for paying integrators a share of the trading fee. In V2, attribution lives in the builderCode field on the signed order. Maker max 50 bps, taker max 100 bps.
Builder code: A bytes32 identifier for an integrator. Set on every order to claim attribution. Replaces V1's HMAC headers.
CLOB: Central Limit Order Book. Polymarket's matching engine. V2 since Apr 28, 2026.
condition_id: The 32-byte hex identifier of a Polymarket market on Polygon.
CTFExchangeV2: The on-chain settlement contract for V2. matchOrders() is the entry point.

D–G

Data API: https://data-api.polymarket.com. Public, no auth. Historical fills, prices, volumes.
EIP-712: The Ethereum standard for signing typed data. V2 Exchange domain version is "2"; ClobAuth stays at "1".
ExecutionPlan: The output of the Risk pipeline; the input to the Execution layer. See the schema on the Principles page.
Failure-mode block: The four-field summary every bot must declare: main_failure_mode, false_positive_risk, false_negative_risk, safe_fallback.
Gamma API: https://gamma-api.polymarket.com. Public, no auth. Markets and events metadata, including negRisk flags.
GovernanceLog: The immutable, audit-grade log emitted by Governance bots for every config change, manual override, or reconciliation event.

H–N

Idempotency: Running a bot twice with the same input must produce the same effect once. Idempotency keys live on the OrderIntent (intent_id) and propagate through the pipeline.
Liquidity-Pulse: The internal liquidity-quality model used by MarketQualityRanker and OpportunityQueue. Section 3.14 in the catalogue. Not a copy-trading feature.
Maker rebate: 20–25% of fees collected, paid in pUSD, calculated per market. April 2026 pool: $5M for sports + esports.
NegRiskAdapter: The on-chain contract that lets you burn NO across a negative-risk set and receive pUSD, optionally re-minting YES elsewhere.
Negative-risk market: A Polymarket market type where outcomes are mutually exclusive and the sum of YES prices ought to equal $1. Sub-types: standard (closed set) and augmented (open set with explicit "Other"). Convert-arb opportunities exist when sum < $1.

O–S

OrderIntent: The standard message a Strategy emits. Read by every Risk bot. Carries strategy_id, market_id, side, size_usd, price, order_type, optional builder block.
Optimistic Oracle: UMA's resolution mechanism. $750 pUSD proposer bond, 2-hour challenge window. Disputed twice → escalates to UMA DVM (24–48h debate + ~48h voting).
Platform fee: Polymarket's protocol fee. Formula: C × feeRate × p × (1-p). Peaks at p = 0.5. Currently taker-only. Crypto markets up to 1.80%, sports 0.75%, geopolitical/global free.
pUSD: Polymarket's V2 collateral asset. Standard ERC-20, USDC-backed. Replaces USDC.e.
Reason code: A stable, UPPER_SNAKE_CASE machine identifier on every bot output. See the reason-codes registry.
RiskVote: The output schema every Risk bot uses. APPROVE / RESHAPE_REQUIRED / REJECT / WARNING_ONLY.
RTDS: Real-time data stream. WebSocket endpoint wss://ws-live-data.polymarket.com. Crypto prices, equity prices, comments topics.

T–Z

Tick size: The minimum price increment on Polymarket. Currently 0.001 (0.1¢). Can change per market — observe the tick_size_change WebSocket event.
UMA: Universal Market Access. The protocol behind Polymarket's Optimistic Oracle.
WebSocket channels: Four endpoints. Market (book / trades / resolution events), User (auth-required, your fills/orders), Sports (live game data), RTDS (real-time price feeds). Distinct hostnames.