Agent skill

Polymarket API

by aAAaqwq in aAAaqwq/AGI-Super-Team

Polymarket交易操作。统一入口scripts/trade.py,slug驱动,零browser纯API。Triggers: 'polymarket交易', 'API下单', 'buy YES', 'sell NO', 'trade', 'price', '仓位'.

MITAuto-check: notesBusiness, Finance & HR

Install Polymarket API

skills CLI
$ npx skills add aAAaqwq/AGI-Super-Team --skill polymarket-api -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install aAAaqwq/AGI-Super-Team polymarket-api --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/aAAaqwq/AGI-Super-Team.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/polymarket-api .claude/skills/polymarket-api && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
polymarket-api
GitHub stars
105
Token cost
~494 tokens
SKILL.md length
77 words
Files
4 (incl. scripts, references)
Skills in repo
152
Repo updated
First seen
Licence
MIT

At a glance

Polymarket交易操作。统一入口scripts/trade.py,slug驱动,零browser纯API。Triggers: 'polymarket交易', 'API下单', 'buy YES', 'sell NO', 'trade', 'price', '仓位'.

  • Business, Finance & HR work in your project
  • SKILL.md covers 脚本目录, 命令, 示例 and 参数说明, plus 3 more sections
  • Runs Python scripts from its folder; calls python3; needs POLY_PRIVATE_KEY and POLY_API_KEY

What it does

Polymarket API is an agent skill from aAAaqwq/AGI-Super-Team. Polymarket交易操作。统一入口scripts/trade.py,slug驱动,零browser纯API。Triggers: 'polymarket交易', 'API下单', 'buy YES', 'sell NO', 'trade', 'price', '仓位'.

Its SKILL.md is about 490 tokens, which your agent loads only when the skill is triggered. The skill folder holds 5 other files, including scripts and reference files (for example `references/data-sources.md`, `scripts/daily_market_monitor.py` and `scripts/trade.py`).

It sits in Business, Finance & HR. It works with Polymarket. The repository describes itself as: An installable, cross-framework AI organization: C-suite agents, expert subagents, curated skills, independent review, and one-command setup across 18 AI client/runtime adapters. The licence is MIT.

When your agent uses it

  • Business, Finance & HR work in your project

Example prompts

  • “polymarket交易”
  • “buy YES”
  • “sell NO”
  • “/polymarket-api”

Requirements

  • Python 3
  • A credential in POLY_PRIVATE_KEY
  • A credential in POLY_API_KEY

What it can do on your machine

Read from SKILL.md and the folder at commit 331ecd3. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 2 files in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python3

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • POLY_PRIVATE_KEY
    • POLY_API_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Polymarket API loads about 494 tokens when it runs, and up to ~1.2k if it reads all its reference files. Until then it costs about 38 tokens; SKILL.md has 77 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~38
When it runs · the whole SKILL.md, loaded when a task matches
~494
With references · SKILL.md plus every file in references/, read only if the agent opens them
~1.2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteMentions a .env fileSKILL.md:63
    - 凭证: `.env.poly` (POLY_PRIVATE_KEY + POLY_PROXY_WALLET + POLY_API_KEY/SECRET/PASSPHRASE)

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from aAAaqwq/AGI-Super-Team at commit 331ecd3, republished under its MIT licence (© aAAaqwq). 77 words, ~494 tokens.

Download SKILL.mdSave it as .claude/skills/polymarket-api/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
polymarket-api
description
Polymarket交易操作。统一入口scripts/trade.py,slug驱动,零browser纯API。Triggers: 'polymarket交易', 'API下单', 'buy YES', 'sell NO', 'trade', 'price', '仓位'.

Polymarket API Trading Skill

⚠️ 强制使用 scripts/trade.py,禁止直接调用CLOB API。

脚本目录

skills/polymarket-api/scripts/
└── trade.py    # 统一交易入口(买/卖/查价/查仓位)

命令

bash
# === 交易 ===
python3 "$SKILL_DIR/scripts/trade.py" buy <slug> <YES/NO/UP/DOWN> <金额> [--threshold N] [price]
python3 "$SKILL_DIR/scripts/trade.py" sell <slug> <YES/NO> <金额> [--threshold N] [price]

# === 查询 ===
python3 "$SKILL_DIR/scripts/trade.py" price <slug> <YES/NO> [--threshold N]
python3 "$SKILL_DIR/scripts/trade.py" info <slug> [--threshold N]

示例

