Features V1

Enrich items with ML-computed features based on user profile and preferences.

This endpoint computes personalized features for a list of items by comparing them against a user's profile. The computed features are designed to be used as inputs to the Ranking pipeline.

Semantic Features:

  • Dense vector similarity between user and item embeddings (cosine similarity)
  • Multiple embedding comparisons: sem_sim_1 through sem_sim_5 for primary through fifth user embeddings
  • sem_sim_fuzzy: Loose matching across all embeddings
  • sem_sim_closest: Maximum similarity across all user embeddings
  • Cluster indicators (sem_sim_cluster1–sem_sim_cluster5): Binary flags indicating which user embedding is the closest match

Topic Features:

  • usr_primary_labels / usr_primary_tags: Count of matching labels/tags against user's primary preferences
  • usr_secondary_labels / usr_secondary_tags: Count against secondary preferences
  • usr_mixed_labels / usr_mixed_tags: Weighted blend (75% primary + 25% secondary)
  • AI:* / TAG:*: One-hot encoded features for individual labels and tags

Composite Features:

  • topic_similarity: Combined score aggregating semantic and topic signals
  • original_rank: Normalized position from request order (0–1, higher = earlier)

Index-Specific Features (Polymarket):

  • num_bets: Number of bets on the market
  • num_price_changes: Number of price change events

All numerical features are normalized to [0, 1] range for consistent scaling.

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

Request payload for the Features V1 endpoint. Specifies a user profile and a list of items to enrich with ML-computed features.

User Specification:

  • Provide a user profile using user.index (DynamoDB table/index) and user.id (user identifier)
  • The service retrieves user data including preferences, embeddings, and profile information

Item Enrichment:

  • Provide a list of items with items[].index and items[].id
  • Original rank is preserved based on position in the request list
  • Items are retrieved from DynamoDB for their content and metadata

Supported User Indices: polymarket-wallets
Supported Item Indices: polymarket-items

user
object
required

User profile specification for feature computation

items
array of objects
required
length ≥ 1

List of items to enrich with features. Order matters — original_rank is calculated from position in this list.

items*
Responses

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