Explorer
Syncing—

Keyword RerankingService

reranking

Orders documents by keyword overlap with a query, with a penalty for long documents (a lightweight BM25-style score; not a trained model). POST JSON {"query": "cat", "documents": ["a cat sat", "dogs bark"]} to /v1/reranking (up to 100 documents); the response is a JSON object with ranking (index, score, preview for every document, highest score first) and scoring. Identical input gives identical output on every supplier.

Active Suppliers
2
of 2 ever configured
Service Info
Service ID
reranking
Compute Units / Relay
100,000
Owner
pokt10…87pn
Active Applications
2
Relay Mining EMA
1 relays
Service Metadata Cardsource: on-chain metadata (LCD)
{10 items
"schema":"pocket-service-card/v1"
"description":"Orders documents by keyword overlap with a query, with a penalty for long documents (a lightweight BM25-style score; not a trained model). POST JSON {"query": "..."
"rpc_types":[1 item
0:{4 items
"type":"REST"
"intent":"expected"
"backend_hint":"reranking HTTP server on :8080; POST /v1/reranking, GET /v1/health + /v1/version."
"notes":"Every response is a JSON object; errors are JSON 4xx with an error field."
}
]
"apis":[1 item
0:"rerank-api"
]
"specs":[1 item
0:{4 items
"kind":"openapi"
"api":"rerank-api"
"url":"https://services.supnodes.com/specs/reranking/openapi.json"
"notes":"Machine-readable OpenAPI 3.0.3 contract for this service."
}
]
"access":"public"
"results":"deterministic"
"serving":{7 items
"backend":"Single-process Python 3 HTTP server, standard library only, behind a RelayMiner (rest backend). No auth toward the backend; callers cannot send headers. No upst..."
"implementations":[1 item
0:"reranking >= 1.0"
]
"docs":"https://services.supnodes.com/specs/reranking/README.md"
"min_disk_gb":1
"min_ram_gb":1
"healthcheck":[3 items
0:{4 items
"rpc_type":"REST"
"request":{2 items
"path":"/v1/version"
"method":"GET"
}
"expect":{2 items
"json_path":"$.service"
"matches":"^reranking$"
}
"notes":"Identity probe: pins the backend to this service so a wrong backend cannot be staked under this id."
}
1:{4 items
"rpc_type":"REST"
"request":{2 items
"path":"/v1/health"
"method":"GET"
}
"expect":{2 items
"json_path":"$.status"
"matches":"^ok$"
}
"notes":"Readiness probe."
}
2:{4 items
"rpc_type":"REST"
"request":{3 items
"path":"/v1/reranking"
"method":"POST"
"body":{2 items
"query":"cat"
"documents":[2 items
0:"a cat sat"
1:"dogs bark"
]
}
}
"expect":{2 items
"json_path":"$.ranking[0].index"
"matches":"^0$"
}
"notes":"Functional probe: the document containing the query word ranks first. No upstream calls."
}
]
"notes":"Upstream: none. Gateway operators: configure as type passthrough with rpc_types ["rest"]."
}
"docs":"https://services.supnodes.com/specs/reranking/README.md"
"updated":"2026-09-30"
}