Widget builder — Prediction SPA

Widget configuration

Load preset

Preset name

Mode

Business code

Market platform

Which prediction market to source data from. Default omits market-platform from the snippet so the server's global default applies. Pick PM/KL/PU to pin it (and preview it).

Account ID (preview only)

Explore redirect path

Where the Purchase Challenge button sends visitors when there's no active account — explore mode, or dashboard before an accountId is pushed. A path on your host site (e.g. /funding); defaults to /challenges.

No-account action

What to show when there's no active account. Redirect uses the path + label below; KYC shows the in-widget Polymarket US onboarding form (falls back to redirect off PU).

CTA button label

Overrides the redirect button text — e.g. Sign up, Log in.

CTA message

Supporting line above the redirect button.

KYC intro text

Intro shown above the Polymarket US onboarding (KYC) form. (PU only.)

Color scheme

Forces the iframe's color scheme so a transparent --pm-bg stays transparent even when the host page sets color-scheme: dark. Auto inherits the host (the old behavior — can paint a stray white/dark box behind a transparent widget).

Public preset (shareable by slug)

Category menu — CMS

The curated top strip, served from the backend (/api/menu) — not the embed snippet. Saved per business (DEFAULT) and per platform; the widget fetches the strip for whichever platform it runs on. Empty slug = an "All Markets" reset item.

Reset removes the saved menu for the selected platform tab so it shows the global DEFAULT menu again. Editing the DEFAULT business resets to the built-in shipped menu. Reset all clears every business except DEFAULT.

Order features — per business

Enable/disable the Position Risk (TP / SL) and Limit Orders features for this business (DEFAULT). The firm-wide policy on the Settings page decides whether this per-business choice is honored. Served from the backend (/api/features), not the embed snippet.

Position Risk (TP / SL)

Limit Orders

ISV integration (Polymarket US) — per business

Where we POST KYC + trade events for DEFAULT so the agency can link the Polymarket account to their user and move balances. Every delivery is HMAC-signed (X-PredictionSpa-Signature: sha256=…). The base endpoint receives everything; the per-category overrides (KYC / orders / positions) let you route to different servers — an empty category inherits the base. The default trade limit is the fallback max USD per order when an embed omits pu-trade-limit.

Base webhook URL

Base secret

Per-category overrides (optional)

KYC

Orders

Positions

Default trade limit ($)

Require parent trade validation Block Place Order unless the host app pushed a permission verdict (PMWidgetFrame.setTradeValidation). Fail-closed: with no verdict, trading is blocked.

Appearance — style overrides

Every --pm-* variable, grouped by surface. Edited values go into data-style-overrides. Blank = widget default.

Include all default variables in embed snippet

Live preview

Embed snippet

Paste this into any host page. The <div> is the mount point, the <script> is the loader that builds the iframe. Replace the host in the URLs with your deployed domain.

Include accountId example (dashboard mode)

Dashboard mode needs the trader's account. PMWidgetFrame.setAccountId() (defined by the loader) pushes it into every widget on the page — call it any time after the loader tag; messages queue until the iframe is ready.