Agent Skill
Trade PUNCH.WIN from your terminal. An open-source skill lets a local AI agent read markets and trade them in natural language.
What Your Agent Can Do
"List active prediction events"
Event cards
"Show the BTC 1-minute market"
Prices and orderbook
"Buy 5 of UP in market <id>"
Preview, then signed and sent
"Show my balances"
Gas, collateral, positions
"Redeem my winning shares"
Settled back into collateral
"Claim my POINT"
Enters the season if needed, then mints
Reads need no wallet. Writes sign locally and preview first.
Markets
usd
pONEUSD
Real
Always open
point
POINT
Free
During an F2P season only
Without --market, the skill picks POINT while a season runs and usd otherwise, and tells you which it chose. The retired bill and cross markets are refused.
Install
Paste this into your agent:
The installer symlinks the skill into ~/.claude/skills/ and installs its Node dependencies. Node 20 or newer is required.
Where It Runs
Local agent runtimes only: Claude Code, Cursor, Codex CLI, Aider, Goose, Gemini CLI, OpenInterpreter, OpenClaw.
Hosted chat cannot execute it. Claude.ai on the web, ChatGPT on the web, and Gemini on the web have no local shell, so the skill will not run there.
Wallet Setup
The skill signs and submits transactions itself, so it needs a key it can read. Use a dedicated wallet, not your main one.
Create a fresh wallet. Any tool that gives you the private key works.
Fund it with only what you intend to risk, plus a little CROSS for gas.
Put the key in the skill's
.envfile andchmod 600it. Never paste it into chat or a command argument.
If your PUNCH.WIN account was created with Google or Apple login, it lives in a CROSSx embedded wallet. You can export that key from the CROSSx app, but an exported key carries full authority and cannot be revoked. Moving only what you need into a dedicated wallet is safer.
No Collateral Yet
Fund the wallet on PUNCH.WIN under Deposit USD. Two routes are available: deposit straight from your ONEpocket balance, or use Transfer Crypto for a reusable QR address. Transfer Crypto accepts Base USDT with a 6 USDT minimum and delivers pONEUSD to your ONEchain wallet.
Multiple Wallets
Set a seed instead of a single key and the skill derives wallets at m/44'/60'/0'/0/N.
wallets.mjs list
Every derived wallet with gas and collateral balances
wallets.mjs fund --amount 0.01 --confirm
Spread gas from wallet 0 to the rest
any command with --wallet=<n>
Act as that wallet
One seed is easier to hold safely than several loose keys, and derivation keeps your addresses attributable rather than anonymous.
Extra addresses are for isolating strategies and keeping most funds away from the wallet that trades. Free-to-play rewards and season prizes are awarded per operator, not per address.
Free to Play
POINT is claimable and scored in weekly seasons with a prize pool paid in ONE. The whole loop runs from the terminal.
f2p-status.mjs --me
Season state, prize pool, your claimable POINT
enter-season.mjs --confirm
Enter the current season. Required once per season
claim.mjs --confirm
Request authorization and mint your POINT on-chain
claim enters the season on its own when the service asks for it, and follows the referral sweep across batches. Claim transactions cost no fee, though the wallet still needs a dust CROSS balance for the network to accept them.
Command Reference
list-events get-event get-results
none
read
balance wallets list
address
read
f2p-status
wallet signature
read
buy sell
wallet signature
on-chain
redeem enter-season claim
wallet signature
on-chain
wallets fund
wallet signature
on-chain
Every mutating command previews by default. Nothing is signed or submitted until you pass --live or --confirm.
Safety Rails
Chain check
The RPC must report chain 612055 or the command aborts
Preview first
Trades and claims show their full plan before execution
Per-market caps
Real money and free money have separate limits
Address match
The signer's address must match the wallet you declared
No session reuse
The skill never reads browser cookies or saved logins
Secrets stay local
Keys are read from the environment or a local file, never from a command argument
Source
github.com/to-nexus/skill-one-punch — MIT licensed. Issues and pull requests welcome.
On-chain transactions are real and irreversible. Test with small amounts. Nothing here is financial advice, and prediction markets are restricted in some jurisdictions.
Last updated