---
name: api.robotsshop.io
description: api.robotsshop.io provides a ranked directory of x402-gated API endpoints, returning quality scores, latency metrics, spam flags, and wallet risk signals for each listing. It serves as a discovery layer for agents that need to identify and evaluate paid x402 APIs before calling them.
host: api.robotsshop.io
---

# api.robotsshop.io

RobotsShop is a curated index of x402-gated API resources. It serves agents and developers who need to programmatically discover which x402 endpoints are active, high-quality, and safe to pay, rather than maintaining their own registry. Its distinguishing feature is the scoring and spam-filtering layer applied to listed endpoints, which surfaces trustworthy resources and suppresses low-quality or risky ones.

## When to use this host

Use this host when an agent needs to discover which x402-gated APIs exist, compare them by quality score, or screen out spam and high-risk wallet addresses before committing to a paid call. Do not use it for real-time financial data such as token prices, swap quotes, or OHLCV candles — those require a dedicated market-data or DEX host. This host has no execution capability; it only returns directory metadata, so a separate step is always required to actually call the selected x402 endpoint.

## Capabilities

### x402 Endpoint Discovery

Retrieves a ranked list of x402-gated API endpoints filtered by quality score and spam status, providing the metadata needed to select a paid API before invoking it.

- **`fetch-top-x402-listings`** — Returns a ranked list of top x402-gated API resources with quality scores, latency, spam flags, and wallet risk signals, filtered by minimum score threshold.

## Skill reference

### `fetch-top-x402-listings`

**RobotsShop Top x402 Listings** — Returns a ranked list of top x402-gated API resources with quality scores, latency, spam flags, and wallet risk signals, filtered by minimum score threshold.

*Use when:* Use when an agent needs to discover high-quality, actively gated x402 endpoints ranked by score, optionally filtering out spam domains and setting a minimum quality threshold before selecting a paid API to call.

*Not for:* Do not use for real-time price feeds or token swap quotes; this returns a directory of x402-gated endpoints, not financial market data.

**Inputs:**

- `n` (integer) — Number of top listings to return. Must be between 1 and 100 inclusive. Defaults to 25.
- `min_score` (integer) — Minimum quality score (0–100) a listing must have to be included. Defaults to 85.
- `exclude_spam` (boolean) — When true, listings flagged as spam domains are excluded from results. Defaults to true.

**Returns:** Returns count=25 and a results array of x402-gated endpoints each with resource URL, domain, payto address, score, grade, latency_ms, spam_domain flag, wallet_auth, wallet_risk, and last_probed date.

**Example:** `GET https://api.robotsshop.io/v0/top?n=25&min_score=85&exclude_spam=true`

---