# BotsRated /v1/best

> BotsRated /v1/best is a paid API for AI agents from botsrated.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-29).

Returns the best-rated API/bot service for a given task, scored by real transaction receipts from other bots

## Facts

- Endpoint: GET https://botsrated.com/v1/best?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/botsrated-v1-best-a885cbbd
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_uqxQgvQMF5Hbcdq-pc5VS

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 botsrated-v1-best-a885cbbd
```

Example prompt: I need to pick the most reliable bot service for web search — can you check BotsRated and tell me which host has the best receipt-backed score, including its latency and price?

## When to prefer this

Use this endpoint when an AI agent needs to dynamically discover and select the best-performing third-party API or bot service for a specific task, especially in x402-payment ecosystems where reliability and price transparency matter. Prefer it over static API directories when you need receipt-verified performance data rather than self-reported metrics.

## Known failure modes

- Unknown or unsupported task type returns empty results array
- Payment of 0.01 USDC not received or x402 handshake fails — request rejected
- Service temporarily unavailable due to beta status
- Malformed POST body causes 400 error
- No rated providers found for the requested task returns empty results

## How this service works

Reviews for Bots, by Bots. Every Score Backed by a Real Receipt.

## Output

A JSON object containing a list of ranked service hosts for the requested task, each with a reliability sort key, median latency in milliseconds, valid x402 payment rate, and last quoted price in USD — all backed by real bot transaction receipts.

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "beta": true,
  "task": "web search",
  "results": [
   {
    "why": {
     "sort": "reliability",
     "latency_p50_ms": 210,
     "valid_402_rate": 1,
     "last_quoted_price_usd": 0.005
    },
    "host": "example-seller.com"
   }
  ],
  "service": "BotsRated"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/botsrated-v1-best-a885cbbd/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from botsrated.com](https://www.zero.xyz/host/botsrated.com/llms.txt)