Rerank

Rerank a list of item IDs for a given user using a trained ML model.

This endpoint sends the user and items to a trained ranking model, which returns the same items in a personalized order based on predicted relevance.

Flow:

  1. Provide user_id and item_ids in the request body
  2. The service reranks items using the trained model for the given model_name
  3. Response returns the same item IDs in a new order (personalized ranking)

Available Models:

  • polymarket-rerank-v1 — Polymarket reranking model trained on trading activity data

Error Handling: Errors are returned with HTTP 200 and an error field in the response body (rather than HTTP error codes). This includes:

  • Missing user_id or item_ids
  • Unknown model_name
  • Service errors (model not found, invalid input, network issues)
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
enum
required

Name of the ranking model (campaign) to use

Allowed:
Body Params
string
required

Unique identifier of the user (e.g., wallet address for Polymarket)

item_ids
array of strings
required
length ≥ 1

Ordered list of item IDs to rerank. Personalize returns a new order based on predicted relevance.

item_ids*
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