Rankings
POST /v1/rankings/saved
Save a custom Builder ranking. Set is_public to publish it at a shareable public slug.
Save a custom Builder ranking. Set is_public to publish it at a shareable public slug.
AuthorizationBearer <token>
API key: Authorization: Bearer pk_live_… (mint at polyrank.app/api-keys)
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
curl -X POST "https://example.com/v1/rankings/saved" \ -H "Content-Type: application/json" \ -d '{ "weights": { "property1": { "weight": 0 }, "property2": { "weight": 0 } }, "name": "string" }'{ "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "name": "string", "is_public": true, "public_slug": "string", "config": { "version": 1, "weights": { "property1": { "weight": 0, "window": "lifetime" }, "property2": { "weight": 0, "window": "lifetime" } }, "filters": {}, "na_policy": "exclude", "preset_id": null, "created_via_preset_id": null }, "created_at": "string", "updated_at": "string"}POST /v1/rankings/custom POST
Compute a composite ranking over the wallet cohort with user-supplied weights and filters. The composite score is a weighted sum of percentile ranks across the chosen metrics; weights are auto-normalized. Paid feature (Builder).
GET /v1/search GET
Universal resolver: address / condition_id / token_id / username / market text → ranked results.