Supported Indices

This page is the canonical reference for all searchable indices available in embed's APIs. Each index represents a content type with its own set of filterable, sortable, and searchable fields.

When new indices are added, this page is updated first. Individual API reference pages link back here.


Index Summary

IndexDescriptionStatus
farcaster-itemsSocial posts from the Farcaster protocolLive
zora-coinsCreator coins from the Zora platformLive
polymarket-itemsPrediction market contracts from PolymarketLive
polymarket-walletsUser wallets and profiles from PolymarketLive
kalshi-itemsPrediction market contracts from trading Kalshi on Solana through DFlow contractsLive
kalshi-walletsUser wallets and profiles from trading tokenized Kalshi markets on Solana through DFlow contractsLive
token-itemsMulti-chain token data (Base, Ethereum, Solana) — price, volume, liquidity, holdersLive
ethereum-itemsItems/transactions on EthereumPlanned
ethereum-walletsWallet profiles on EthereumPlanned
base-itemsItems/transactions on BasePlanned
base-walletsWallet profiles on BasePlanned
solana-itemsItems/transactions on SolanaPlanned
solana-walletsWallet profiles on SolanaPlanned

Service Coverage by Index

Not all services are available for every index. This table shows what works today.

IndexSearchSemantic SearchFeaturesScoring ModelsRanking
farcaster-itemsYesYesAI Labels, Content Sims
polymarket-itemsYesYesAll (Social Affinity, Trader Affinity, Content Sims, AI Labels)polymarket-rerank-v1Session-Based, Online Learning
polymarket-walletsYesYes— (user index for forUser)
zora-coinsYesYesAI Labels
kalshi-itemsYesNoAI Labels
kalshi-walletsYesNo— (not yet supported as user index)
token-itemsYesNo

Key:

  • Searchfilter_and_sort, boost, frequent_values all work
  • Semantic Search — requires text embeddings; not yet indexed for Kalshi and token-items
  • Features — ML enrichment via /features/v1; wallet indices are used as user profiles via forUser, not as item indices
  • Scoring Models — trained reranking models; currently only Polymarket has one
  • Ranking — the /ranking/feed endpoint works with any items regardless of index; this column indicates whether trained ranking models exist for personalization

Farcaster Items (farcaster-items)

Social posts from the Farcaster protocol.

Filterable Fields

FieldFilter TypesDescription
text, text_enrichedmatch, term, termsPost text content
score_popular, score_trendingnumericPopularity and trending scores
score_like, score_comment, score_share, score_reactionnumericEngagement scores
num_like, num_comment, num_sharenumericEngagement counts
num_follower, num_followingnumericAuthor follower/following counts
score_spam, score_not_ok, user_score_spamnumericQuality/spam scores
langterm, termsLanguage code
publication_typeterm, termsContent type (text, image, video, etc.)
appterm, termsSource application
channelsterm, termsFarcaster channels
miniapp_categoriesterm, termsMini app categories
user_id, user_nameterm, termsAuthor identifiers
item_creation_timestampdatePost creation time
locationgeoGeographic location
ai_labels_high, ai_labels_med, ai_labels_lowterm, termsAI-classified topic/sentiment/moderation labels at different confidence levels
coin_labelsterm, termsCoin-related labels
embed_itemsis_null, not_nullEmbedded media items

Sortable Fields

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)

Prediction market contracts from Polymarket.

Filterable Fields

FieldFilter TypesDescription
active, archived, closed, approved, featured, funded, restricted, neg_risk, newterm, termsMarket status flags
best_ask, last_trade_price, spreadnumericPricing metrics
liquidity, liquidity_numnumericMarket liquidity
volume, volume_24hr, volume_1wk, volume_1mo, volume_1yr, volume_numnumericTrading volume
one_hour_price_change, one_day_price_change, one_week_price_change, one_month_price_changenumericPrice change percentages
question, descriptionmatch, term, termsMarket question and description text
sports_market_typeterm, termsSports market category
item_id, market_maker_addressterm, termsMarket identifiers
created_at, updated_at, end_date, start_date, game_start_timedateTimestamps

Sortable Fields

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)

User wallets and profiles from Polymarket.

Filterable Fields

FieldFilter TypesDescription
user_id, name, pseudonymterm, termsUser identifiers
ai_labels2, tags2term, termsAI labels and tags
volume, pnl, events_per_daynumericTrading metrics
updated_atdateLast update time
name, pseudonym, pfp, primary_labels, secondary_labels, primary_similar_wallets, secondary_similar_wallets, text_vectoris_null, not_nullNull checks for profile fields

Sortable Fields

Numeric: volume, pnl, events_per_day

Date: updated_at


Zora Coins (zora-coins)

Creator coins from the Zora platform.

Filterable Fields

FieldFilter TypesDescription
zora_symbol, domainterm, termsCoin metadata
zora_price_in_usdc, zora_market_cap, zora_market_cap_delta_24hnumericPricing
zora_total_supply, zora_unique_holdersnumericSupply and holders
zora_total_volume, zora_volume_24h, num_buy, num_sellnumericTrading volume
num_follower, num_following, score_popular, score_trendingnumericSocial engagement
score_spam, score_not_oknumericQuality scores
zora_created_at, zora_updated_atdateTimestamps
zora_creator_farcaster_id, zora_addressterm, termsCreator identifiers
zora_description, text_enriched, text_fullmatch, term, termsText content
zora_media_content_typeterm, termsMedia type
user_name, user_idterm, termsUser identifiers
ai_labels_high, ai_labels_med, ai_labels_lowterm, termsAI labels

