n8n-nodes-polymarket

This is an n8n community node that provides integration with Polymarket, a decentralized prediction market platform. Discover tradeable markets, filter by categories, and access real-time market data directly in your n8n workflows.

n8n is a fair-code licensed workflow automation platform.

---

📦 Installation

In n8n (Recommended)

1. Go to Settings > Community Nodes
2. Select Install
3. Enter n8n-nodes-polymarket in the npm package name field
4. Click Install
5. Restart n8n

Manual Installation

npm install n8n-nodes-polymarket

After installation, restart n8n to load the new node.

---

✨ Current Features (Part 1: Market Info)

🟢 Available Now - Gamma API Integration

Discover and analyze prediction markets with comprehensive market data access:

5 Fetch Methods

1. Get Tags List - Retrieve all market categories (Politics, Crypto, Sports, etc.)
2. By Slug - Fetch specific markets or events by URL slug
3. By Tags - Filter markets by category/topic
4. Via Events Endpoint - Browse all active markets efficiently
5. Search - Find markets using keywords

Resource Types

• Events - Groups of related markets (e.g., "2024 US Election" with multiple outcome markets)
• Markets - Individual tradeable prediction markets

Advanced Filtering

• Active/Closed/Archived status
• Pagination (limit, offset)
• Sorting (by volume, liquidity, created date, ID)
• Tag-based filtering with related tags
• Default: Active markets only (no old/closed data)

Data Retrieved

• Market questions and descriptions
• Token IDs for trading preparation
• Current outcome prices
• Trading volume and liquidity
• Market metadata and status
• Category tags and classifications

---

🚧 Coming Soon

Part 2: Trading Operations (CLOB API) - In Development

• Create buy/sell orders (Market & Limit orders)
• Cancel orders
• View orderbook depth
• Real-time price feeds
• Order management

Part 3: User Data & Positions (Data API) - Planned

• View all positions
• Track profit/loss
• Trade history
• Portfolio analytics
• Performance metrics

---

🚀 Quick Start

Example 1: Get All Market Categories

1. Add Polymarket node to workflow
2. Operation: Market Info (Gamma API)
3. Fetch Method: Get Tags List
4. Execute

Result: List of all categories with IDs (Politics, Crypto, Sports, etc.)

Example 2: Browse Active Crypto Markets

1. Operation: Market Info (Gamma API)
2. Fetch Method: By Tags
3. Resource Type: Market
4. Tag ID: 21 (Crypto - get from Tags List)
5. Filters:
   - Active: Yes
   - Closed: No
   - Limit: 20
6. Execute

Result: Active cryptocurrency prediction markets

Example 3: Search for Specific Markets

1. Operation: Market Info (Gamma API)
2. Fetch Method: Search
3. Search Query: "bitcoin"
4. Execute

Result: All markets mentioning "bitcoin"

Example 4: Get Market Details for Trading

1. Operation: Market Info (Gamma API)
2. Fetch Method: By Slug
3. Resource Type: Market
4. Slug: bitcoin-above-100k-by-2025
5. Execute

Result: Complete market data including token IDs needed for trading

---

📖 Usage Examples

Workflow 1: Daily Market Report

Schedule (Daily 9AM)
  ↓
Polymarket (Get Active Events)
  ↓
Filter (volume > 100000)
  ↓
Email (Send report)

Workflow 2: Category Monitor

Schedule (Every hour)
  ↓
Polymarket (By Tags: Politics)
  ↓
Sort (by volume)
  ↓
Slack (Alert on high volume)

Workflow 3: Market Discovery Bot

Schedule (Every 30 min)
  ↓
Polymarket (Via Events Endpoint)
  ↓
Filter (new markets)
  ↓
Database (Store for analysis)

Workflow 4: Price Alert System

Schedule (Every 5 min)
  ↓
Polymarket (By Slug: specific market)
  ↓
Compare (price vs threshold)
  ↓
Notification (if condition met)

---

🎯 Operations Reference

Market Info (Gamma API)

Fetch Method	Best For	Returns
Get Tags List	Finding categories	Tag IDs and labels
By Slug	Specific market/event lookup	Single result
By Tags	Category filtering	Markets in category
Via Events	Browsing all markets	Bulk market data
Search	Keyword search	Matching markets

