docs

Polymarket Node

The Polymarket node fetches live prediction market data — event titles, outcome probabilities, volume, and liquidity — from Polymarket. Use it to build workflows that monitor market sentiment, alert on probability shifts, or feed prediction data into an LLM for analysis.

Polymarket Data
BTC 100k • 10 markets

Configuration

Search

What Is Polymarket?

Polymarket is a prediction market platform where people trade on the outcomes of real-world events. Each market has outcomes (typically Yes/No) with prices between 0 and 1 that represent the crowd's estimated probability. A "Yes" price of 0.72 means the market thinks there's a 72% chance the event happens.

This data is valuable for trading workflows because prediction markets aggregate information from thousands of participants — giving you a real-time sentiment signal that goes beyond price charts and technical indicators.


Configuration

FieldDescription
QuerySearch term to filter markets. Searches across title, description, and slug. Leave empty to fetch all active markets. Examples: BTC 100k, US election, ETH ETF.
Max MarketsNumber of markets to return. Default: 10. Max: 100.
DescriptionOptional note describing what this data fetch is for.

How It Works

The node fetches active, non-closed markets from Polymarket's public API. If you provide a query, it filters results by matching against the market title, description, and slug. Results are sorted by relevance and limited to your specified count.

Each market can have multiple sub-markets (outcomes). For example, a "2026 US Presidential Election" event might have sub-markets for each candidate, each with their own probability and volume.


Understanding Outcome Prices

Outcome prices are the core data point. They represent probabilities as decimals between 0 and 1:

PriceMeaning
0.72Market estimates a 72% probability
0.28Market estimates a 28% probability
0.50Market is split 50/50 — maximum uncertainty
0.95Market is nearly certain (95%)
0.05Market thinks it's very unlikely (5%)

For binary markets (Yes/No), the two outcome prices always sum to approximately 1.0.


Using Polymarket in a Workflow

Sentiment-Driven Analysis

Feed prediction market data into an LLM to assess whether current probabilities represent good value.

Polymarket
BTC 100k
Probability Analyst
Claude Sonnet 4.6
Edge Found?
edge > 5%
Alert: Edge Found

Example LLM prompt:

System: You are a prediction market analyst. Given the market title,
current probability, and description, assess whether the current
probability represents good value.

Respond in this format:
POSITION: [BUY_YES / BUY_NO / SKIP]
EDGE: [your estimated probability minus market probability]%
REASONING: [1-2 sentences]
User: Evaluate this Polymarket market:
Title: {{polymarket.markets[0].title}}
Probability: {{polymarket.markets[0].markets[0].outcomePrices[0]}}
Description: {{polymarket.markets[0].description}}
Volume: ${{polymarket.markets[0].volume}}

Probability Alert Monitor

Set up a scheduled workflow that checks if a market's probability crosses a threshold.

Start
ScheduleEvery 30 min
Polymarket
BTC 100k
Extract Probability
Python
Above 80%?
prob > 0.80
Alert: High Probability

Multi-Signal Trading

Combine prediction market sentiment with price data for a more informed trading decision.

BTC Markets
BTC
BTC Price
CoinGecko
Combined Analysis
Claude Sonnet 4.6
Buy Signal?
signal = buy
Buy BTC
Alpaca

By combining prediction market probabilities (crowd sentiment) with actual price data (technical analysis), the LLM has a richer picture for making trading recommendations.


Output

PathDescription
{polymarket.markets}Array of prediction market events
{polymarket.markets[0].id}Unique market identifier
{polymarket.markets[0].slug}URL-friendly market slug
{polymarket.markets[0].title}Market title (e.g., "Will BTC reach $100k in 2026?")
{polymarket.markets[0].description}Full market description and resolution criteria
{polymarket.markets[0].active}Whether the market is currently active
{polymarket.markets[0].closed}Whether the market has closed
{polymarket.markets[0].volume}Total trading volume in USD
{polymarket.markets[0].liquidity}Current liquidity in USD
{polymarket.markets[0].startDate}Market start date
{polymarket.markets[0].endDate}Market end/resolution date
{polymarket.markets[0].markets}Array of sub-markets (outcomes)
{polymarket.markets[0].markets[0].question}The specific question for this outcome
{polymarket.markets[0].markets[0].outcomes}Array of outcome labels (e.g., ["Yes", "No"])
{polymarket.markets[0].markets[0].outcomePrices}Array of prices/probabilities (e.g., [0.72, 0.28])
{polymarket.markets[0].markets[0].volume}Volume for this specific sub-market
{polymarket.markets[0].markets[0].active}Whether this sub-market is active
{polymarket.count}Number of markets returned
{polymarket.query}The search query that was used

Example Output

{
  "markets": [
    {
      "id": "0x1234...",
      "slug": "will-btc-reach-100k-2026",
      "title": "Will BTC reach $100k in 2026?",
      "description": "This market resolves YES if Bitcoin reaches $100,000 USD...",
      "active": true,
      "closed": false,
      "volume": 1250000,
      "liquidity": 450000,
      "markets": [
        {
          "question": "Will BTC reach $100k in 2026?",
          "outcomes": ["Yes", "No"],
          "outcomePrices": ["0.72", "0.28"],
          "volume": 1250000,
          "active": true
        }
      ]
    }
  ],
  "count": 1,
  "query": "BTC 100k"
}

Next Steps

  • LLM Node — Feed prediction market data into an AI model for probability analysis.
  • Function Node — Extract and transform market probabilities for downstream use.
  • Conditional Node — Route your workflow based on probability thresholds.
  • Price Data Node — Combine prediction data with live crypto prices for multi-signal analysis.
  • Storage Node — Track probability changes over time between workflow runs.