polymarket_trade

Polymarket Trade

Polymarket Trade provides trading operations for Polymarket prediction markets. It can create orders, cancel orders, list open orders, check balances, view active positions, and derive API keys.

In Agent Forge, the Polymarket Trade integration is intended for workflows that need to manage orders programmatically. Because trading operations can have financial impact, configure credentials carefully and test workflows before using them in production.

Usage Instructions

Provide the required private key and Polymarket API credentials, then choose a trading operation. Creating an order requires a token ID, side, price, size, order type, and funder address.

Tools

Orders

  • polymarket_trade_create_order - Create an order

  • polymarket_trade_cancel_order - Cancel a specific order

  • polymarket_trade_cancel_all_orders - Cancel all open orders

Account

  • polymarket_trade_get_open_orders - List open orders

  • polymarket_trade_get_account_balance - Get account balance

  • polymarket_trade_get_balance - Get token balance

  • polymarket_trade_get_active_positions - Get active positions

Setup

  • polymarket_trade_derive_api_keys - Derive Polymarket API credentials from a private key

Common Inputs

Parameter
Type
Required
Description

privateKey

string

Yes

Ethereum private key for signing

apiKey

string

Most operations

Polymarket L2 API key

apiSecret

string

Most operations

Polymarket L2 API secret

apiPassphrase

string

Most operations

Polymarket L2 API passphrase

funderAddress

string

Operation-specific

Proxy wallet or funder address

signatureType

string

No

Signature type, such as EOA, Poly Proxy, or Gnosis Safe

tokenId

string

Operation-specific

CLOB token ID

side

string

For create order

BUY or SELL

price

string

For create order

Order price between 0 and 1

size

string

For create order

Order size in shares

orderType

string

For create order

GTC, GTD, FOK, or FAK

orderId

string

For cancel order

Order ID to cancel

market

string

No

Market condition ID filter

Output

Parameter
Type
Description

response

json

Polymarket Trade API response

Notes

  • Category: tools

  • Type: polymarket_trade

  • Derived API keys are stored as environment variables instead of being printed to workflow output.

Was this helpful?