# JarvisClaw Rerank API

> JarvisClaw Rerank API is a paid API for AI agents from uat.jarvisclaw.ai, paid per call via x402, $0.045/call, status unknown (last checked 2026-09-13).

Reranks a list of documents by relevance to a query using AI models, with pay-per-call billing via x402 settled in USDC

## Facts

- Endpoint: POST https://uat.jarvisclaw.ai/v1/rerank
- Price: $0.045/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/jarvisclaw-rerank-api-e745362f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Dh07g-aBOlKFc1f-3B3S1

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability jarvisclaw-rerank-api-e745362f -d '<json body>'
```

Example prompt: Rerank these 10 retrieved passages by how relevant they are to the question 'What are the side effects of ibuprofen?' — use the cohere-rerank-v3 model and return the top 5 most relevant ones.

## When to prefer this

Choose this endpoint when you need to improve the precision of retrieved documents in a RAG or semantic search pipeline by reranking candidate passages against a query. It is especially useful as a second-stage retrieval step after a fast but lower-precision vector search. Prefer it when you want pay-per-call pricing settled in USDC on Base or Solana via x402 protocol without API key subscriptions. Best suited for agents that need programmatic, on-demand reranking without long-term commitments.

## Known failure modes

- Missing required 'query' or 'documents' field returns a 400 validation error
- Invalid or unsupported model name returns an error or fallback model
- Empty documents array returns an empty result or error
- Payment failure via x402 (insufficient USDC balance) results in a 402 Payment Required response
- Very large document arrays may exceed token limits and return a context-length error
- UAT environment may have instability or rate limits not present in production

## How this service works

AI API Gateway with smart routing, pay per call via x402. OpenAI-compatible. Settled in USDC on Base & Solana.

## Output

Returns the input documents reordered by relevance score relative to the query, typically including each document's new rank position and a relevance/confidence score indicating how well it matches the query.

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/jarvisclaw-rerank-api-e745362f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from uat.jarvisclaw.ai](https://www.zero.xyz/host/uat.jarvisclaw.ai/llms.txt)