@elizaos/plugin-polymarket-app 2.0.3-beta.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Shaw Walters and elizaOS Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,82 @@
+# @elizaos/plugin-polymarket-app
+
+Native Polymarket app plugin for elizaOS — market discovery, orderbook quote reads, position reads, and trading readiness context.
+
+## What it does
+
+Adds Polymarket prediction-market capabilities to an Eliza agent:
+
+- **Market discovery** — lists active markets from the Polymarket Gamma API with bid/ask prices and 24-hour volume.
+- **Single market detail** — fetches a market by Gamma ID or slug, including all outcome prices and CLOB token IDs.
+- **Orderbook quotes** — reads full CLOB bid/ask depth for a token ID and derives best bid, best ask, midpoint, and spread.
+- **Wallet positions** — returns open positions for a given wallet address from the Polymarket Data API.
+- **Trading readiness** — reports which credentials are configured and why signed order placement is currently disabled.
+- **UI views** — desktop, XR, and TUI views registered in the elizaOS view registry.
+
+## Enabling the plugin
+
+Add the package to the agent's plugin list:
+
+```ts
+import { polymarketPlugin } from "@elizaos/plugin-polymarket-app";
+
+const agent = {
+  plugins: [polymarketPlugin],
+  // ...
+};
+```
+
+No credentials are required for public reads. Trading configuration is optional (see below).
+
+## Agent action: `PREDICTION_MARKET`
+
+The plugin registers one agent action. Pass `action` (or `subaction`) and `kind` parameters:
+
+| `action` | `kind` | Required params | Description |
+|----------|--------|-----------------|-------------|
+| `read` | `status` | — | Readiness and credential report |
+| `read` | `markets` | — | Active market list (`limit` 1–100, `offset`) |
+| `read` | `market` | `id` or `slug` | Single market detail |
+| `read` | `orderbook` | `tokenId` (CLOB token id) | Full orderbook with best bid/ask |
+| `read` | `positions` | `user` (wallet address) | Open positions for a wallet |
+| `place_order` | — | — | Reports readiness; does not place trades |
+
+Legacy action names (`POLYMARKET_READ`, `POLYMARKET_STATUS`, `POLYMARKET_GET_MARKETS`, `POLYMARKET_GET_ORDERBOOK`, `POLYMARKET_PLACE_ORDER`, etc.) are accepted as similes.
+
+## API routes
+
+The plugin registers these HTTP routes on the agent's API server:
+
+| Method | Path | Query params |
+|--------|------|-------------|
+| GET | `/api/polymarket/status` | — |
+| GET | `/api/polymarket/markets` | `limit`, `offset`, `active`, `closed`, `order`, `ascending`, `tag_id` |
+| GET | `/api/polymarket/market` | `id` or `slug` |
+| GET | `/api/polymarket/orderbook` | `token_id` |
+| GET | `/api/polymarket/positions` | `user` |
+| GET / POST | `/api/polymarket/orders` | Returns 501 (disabled) |
+
+## Environment variables
+
+Public reads (markets, orderbook, positions) require no credentials.
+
+Signed CLOB trading is disabled in this app integration. When credentials are present the status endpoint reports readiness; the `place_order` action still returns a readiness report only.
+
+| Variable | Alias | Purpose |
+|----------|-------|---------|
+| `POLYMARKET_PRIVATE_KEY` | — | Wallet private key for signed orders |
+| `CLOB_API_KEY` | `POLYMARKET_CLOB_API_KEY` | CLOB API key |
+| `CLOB_API_SECRET` | `POLYMARKET_CLOB_SECRET` | CLOB API secret |
+| `CLOB_API_PASSPHRASE` | `POLYMARKET_CLOB_PASSPHRASE` | CLOB API passphrase |
+
+## Orderbook semantics
+
+The `/api/polymarket/orderbook` route reads the full CLOB orderbook for a token id and derives best bid, best ask, midpoint, and spread from all returned levels (it does not assume the upstream CLOB response is sorted). Use the CLOB `token_id`, not the Gamma `conditionId` — a market has one condition id but one or more CLOB token ids (one per outcome).
+
+## Building
+
+```bash
+bun run --cwd plugins/plugin-polymarket-app build
+```
+
+This runs tsup (runtime bundle), Vite (view bundle for desktop/TUI views), and tsc (type declarations).

package/assets/hero.svg

