{"uid":"cap_a12ZyDLZG_BxLXEf52kIU","slug":"creator-desk-marketplace-rank-api-1db17294","name":"Creator Desk Marketplace Rank API","description":"Machine-callable x402-paid utilities for autonomous agents.","url":"https://creator-desk-x402-isolated.onrender.com/v1/marketplace/rank?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"candidates":{"type":"array","items":{"type":"object","required":["id","task_fit","health","latency_ms","price_usd"],"properties":{"id":{"type":"string","maxLength":128,"minLength":1},"health":{"type":"number","maximum":1,"minimum":0},"network":{"type":"string","maxLength":128},"provider":{"type":"string","maxLength":256},"task_fit":{"type":"number","maximum":1,"minimum":0},"price_usd":{"type":"number","maximum":100000,"minimum":0},"latency_ms":{"type":"number","maximum":600000,"minimum":0}},"additionalProperties":false},"maxItems":50,"minItems":2}}},"responseSchema":{"type":"json","example":{"policy":["task_fit_desc","health_desc","latency_ms_asc","price_usd_asc","id_asc"],"ranking":[{"id":"agent-a","rank":1,"health":1,"network":"eip155:8453","task_fit":0.95,"price_usd":0.03,"latency_ms":180,"reason_codes":["BEST_TASK_FIT","FULL_HEALTH"]},{"id":"agent-b","rank":2,"health":1,"network":"eip155:8453","task_fit":0.9,"price_usd":0.01,"latency_ms":120,"reason_codes":["FULL_HEALTH","LOWEST_LATENCY","LOWEST_PRICE"]}],"version":"1.0.0","product_id":"creator_desk_machine_marketplace_rank","limitations":["Ranks only caller-supplied measurements. It does not independently verify identity, reputation, settlement history, availability, or delivery quality."]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_tSDpbdwzbIkDK8BmY9_cb","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Ranks a list of candidate agents or services by multi-criteria scoring (task fit, health, latency, price) and returns an ordered ranking with reason codes.","exampleAgentPrompt":"I have three candidate agents — agent-a with task_fit 0.95, health 1.0, latency 180ms and price $0.03; agent-b with task_fit 0.90, health 1.0, latency 120ms and price $0.01; agent-c with task_fit 0.75, health 0.8, latency 90ms and price $0.005 — can you rank them from best to worst for this job?","exampleUseCases":[{"title":"Selecting best agent for a workflow","prompt":"I have four candidate agents with these scores — alpha: task_fit 0.88, health 1.0, latency 200ms, price $0.02; beta: task_fit 0.92, health 0.9, latency 150ms, price $0.05; gamma: task_fit 0.70, health 1.0, latency 80ms, price $0.01; delta: task_fit 0.85, health 0.75, latency 300ms, price $0.005 — rank them so I know which one to route my next task to."},{"title":"Cost-performance tradeoff for budget pipeline","prompt":"Can you rank these two service providers for me? Provider-X has task_fit 0.80, health 0.95, latency 250ms, price $0.01, and Provider-Y has task_fit 0.85, health 1.0, latency 400ms, price $0.008 — I want to see which one scores better overall."},{"title":"Failover candidate prioritization","prompt":"I need to pick a fallback agent from this pool — node-1: task_fit 0.60, health 0.5, latency 100ms, price $0.02; node-2: task_fit 0.78, health 0.95, latency 220ms, price $0.03; node-3: task_fit 0.82, health 1.0, latency 310ms, price $0.04 — rank them so I route to the healthiest and most capable one first."}],"resultDescription":"Returns a ranked array of all submitted candidates in order from best to worst, each annotated with their rank position and human-readable reason codes (e.g. BEST_TASK_FIT, FULL_HEALTH, LOWEST_LATENCY, LOWEST_PRICE). Also includes the applied sorting policy, the product_id, version, and a limitations disclaimer noting that rankings are based solely on caller-supplied data.","failureModes":["Fewer than 2 candidates submitted — validation error","More than 50 candidates submitted — exceeds maxItems limit","Missing required fields (id, task_fit, health, latency_ms, price_usd) on any candidate — schema validation error","Values out of range (e.g. health > 1, negative latency) — rejected","Payment not provided or insufficient — 402 Payment Required","Service temporarily unavailable on Render free tier — 503 or cold-start timeout"],"whenToPreferThis":"Use this endpoint when you have a set of 2–50 pre-measured agent or service candidates and need a deterministic, multi-criteria ranking to decide which one to invoke next. It is ideal for agent orchestration layers, load balancers, or marketplace routers that already collect task_fit, health, latency, and price metrics and want a normalized priority order with reason codes — without building custom sorting logic.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T18:47:42.216Z","isFirstParty":false,"canonicalSlug":"creator-desk-marketplace-rank-api-1db17294"}