polymarket-btc15m

name	polymarket-btc15m
description	Trade Polymarket Bitcoin Up/Down 15-minute markets using TA signals. Supports Clawbot mode (dynamic sizing, TP/SL, pre-settlement) or fixed mode. Use when checking signals, placing trades, or automating via private key.

Polymarket BTC 15m Trading Skill

Clawbot manages Polymarket BTC 15m trades using signals from PolymarketBTC15mAssistant.

Important Notice:

For proper operation, you must correctly configure your environment. In the POLYMARKET_PRIVATE_KEY variable, specify the private key associated with your Polymarket trading account.

Next, to configure the POLYMARKET_FUNDER variable, visit polymarket.com/settings, locate your Funder Address, and assign it to the POLYMARKET_FUNDER variable.

Modes

Mode	Toggle	Position size	Take-profit	Stop-loss	Pre-settlement sell
Clawbot	CLAWBOT_MODE=true	Dynamic from balance & risk	Yes	Yes	Yes
Fixed	CLAWBOT_MODE=false (default)	Fixed (ORDER_SIZE)	No	No	No

Clawbot mode logic

• High risk (late phase, low edge): small % of balance (2–3%), tighter SL
• Strong signal (STRONG, high edge): larger % (up to 15%), wider TP
• Reserve: always keeps 20% of balance
• Max per trade: never more than 30% of balance

Environment Variables

Variable	Required	Description
POLYMARKET_PRIVATE_KEY	Yes (trading)	Wallet private key
POLYMARKET_FUNDER	Yes (trading)	Funder from polymarket.com/settings
CLAWBOT_MODE	No	true or false (default)
POLYMARKET_ORDER_SIZE	No	Shares when Clawbot OFF (default: 5)
POLYMARKET_SIGNATURE_TYPE	No	0/1/2 (default: 2)

Commands

Get signal

npm run signal

With CLAWBOT_MODE=true, output includes clawbotParams (balance, size, TP%, SL%, sellBeforeMin).

Execute trade

npm run trade:up
npm run trade:down
node src/trade-cli.js --execute=UP --yes

Position monitor (Clawbot mode only)

One cycle:

node src/trade-cli.js --monitor

Background daemon (runs until Ctrl+C):

npm run monitor

Workflow for Clawbot

1. "What's the signal?"

   • Run npm run signal
   • Summarize: action, side, phase, strength, model probs, time left
   • If Clawbot mode: include clawbotParams (balance, suggested size, TP/SL)

2. "Place trade for UP"

   • Run npm run signal → verify ENTER + side UP
   • If match: npm run trade:up (or --execute=UP --yes if approved)
   • If mismatch: abort and explain

3. "Enable/disable Clawbot mode"

   • Set CLAWBOT_MODE=true or false in .env
   • Explain: Clawbot = dynamic sizing + auto TP/SL; Fixed = manual only

4. "Run monitor" (when Clawbot mode + open positions)

   • Run npm run monitor in background, or node src/trade-cli.js --monitor for one cycle

Safety

• No system guarantees profits. Clawbot improves edge but does not eliminate risk.
• Prefer user confirmation for trades unless automation is explicitly approved.
• Never log or expose POLYMARKET_PRIVATE_KEY.

Installation

cp -r clawbot-skill ~/.clawbot/skills/polymarket-btc15m
# or
ln -s /path/to/PolymarketBTC15mAssistant-main ~/.clawbot/skills/polymarket-btc15m

Ensure execution engine allows npm and node from the project directory.