Skip to main content
GET
/
v1
/
events
/
search
Event Search
curl --request GET \
  --url https://api.example.com/v1/events/search
{
  "query": "Fed rate",
  "events": [
    {
      "id": "51456",
      "slug": "how-many-fed-rate-cuts-in-2026",
      "title": "How many Fed rate cuts in 2026?",
      "image": "https://polymarket-upload.s3.us-east-2.amazonaws.com/how-many-fed-rate-cuts-in-2025-9qstZkSL1dn0.jpg",
      "active": true,
      "markets": [
        {
          "question": "Will no Fed rate cuts happen in 2026?",
          "groupItemTitle": "0 (0 bps)",
          "conditionId": "0xd4e77ba6f29fc093509d24f508631abd445ecf506bbdc9c4c80e60256a318527",
          "tokenId": "12403602920039269077597917340921667997547115084613238528792639013246536343316",
          "price": 0.348,
          "active": true
        },
        {
          "question": "Will 1 Fed rate cut happen in 2026?",
          "groupItemTitle": "1 (25 bps)",
          "conditionId": "0x5e082f0b57f47a29044aa35b4c5658393122e659d5feae521c06b57cdd7f905c",
          "tokenId": "113379839734351069617987084078322474966003108854908079701423911002443710490196",
          "price": 0.19,
          "active": true
        },
        {
          "question": "Will 2 Fed rate cuts happen in 2026?",
          "groupItemTitle": "2 (50 bps)",
          "conditionId": "0xe0d9f508a249e0070db06eb7d1e1fb17eb23c963f6fb722c4c3f81e23240c1cd",
          "tokenId": "72535544017897924722695722172278828562733090748474862987195303914909938482758",
          "price": 0.165,
          "active": true
        }
      ]
    },
    {
      "id": "101936",
      "slug": "fed-rate-hike-in-2026",
      "title": "Fed rate hike in 2026?",
      "image": "https://polymarket-upload.s3.us-east-2.amazonaws.com/will-the-fed-raise-interest-rates-in-2025-PQTEYZMvmAGr.jpg",
      "active": true,
      "markets": [
        {
          "question": "Fed rate hike in 2026?",
          "groupItemTitle": "",
          "conditionId": "0x80b3af88cb991980e8da1ce86b9794a0957f96ec98c29319dd7ba65e9744d82b",
          "tokenId": "75028752776148090296091099469912621384650554615761384992997579209329182670110",
          "price": 0.33,
          "active": true
        }
      ]
    }
  ],
  "count": 2
}
Search for events by keyword. Each result includes the full list of sub-markets with tokenId (YES token for CLOB price history) and current price. This is an event-level search — results are grouped by event, not individual markets. A multi-outcome event like “How many Fed rate cuts in 2026?” returns as one result with all 13 outcomes.
​
q
string
required
Search query (e.g., recession, Fed rate, Trump tariff).
​
limit
number
default:"10"
Maximum number of events to return. Max 20.
{
  "query": "Fed rate",
  "events": [
    {
      "id": "51456",
      "slug": "how-many-fed-rate-cuts-in-2026",
      "title": "How many Fed rate cuts in 2026?",
      "image": "https://polymarket-upload.s3.us-east-2.amazonaws.com/how-many-fed-rate-cuts-in-2025-9qstZkSL1dn0.jpg",
      "active": true,
      "markets": [
        {
          "question": "Will no Fed rate cuts happen in 2026?",
          "groupItemTitle": "0 (0 bps)",
          "conditionId": "0xd4e77ba6f29fc093509d24f508631abd445ecf506bbdc9c4c80e60256a318527",
          "tokenId": "12403602920039269077597917340921667997547115084613238528792639013246536343316",
          "price": 0.348,
          "active": true
        },
        {
          "question": "Will 1 Fed rate cut happen in 2026?",
          "groupItemTitle": "1 (25 bps)",
          "conditionId": "0x5e082f0b57f47a29044aa35b4c5658393122e659d5feae521c06b57cdd7f905c",
          "tokenId": "113379839734351069617987084078322474966003108854908079701423911002443710490196",
          "price": 0.19,
          "active": true
        },
        {
          "question": "Will 2 Fed rate cuts happen in 2026?",
          "groupItemTitle": "2 (50 bps)",
          "conditionId": "0xe0d9f508a249e0070db06eb7d1e1fb17eb23c963f6fb722c4c3f81e23240c1cd",
          "tokenId": "72535544017897924722695722172278828562733090748474862987195303914909938482758",
          "price": 0.165,
          "active": true
        }
      ]
    },
    {
      "id": "101936",
      "slug": "fed-rate-hike-in-2026",
      "title": "Fed rate hike in 2026?",
      "image": "https://polymarket-upload.s3.us-east-2.amazonaws.com/will-the-fed-raise-interest-rates-in-2025-PQTEYZMvmAGr.jpg",
      "active": true,
      "markets": [
        {
          "question": "Fed rate hike in 2026?",
          "groupItemTitle": "",
          "conditionId": "0x80b3af88cb991980e8da1ce86b9794a0957f96ec98c29319dd7ba65e9744d82b",
          "tokenId": "75028752776148090296091099469912621384650554615761384992997579209329182670110",
          "price": 0.33,
          "active": true
        }
      ]
    }
  ],
  "count": 2
}

​
Response Fields

FieldTypeDescription
querystringThe search query
eventsarrayMatching events
events[].idstringEvent ID
events[].slugstringURL slug
events[].titlestringEvent title
events[].imagestring|nullEvent image URL
events[].activebooleanWhether event is active
events[].marketsarrayAll sub-markets in this event
events[].markets[].questionstringFull market question
events[].markets[].groupItemTitlestringShort outcome label (e.g., “0 (0 bps)“)
events[].markets[].conditionIdstringCondition ID for CLOB queries
events[].markets[].tokenIdstring|nullYES token ID for price history via /v1/candles/{tokenId}
events[].markets[].pricenumber|nullCurrent YES price (0-1)
events[].markets[].activebooleanWhether market is active
countnumberNumber of events returned

​
SDK Usage

import { PolyNode } from 'polynode-sdk';

const pn = new PolyNode({ apiKey: 'pn_live_...' });

const results = await pn.searchEvents('Fed rate', { limit: 5 });

for (const event of results.events) {
  console.log(event.title, `(${event.markets.length} outcomes)`);
  for (const m of event.markets) {
    console.log(`  ${m.groupItemTitle || m.question}: ${m.price} — tokenId: ${m.tokenId}`);
  }
}

​
Notes

  • The tokenId is the YES token for each market. Use it with /v1/candles/{tokenId} to fetch OHLCV price history.
  • groupItemTitle is the short outcome label (e.g., “2 (50 bps)”, “June Meeting”). Empty string for single-outcome events.
  • Rate limited to 1 request per second per API key (shared with other enriched data endpoints).
  • Results are cached for 3 minutes.