# Tool Scout – OpenSea Registry Search by Real Usage

> Tool Scout – OpenSea Registry Search by Real Usage is a paid API for AI agents from www.amnt.io, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-13).

Searches OpenSea's tool registry for matching tools and ranks results by actual paying callers and paid calls, filtering out dead or bulk-published listings.

## Facts

- Endpoint: POST https://www.amnt.io/api/agent/amnt/tool-scout
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tool-scout-opensea-registry-search-by-real-usage-030de548
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_swJqaa1OgRsHzMNzZnSkT

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 tool-scout-opensea-registry-search-by-real-usage-030de548 -d '<json body>'
```

Example prompt: Search the OpenSea tool registry for tools that can check whether an ERC-20 token is a honeypot — only show me ones that have real paying users, up to 10 results, and keep the price under $0.05.

## When to prefer this

Use this endpoint when an agent needs to discover functional tools on OpenSea's registry for a specific subtask and wants to avoid dead or untested listings. It is the right choice when you need trust signals (unique buyers, paid call counts) rather than raw name-matching. Prefer it over manual registry browsing or generic search when you want results ranked by real-world adoption and need price filtering to stay within budget constraints.

## Known failure modes

- No tools match the task description — 'found' returns 0 and 'note' explains why
- All matches filtered out by provenOnly or maxPriceUsd — rejected equals scanned
- Task string too long (over 200 chars) — validation error
- limit out of range (must be 1–25) — schema validation error
- Registry temporarily unavailable — upstream error response
- Ambiguous task description returns low-relevance matches

## Output

Returns a ranked list of matching tools from OpenSea's registry, each with name, toolId, endpoint URL, price in USD, unique buyer count, total paid call count, trust score, and any flags (e.g. never-used, bulk-published). Also includes a summary of how many tools were scanned, found, and rejected, plus the top match's name and a plain-language note explaining filter outcomes.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "type": "object",
     "required": [
      "task"
     ],
     "properties": {
      "task": {
       "type": "string",
       "examples": [
        "check whether an ERC-20 token is a honeypot"
       ],
       "maxLength": 200,
       "description": "Plain words. Searched against every registered tool's name, tags and description."
      },
      "limit": {
       "type": "integer",
       "default": 8,
       "maximum": 25,
       "minimum": 1,
       "description": "How many to return"
      },
      "provenOnly": {
       "type": "boolean",
       "default": true,
       "description": "Keep only tools somebody has actually paid to call. On by default — most of the registry has never been used."
      },
      "maxPriceUsd": {
       "type": "string",
       "examples": [
        "0.05"
       ],
       "maxLength": 12,
       "description": "Drops anything dearer. Leave empty for no limit."
      }
     }
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "best": {
       "type": "string",
       "description": "The single highest-trust match's name, or empty when nothing qualified."
      },
      "note": {
       "type": "string",
       "description": "One plain sentence on what the filters did — read this when `found` is 0."
      },
      "found": {
       "type": "integer",
       "description": "How many tools survived the filters and were returned."
      },
      "tools": {
       "type": "array",
       "description": "Matching tools, best first. Each carries name, toolId, url, endpoint, priceUsd, uniqueBuyers, totalCalls, trust and flags."
      },
      "scanned": {
       "type": "integer",
       "description": "How many registry matches were examined before filtering."
      },
      "rejected": {
       "type": "in
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tool-scout-opensea-registry-search-by-real-usage-030de548/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from www.amnt.io](https://www.zero.xyz/host/www.amnt.io/llms.txt)