bash
# BTC>$68k Mar28 买NO $10
python3 "$SKILL_DIR/scripts/trade.py" buy bitcoin-above-on-march-28 NO 10 --threshold 68000

# BTC涨跌盘 买DOWN $8
python3 "$SKILL_DIR/scripts/trade.py" buy btc-up-or-down-on-march-27-2026 DOWN 8

# 查价
python3 "$SKILL_DIR/scripts/trade.py" price ethereum-above-on-april-21 YES --threshold 2300

参数说明

参数必填说明
slug✅Gamma slug (e.g. bitcoin-above-on-march-28)
side✅YES/NO/UP/DOWN
金额buy必填 / sell可选USDC金额,sell默认全部
--threshold N多market时Above盘阈值,如68000
price可选默认自动定价(MID+1¢买/BID-1¢卖)

Slug格式

类型格式示例
Above盘{coin}-above-on-{month}-{day}bitcoin-above-on-march-28
涨跌盘{ticker}-up-or-down-on-{month}-{day}-{year}btc-up-or-down-on-march-27-2026

底层SDK(仅脚本内部使用)

  • py-clob-client-v2@1.0.0 — CLOB V2订单簿 (2026-04-28上线,V1已弃用)
  • py-builder-relayer-client — Relayer链上操作 (redeem/approve)
  • 凭证: .env.poly (POLY_PRIVATE_KEY + POLY_PROXY_WALLET + POLY_API_KEY/SECRET/PASSPHRASE)

V2迁移记录 (2026-05-02)

  • OrderArgs 移除 fee_rate_bps, V2自动计算
  • OrderArgs 移除 nonce, V2用 timestamp
  • 下单默认 FOK (Fill or Kill)
  • Cloudflare 对 create_or_derive_api_key 有403干扰,但 fallback 正常

© aAAaqwq, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 3 other files (scripts, references) in skills/polymarket-api of aAAaqwq/AGI-Super-Team.

  • SKILL.md
  • references/data-sources.md
  • scripts/daily_market_monitor.py
  • scripts/trade.py

Open the folder on GitHubat commit 331ecd3

Compare with similar skills

Polymarket API next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Polymarket API compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Polymarket API this skillaAAaqwq/AGI-Super-Team105—~494Automated safety check: NotesMIT
Digital Oraclekomako-workshop/digital-oracle870—~5.9kAutomated safety check: PassMIT
Fintoolsecond-state/fintool3161 repos~5.9kAutomated safety check: PassNone
Polyclawchainstacklabs/polyclaw3601 repos~2kAutomated safety check: PassApache-2.0
Polymarket TradingBlockRunAI/ClawRouter6.6k—~1.4kAutomated safety check: PassMIT
Dr Manhattanguzus/dr-manhattan204—~2kAutomated safety check: PassApache-2.0