Available Filters

Filter	Type	Default	Description
Active	Boolean	Yes	Only active markets
Closed	Boolean	No	Include closed markets
Archived	Boolean	No	Include archived markets
Limit	Number	50	Results per page
Offset	Number	0	Pagination offset
Order By	String	ID	Sort field
Sort Direction	Boolean	Descending	Sort order

---

🔑 Important Data Fields

From Market Response

{
  "id": "789",
  "question": "Will Bitcoin reach $100k by 2025?",
  "conditionId": "0xe3b423...",
  "slug": "bitcoin-100k-2025",
  "clobTokenIds": [
    "token_yes_id",  // Index 0 = Yes outcome
    "token_no_id"    // Index 1 = No outcome
  ],
  "outcomePrices": ["0.65", "0.35"],
  "volume": "1000000.50",
  "liquidity": "50000.00",
  "active": true,
  "closed": false
}

Key fields for trading prep:

• clobTokenIds: Token IDs for placing orders
• conditionId: Market identifier
• outcomePrices: Current market prices
• slug: For URL references

---

📚 API Documentation

This node integrates with Polymarket's APIs:

• Gamma API (Current): Market discovery and metadata

  • Base URL: https://gamma-api.polymarket.com
  • Gamma API Docs

• CLOB API (Coming Soon): Trading operations

  • Base URL: https://clob.polymarket.com
  • CLOB API Docs

• Data API (Planned): User positions and history

  • Base URL: https://data-api.polymarket.com

---

🗺️ Roadmap

✅ Phase 1: Market Discovery (Complete)

• Gamma API integration
• Tag-based filtering
• Search functionality
• Event and market browsing
• Advanced filtering and sorting

🔨 Phase 2: Trading Operations (In Progress)

• CLOB API authentication
• Order creation (Market & Limit)
• Order cancellation
• Orderbook access
• Real-time pricing

📋 Phase 3: User Data (Planned)

• Position tracking
• Trade history
• Portfolio analytics
• P&L calculations
• Performance metrics

🌟 Phase 4: Real-time Updates (Future)

• WebSocket integration
• Live price feeds
• Order status updates
• Market notifications

---

🐛 Troubleshooting

Common Issues

Getting old/closed markets

• ✅ Solution: Ensure filters are set to Active: Yes and Closed: No

Can't find category

• ✅ Solution: Use "Get Tags List" to find correct tag IDs

No results returned

• ✅ Solution: Try removing filters or increasing limit

Tag filtering not working

• ✅ Solution: Use Tag ID (number) not tag name (string)

Enable Debug Logging

In n8n, enable debug mode to see detailed request/response data:

export N8N_LOG_LEVEL=debug
n8n start

---

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Development Setup

# Clone repository
git clone https://github.com/yourusername/n8n-nodes-polymarket.git
cd n8n-nodes-polymarket

# Install dependencies
npm install

# Build
npm run build

# Link for local testing
npm link

# In your n8n installation
npm link n8n-nodes-polymarket

# Restart n8n

Project Structure

n8n-nodes-polymarket/
├── package.json
├── tsconfig.json
├── gulpfile.js
├── README.md
├── credentials/
│   └── PolymarketApi.credentials.ts
└── nodes/
    └── Polymarket/
        ├── Polymarket.node.ts
        └── polymarket.png

---

📄 License

MIT

---

🔗 Resources

• Polymarket Website
• Polymarket Documentation
• n8n Documentation
• n8n Community

---

⚠️ Disclaimer

This is a community-developed integration and is not officially affiliated with or endorsed by Polymarket or n8n.io.

Trading Warning: Prediction markets involve risk. This tool is for informational and automation purposes. Always verify data and trade responsibly. Past performance does not guarantee future results.

---

💬 Support

• 🐛 Report Issues
• 💡 Feature Requests
• 📖 Documentation
• 💬 n8n Community Forum

---

🎉 Acknowledgments

• Polymarket - Prediction market platform
• n8n - Workflow automation
• Community contributors and testers

---

Built with ❤️ for the n8n community

Current Version: 1.0.0 (Part 1: Market Info)

Last Updated: January 2026