docs

Polymarket Wallet

A Polymarket Wallet lets your workflows trade on Polymarket prediction markets and claim winnings, without giving NickAI custody of your funds. The wallet is powered by Turnkey: your connected wallet is the sole owner, and the agent key NickAI uses for trading is locked by signing policies that make withdrawing funds impossible for anyone but you.

Create a Wallet

  1. Go to Settings → Wallets, click New Wallet, and pick Polymarket.
  2. Enter a Name and connect your crypto wallet. It must be a standard wallet (EOA), not a smart-contract wallet: this address becomes the only authority that can withdraw.
  3. Approve the four signature prompts. Each one is labeled in the dialog: registering you as the wallet's owner, creating the trading agent, attaching its permission policies, and activating trading (deploying your deposit wallet and approving the exchanges).

If you close the dialog or a signature fails midway, nothing is left half-configured: reopening the setup continues from where it stopped.

Once active, the wallet page shows your deposit address. Fund it by sending pUSD (Polymarket USD) on Polygon to that address.


Trade from Workflows

Add a Polymarket Order node to a workflow and pick this wallet in its properties. The node places market orders (BUY/SELL) and can claim resolved winnings (REDEEM). Any member of your organization can run workflows that trade with the wallet; moving funds out always remains exclusive to you.


Claim Winnings

When markets you hold resolve in your favor, the winnings need to be redeemed into pUSD. Two ways:

  • From the wallet page: a Claim button appears next to the balance whenever you have resolved winning positions. It redeems all of them in one batch, signed by your owner wallet.
  • From a workflow: a Polymarket Order node with side set to REDEEM claims everything autonomously, no signature prompt needed. Schedule it to auto-claim daily.

Both paths convert the winnings to pUSD inside the same wallet; claiming never moves funds to another address.


Withdraw

Only you can withdraw. On the wallet page, click Withdraw, enter the amount and destination address, and sign with your connected owner wallet. NickAI cannot trigger or alter a withdrawal: the signature must come from your wallet.


Security

Each Polymarket Wallet is an isolated Turnkey organization with two parties:

  • You (the owner). Your connected wallet is the sole owner. Every withdrawal and every claim from the wallet page is authorized live by your wallet's signature. NickAI never holds your key.
  • The agent key. A key NickAI uses to sign orders, held inside Turnkey's secure enclave. It is not the owner: Turnkey policies restrict it to exactly two things, signing Polymarket orders and redeeming winnings back into the same wallet. Any other signature request is rejected inside the enclave.

The agent cannot transfer funds, change permissions, or add signers. Even if NickAI were fully compromised, the worst possible outcome is an unwanted trade on Polymarket, never funds leaving your wallet.


Next Steps