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:

  • farcaster-items — Social posts from the Farcaster protocol
  • polymarket-items — Prediction market contracts from Polymarket
  • polymarket-wallets — User wallets and profiles from Polymarket
  • zora-coins — Creator coins from the Zora platform
  • kalshi-items — Prediction market contracts from Kalshi (via DFlow on Solana)
  • kalshi-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
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
Bearer
API Key
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json