Similar skills

  • Digital Oracle

    komako-workshop/digital-oracle

    Answer prediction questions using market trading data, not opinions.

    870 GitHub stars~5.9k tokensUpdated 2 mo ago
    Business, Finance & HRAuto-check passed
  • Fintool

    second-state/fintool

    Financial trading CLIs — spot and perp trading on Hyperliquid, Binance, Coinbase, OKX.

    316 GitHub starsUsed in 1 repo~5.9k tokens
    Business, Finance & HRAuto-check passed
  • Polyclaw

    chainstacklabs/polyclaw

    Trade on Polymarket via split + CLOB execution. An agent skill from chainstacklabs/polyclaw.

    360 GitHub starsUsed in 1 repo~2k tokens
    Business, Finance & HRAuto-check passed
  • Polymarket Trading

    BlockRunAI/ClawRouter

    A skill your agent uses when the user wants to actually PLACE, manage, or redeem bets on Polymarket (not just read odds — that's the blockrunpredexon data tools).

    6.6k GitHub stars~1.4k tokensUpdated 3 days ago
    Business, Finance & HRAuto-check passed
  • Dr Manhattan

    guzus/dr-manhattan

    Trade prediction markets (Polymarket, Kalshi, Opinion, Limitless, Predict.fun) using a unified CCXT-style API.

    204 GitHub stars~2k tokensUpdated 2 mo ago
    Business, Finance & HRAuto-check passed
  • Polymarket Tennis

    livetennisapi/livetennisapi-mcp

    Build observe-only Polymarket and Kalshi tennis market tooling on the polymarket-tennis Python package (MIT) plus the Live Tennis API free tier.

    152 GitHub stars~3k tokensUpdated yesterday
    Business, Finance & HRAuto-check passed

More from aAAaqwq/AGI-Super-Team

All 152 skills in this repo
  • Content Creator

    aAAaqwq/AGI-Super-Team

    Create SEO-optimized marketing content with consistent brand voice.

    105 GitHub starsUsed in 3 repos~1.9k tokens
    Auto-check passed
  • Financial Calculator

    aAAaqwq/AGI-Super-Team

    Advanced financial calculator with future value tables, present value, discount calculations, markup pricing, and compound interest.

    105 GitHub starsUsed in 1 repo~1.5k tokens
    Auto-check passed
  • Frontend Design Ultimate

    aAAaqwq/AGI-Super-Team

    Create distinctive, production-grade static sites with React, Tailwind CSS, and shadcn/ui — no mockups needed.

    105 GitHub starsUsed in 2 repos~2.7k tokens
    Auto-check passed
  • Sysadmin Toolbox

    aAAaqwq/AGI-Super-Team

    Tool discovery and shell one-liner reference for sysadmin, DevOps, and security tasks.

    105 GitHub starsUsed in 2 repos~775 tokens
    Auto-check passed
  • Zsxq Smart Publish

    aAAaqwq/AGI-Super-Team

    Publish and manage content on 知识星球 (zsxq.com). An agent skill from aAAaqwq/AGI-Super-Team.

    105 GitHub stars~1.5k tokensUpdated 11 days ago
    Auto-check passed
  • Content Extract

    aAAaqwq/AGI-Super-Team

    Robust URL-to-Markdown extraction for OpenClaw workflows. An agent skill from aAAaqwq/AGI-Super-Team.

    105 GitHub starsUsed in 1 repo~650 tokens
    Auto-check passed

Works with

Questions about Polymarket API

What does Polymarket API do?

Polymarket交易操作。统一入口scripts/trade.py,slug驱动,零browser纯API。Triggers: 'polymarket交易', 'API下单', 'buy YES', 'sell NO', 'trade', 'price', '仓位'. Polymarket API is an agent skill from aAAaqwq/AGI-Super-Team.py,slug驱动,零browser纯API。Triggers: 'polymarket交易', 'API下单', 'buy YES', 'sell NO', 'trade', 'price', '仓位'.

When should I use Polymarket API?

Polymarket API fits situations like: business, Finance & HR work in your project.

How do I install Polymarket API in Claude Code?

Run `npx skills add aAAaqwq/AGI-Super-Team --skill polymarket-api -a claude-code`. Or copy the skill folder (skills/polymarket-api in aAAaqwq/AGI-Super-Team) into .claude/skills/polymarket-api in your project. Claude Code loads it when a task matches its description.

How do I install Polymarket API in Codex?

Run `npx skills add aAAaqwq/AGI-Super-Team --skill polymarket-api -a codex`. Or copy the skill folder (skills/polymarket-api in aAAaqwq/AGI-Super-Team) into .agents/skills/polymarket-api in your project. Codex loads it when a task matches its description.

Can I use Polymarket API in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add aAAaqwq/AGI-Super-Team --skill polymarket-api -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/polymarket-api, .gemini/skills/polymarket-api, .github/skills/polymarket-api and .opencode/skills/polymarket-api in your project.

What does Polymarket API need to run?

Going by SKILL.md and its folder, Polymarket API needs Python for the scripts in its folder, the command-line tools its instructions call (python3) and credentials named POLY_PRIVATE_KEY and POLY_API_KEY. Our summary lists: Python 3; A credential in POLY_PRIVATE_KEY; A credential in POLY_API_KEY.

Does Polymarket API access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Polymarket API safe to install?

Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Polymarket API use?

Polymarket API is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Polymarket API use?

About 494 tokens (SKILL.md is roughly 2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 681 tokens, read only when the agent opens those files.

What are the alternatives to Polymarket API?

Skills that share tags, products or a category with Polymarket API: Digital Oracle (komako-workshop/digital-oracle, 870 stars), Fintool (second-state/fintool, 316 stars), Polyclaw (chainstacklabs/polyclaw, 360 stars) and Polymarket Trading (BlockRunAI/ClawRouter, 6.6k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Polymarket API?

aAAaqwq (a GitHub user) maintains it in aAAaqwq/AGI-Super-Team, which has 105 GitHub stars. The repository holds 152 skills in this directory. The repository was last updated on September 27, 2026.

Source: aAAaqwq/AGI-Super-Team on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.