> ## Documentation Index
> Fetch the complete documentation index at: https://docs.polynode.dev/llms.txt
> Use this file to discover all available pages before exploring further.
# Event Search
> Search Polymarket events by text query. Returns events with all sub-markets, token IDs, and current prices.
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.
Search query (e.g., `recession`, `Fed rate`, `Trump tariff`).
Maximum number of events to return. Max 20.
```json theme={null}
{
"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
| Field | Type | Description |
| ----------------------------------- | ------------ | ---------------------------------------------------------- |
| `query` | string | The search query |
| `events` | array | Matching events |
| `events[].id` | string | Event ID |
| `events[].slug` | string | URL slug |
| `events[].title` | string | Event title |
| `events[].image` | string\|null | Event image URL |
| `events[].active` | boolean | Whether event is active |
| `events[].markets` | array | All sub-markets in this event |
| `events[].markets[].question` | string | Full market question |
| `events[].markets[].groupItemTitle` | string | Short outcome label (e.g., "0 (0 bps)") |
| `events[].markets[].conditionId` | string | Condition ID for CLOB queries |
| `events[].markets[].tokenId` | string\|null | YES token ID for price history via `/v1/candles/{tokenId}` |
| `events[].markets[].price` | number\|null | Current YES price (0-1) |
| `events[].markets[].active` | boolean | Whether market is active |
| `count` | number | Number of events returned |
### SDK Usage
```typescript theme={null}
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.
## OpenAPI
````yaml GET /v1/events/search
openapi: 3.1.0
info:
title: PolyNode API
description: >-
Real-time Polymarket data API with decoded mempool settlements, OHLCV
candles, and full Polygon JSON-RPC proxy.
contact:
name: PolyNode
url: https://polynode.dev
license:
name: ''
version: 2.0.0
servers:
- url: https://api.polynode.dev
description: Production
security:
- api_key: []
paths:
/v1/events/search:
get:
tags:
- Enriched Data
summary: Event search
description: >-
Search Polymarket events by text query. Returns events with all
sub-markets, token IDs, and current prices.
operationId: event_search
parameters:
- name: q
in: query
description: Search query (e.g. recession, Fed rate, Trump tariff)
required: true
schema:
type: string
- name: limit
in: query
description: Maximum events to return (default 10, max 20)
schema:
type: integer
default: 10
maximum: 20
responses:
'200':
description: Search results
content:
application/json:
schema:
type: object
example:
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.3985
active: true
count: 1
'400':
description: Missing query parameter
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'401':
description: Missing API key
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
security:
- api_key: []
components:
schemas:
ErrorResponse:
type: object
required:
- error
properties:
error:
type: string
securitySchemes:
api_key:
type: apiKey
in: header
name: x-api-key
````