@@ -0,0 +1,47 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="1200" height="675" viewBox="0 0 1200 675" role="img" aria-labelledby="title desc">
+  <title id="title">Polymarket</title>
+  <desc id="desc">Prediction market dashboard hero artwork with market probability cards.</desc>
+  <defs>
+    <linearGradient id="bg" x1="0" y1="0" x2="1" y2="1">
+      <stop offset="0" stop-color="#10291f"/>
+      <stop offset="0.58" stop-color="#174335"/>
+      <stop offset="1" stop-color="#f0c66f"/>
+    </linearGradient>
+    <linearGradient id="card" x1="0" y1="0" x2="1" y2="1">
+      <stop offset="0" stop-color="#f7fff8" stop-opacity="0.98"/>
+      <stop offset="1" stop-color="#e8f5ee" stop-opacity="0.94"/>
+    </linearGradient>
+    <filter id="shadow" x="-20%" y="-20%" width="140%" height="140%">
+      <feDropShadow dx="0" dy="22" stdDeviation="22" flood-color="#07140f" flood-opacity="0.28"/>
+    </filter>
+  </defs>
+  <rect width="1200" height="675" fill="url(#bg)"/>
+  <path d="M0 556C176 493 278 526 423 482C582 433 653 315 813 301C969 287 1087 372 1200 335V675H0Z" fill="#0b1d17" opacity="0.42"/>
+  <path d="M0 100C123 58 222 91 342 59C475 24 580 -14 706 52C837 121 925 116 1200 42V0H0Z" fill="#ffffff" opacity="0.08"/>
+  <g filter="url(#shadow)">
+    <rect x="94" y="90" width="420" height="496" rx="32" fill="url(#card)"/>
+    <rect x="134" y="136" width="172" height="18" rx="9" fill="#1c3d31"/>
+    <rect x="134" y="176" width="300" height="13" rx="6.5" fill="#6b7f76" opacity="0.72"/>
+    <rect x="134" y="230" width="332" height="96" rx="22" fill="#ffffff"/>
+    <rect x="134" y="352" width="332" height="96" rx="22" fill="#ffffff"/>
+    <rect x="134" y="474" width="332" height="58" rx="18" fill="#10291f"/>
+    <path d="M168 286C202 264 225 302 256 279C285 258 301 246 336 265C365 281 385 271 430 250" fill="none" stroke="#23a879" stroke-width="8" stroke-linecap="round"/>
+    <path d="M168 407C203 390 222 430 258 414C291 399 307 362 344 383C381 404 404 395 430 371" fill="none" stroke="#d49b2b" stroke-width="8" stroke-linecap="round"/>
+    <circle cx="430" cy="250" r="12" fill="#23a879"/>
+    <circle cx="430" cy="371" r="12" fill="#d49b2b"/>
+    <text x="164" y="265" font-family="Inter, Arial, sans-serif" font-size="24" font-weight="700" letter-spacing="0" fill="#10291f">YES 64%</text>
+    <text x="164" y="386" font-family="Inter, Arial, sans-serif" font-size="24" font-weight="700" letter-spacing="0" fill="#10291f">NO 36%</text>
+    <text x="164" y="511" font-family="Inter, Arial, sans-serif" font-size="22" font-weight="700" letter-spacing="0" fill="#f7fff8">Track position</text>
+  </g>
+  <g filter="url(#shadow)">
+    <rect x="580" y="130" width="520" height="410" rx="34" fill="#f7fff8" opacity="0.96"/>
+    <text x="628" y="214" font-family="Inter, Arial, sans-serif" font-size="62" font-weight="800" letter-spacing="0" fill="#10291f">Polymarket</text>
+    <text x="632" y="266" font-family="Inter, Arial, sans-serif" font-size="28" font-weight="500" letter-spacing="0" fill="#466158">Prediction markets, resolved cleanly.</text>
+    <rect x="632" y="322" width="390" height="18" rx="9" fill="#d9e7df"/>
+    <rect x="632" y="322" width="286" height="18" rx="9" fill="#23a879"/>
+    <rect x="632" y="374" width="312" height="18" rx="9" fill="#d9e7df"/>
+    <rect x="632" y="374" width="122" height="18" rx="9" fill="#d49b2b"/>
+    <rect x="632" y="426" width="430" height="52" rx="18" fill="#10291f"/>
+    <text x="660" y="460" font-family="Inter, Arial, sans-serif" font-size="22" font-weight="700" letter-spacing="0" fill="#f7fff8">Markets, watchlist, and activity</text>
+  </g>
+</svg>

package/package.json

@@ -0,0 +1,75 @@
+{
+  "name": "@elizaos/plugin-polymarket-app",
+  "version": "2.0.3-beta.2",
+  "type": "module",
+  "main": "./dist/index.js",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "eliza-source": {
+        "types": "./src/index.ts",
+        "import": "./src/index.ts",
+        "default": "./src/index.ts"
+      },
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./plugin": {
+      "types": "./dist/plugin.d.ts",
+      "import": "./dist/plugin.js",
+      "default": "./dist/plugin.js"
+    },
+    "./*.css": "./dist/*.css",
+    "./*": {
+      "types": "./dist/*.d.ts",
+      "eliza-source": {
+        "types": "./src/*.ts",
+        "import": "./src/*.ts",
+        "default": "./src/*.ts"
+      },
+      "import": "./dist/*.js",
+      "default": "./dist/*.js"
+    }
+  },
+  "dependencies": {
+    "@elizaos/app-core": "2.0.3-beta.2",
+    "@elizaos/core": "2.0.3-beta.2",
+    "@elizaos/shared": "2.0.3-beta.2",
+    "@elizaos/ui": "2.0.3-beta.2",
+    "lucide-react": "^1.0.0",
+    "react": "^19.0.0"
+  },
+  "elizaos": {
+    "app": {
+      "heroImage": "assets/hero.png"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "types": "./dist/index.d.ts",
+  "scripts": {
+    "build": "bun run build:js && bun run build:views && bun run build:types",
+    "clean": "rm -rf dist",
+    "test": "vitest run --config vitest.config.ts",
+    "build:js": "tsup --config ../tsup.plugin-packages.shared.ts",
+    "build:views": "bunx --bun vite build --config vite.config.views.ts",
+    "build:types": "tsc --noCheck -p tsconfig.build.json"
+  },
+  "files": [
+    "assets",
+    "dist"
+  ],
+  "devDependencies": {
+    "@testing-library/react": "^16.3.2",
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0",
+    "jsdom": "^29.0.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "tsup": "^8.5.1",
+    "vite": "^8.0.0",
+    "vitest": "^4.1.5"
+  },
+  "gitHead": "82fe0f44215954c2417328203f5bd6510985c1fc"
+}