Sortable Fields

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-items)

Prediction market contracts from trading Kalshi on Solana through DFlow contracts.

Filterable Fields

FieldFilter TypesDescription
active, closedterm, termsMarket status (boolean)
statusterm, termsMarket status string (active, finalized, etc.)
item_id, ticker, event_idterm, termsMarket identifiers
question, descriptionmatch, term, termsMarket question and description text
series_categoryterm, termsCategory (e.g. Sports, Science and Technology)
tags, series_tagsterm, termsMarket tags (string arrays)
ai_labels_low, ai_labels_med, ai_labels_highterm, termsAI-classified labels at three confidence levels
volumenumericTrading volume in cents
start_date, end_date, created_at, updated_atdateTimestamps

Sortable Fields

Numeric: volume

Date: created_at, updated_at, start_date, end_date

Additional Fields (available in _source, not filterable)

FieldTypeDescription
image_urlstringMarket image from Kalshi
market_urlstringDirect link to market on kalshi.com

Note: AI labels (ai_labels_low, ai_labels_med, ai_labels_high) are populated on finalized markets. Active markets may have null AI labels until they are processed.

Limitations: Semantic search (/search/semantic) is not yet available for kalshi-items — text embeddings have not been indexed. Use filter_and_sort or boost instead.


Kalshi Wallets (kalshi-wallets)

User wallets and profiles from trading tokenized Kalshi markets on Solana through DFlow contracts.

Filterable Fields

FieldFilter TypesDescription
user_idterm, termsWallet/user identifier
protocolterm, termsAlways kalshi
pnlnumericProfit and loss
volume_quotenumericTotal quote volume (in cents)
volume_outcomenumericTotal outcome volume
markets_tradednumericNumber of markets traded
events_per_daynumericAverage events per day
primary_tags, primary_labels, secondary_labelsterm, termsUser preference tags and labels
ai_labelsterm, termsAI-classified labels
tag_01tag_10term, termsIndividual top tags (for group_boost personalization)
label_01label_10term, termsIndividual top labels (for group_boost personalization)
last_trade_time, updated_atdateTimestamps

Sortable Fields

Numeric: pnl, volume_quote, volume_outcome, markets_traded, events_per_day

Date: last_trade_time, updated_at

Feature Support: AI Labels are available for Kalshi items. Social Affinity, Trader Affinity, and Content Similarity features are in progress. The Features API (/features/v1) does not yet support kalshi-wallets as a user index — use group_boost on kalshi-wallets fields for search-level personalization instead.


Token Items (token-items)

Multi-chain token data covering Base, Ethereum, and Solana. Contains price, volume, liquidity, and holder data for 76,000+ tokens.

ChainToken Count
Solana~60,000
Base~10,000
Ethereum~6,000

Filterable Fields

FieldFilter TypesDescription
chainmatchBlockchain: base, ethereum, or solana
token_addressterm, termsOn-chain contract address
symbol, namematchToken ticker and name (use match, not term)
decimalsnumericToken decimal places
price_usdnumericCurrent price in USD
total_liquidity_usdnumericTotal liquidity (USD). May be null for low-activity tokens.
volume_usd_24h, volume_usd_1d, volume_usd_1hnumericTrading volume over different windows
holders_countnumericNumber of token holders
price_diff_pct_1d, price_diff_pct_1hnumericPrice change percentage (1 day, 1 hour)

Sortable Fields

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

Additional Fields (available in _source)

FieldTypeDescription
image_urlstringToken image URL (may be null)
last_updatedstringLast data refresh timestamp

Filter Notes

  • Use match (not term) for chain, symbol, and name — these are analyzed text fields
  • Use term for token_address — exact match on the contract address
  • total_liquidity_usd, volume_usd_* fields may be null for low-activity tokens — use not_null filter to exclude them

Example: Top Base tokens by holders

{
  "index": "token-items",
  "size": 20,
  "sort_by": { "field": "holders_count", "order": "desc" },
  "include": [
    { "filter": "match", "field": "chain", "value": ["base"] },
    { "filter": "numeric", "field": "holders_count", "operator": ">=", "value": 100 }
  ]
}

Example: Tokens with significant price movement

{
  "index": "token-items",
  "size": 20,
  "sort_by": { "field": "price_diff_pct_1d", "order": "desc" },
  "include": [
    { "filter": "numeric", "field": "holders_count", "operator": ">=", "value": 50 },
    { "filter": "numeric", "field": "price_usd", "operator": ">=", "value": 0.0001 }
  ]
}

Limitations: Semantic search (/search/semantic) is not yet available for token-items. Use filter_and_sort with match filters on name or symbol instead.


Upcoming Indices

The following indices are planned and will follow the same {chain}-items / {chain}-wallets pattern:

IndexDescription
ethereum-items / ethereum-walletsEthereum transactions and wallet profiles
base-items / base-walletsBase L2 transactions and wallet profiles
solana-items / solana-walletsSolana transactions and wallet profiles

Field definitions for these indices will be published here as they become available.