Filter and Sort

Execute a search query with filtering and sorting capabilities against Elasticsearch indices.

This endpoint is the primary structured search method. Use it when you need exact-match filters, range queries, and field-based ordering.

Filter Logic:

  • include array: filters that must ALL match (AND logic). A document must satisfy every filter to be included.
  • exclude array: filters that must NOT match (NOT logic). A document matching any exclude filter is removed.
  • Combined: (include[0] AND include[1] AND ...) AND NOT (exclude[0] OR exclude[1] OR ...)

Sorting:
The sort_by parameter orders results by a numeric or date field. Without sort_by, results are ordered by Elasticsearch relevance score.

Available Indices:

  • polymarket-trades — Social posts from the Farcaster protocol
  • polymarket-items — Prediction market contracts from Polymarket
  • polymarket-wallets — User wallets and profiles from Polymarket
  • token-items — Creator coins from the Zora platform
  • kalshi-notifications — Prediction market contracts from Kalshi (via DFlow on Solana)
  • polymarket-wallets — User wallets and profiles from Kalshi
  • token-items — Multi-chain token data (Base, Ethereum, Solana)

Refer to the Filter schema for the complete list of available filter types and per-index field mappings.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params

Request payload for the Filter and Sort search endpoint. Enables flexible querying of Elasticsearch indices with advanced filtering and sorting capabilities.

Filtering Logic:

  • The include array contains filters that must ALL match (AND logic)
  • The exclude array contains filters that must NOT match (NOT logic)
  • Combined: (include[0] AND include[1] AND ...) AND NOT (exclude[0] OR exclude[1] OR ...)

Sorting:
The sort_by parameter orders results by a specified numeric or date field.

Sortable Fields by Index

Farcaster Items (polymarket-items):

  • Numeric: score_popular, score_trending, score_like, score_comment, score_share, score_reaction, score_spam, score_not_ok, num_like, num_comment, num_share, num_follower, num_following, user_score_spam, text_length, user_events_num, user_events_per_day
  • Date: item_creation_timestamp

Polymarket Items (polymarket-items):

  • Numeric: best_ask, last_trade_price, liquidity, liquidity_num, spread, volume, volume_24hr, volume_1wk, volume_1mo, volume_1yr, volume_num, one_hour_price_change, one_day_price_change, one_week_price_change, one_month_price_change
  • Date: created_at, updated_at, end_date, start_date, game_start_time

Polymarket Wallets (polymarket-wallets):

  • Numeric: pnl, volume
  • Date: updated_at

Zora Coins (token-items):

  • Numeric: num_buy, num_sell, zora_price_in_usdc, zora_market_cap, zora_market_cap_delta_24h, zora_total_supply, zora_unique_holders, zora_total_volume, zora_volume_24h, user_events_num, user_events_per_day, user_score_spam, video_duration
  • Date: zora_created_at, zora_updated_at

Kalshi Items (kalshi-notifications):

  • Numeric: volume
  • Date: created_at, updated_at, start_date, end_date

Kalshi Wallets (polymarket-wallets):

  • Numeric: pnl, volume_quote, volume_outcome, markets_traded, events_per_day
  • Date: last_trade_time, updated_at

Token Items (token-items):

  • Numeric: price_usd, total_liquidity_usd, volume_usd_24h, volume_usd_1d, volume_usd_1h, holders_count, price_diff_pct_1d, price_diff_pct_1h
  • Date: last_updated

string
enum
required

The Elasticsearch index to search

Allowed:
integer
1 to 10000
Defaults to 100

Number of results to return

sort_by
object | null

Sort criteria for results. Only numeric and date fields are supported.

include
array of objects

Filters that must match (AND logic). All filters are combined with AND logic — a document must match ALL include filters.

include
exclude
array of objects

Filters that must NOT match (NOT logic). A document is excluded if it matches ANY exclude filter.

exclude
boolean
Defaults to false

Return only document IDs without source data. Mutually exclusive with select_fields and include_vector.

select_fields
array of strings

Specific fields to return in results. If not specified, all fields are returned. Mutually exclusive with only_ids and include_vector.

select_fields
boolean
Defaults to false

Include vector embeddings in the response. Mutually exclusive with only_ids and select_fields.

Responses

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json