# Stormap API Finder

> Stormap API Finder is a paid API for AI agents from stormap.ai, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-30).

Finds and ranks the best paid x402 API endpoints for a given task description, ordered by repeat paid usage, recency, and price, with live-checked results

## Facts

- Endpoint: GET https://stormap.ai/x402/v1/find_best_api?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-30
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/stormap-api-finder-8de94234
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Sso2ypsXtZ3wBSQ8-yBqZ

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 stormap-api-finder-8de94234
```

Example prompt: I need to send an email verification — can you find me the best paid API for that task, ranked by how often real agents actually pay to use it?

## When to prefer this

Use this endpoint when an AI agent needs to autonomously select the best paid API for a given capability rather than hardcoding a specific provider. It is especially valuable when you want social proof via repeat-payment signals (calls per wallet) rather than just catalog listings, and when you need live-verified endpoints priced in USDC via x402. Prefer this over static API directories when you want real usage data and current pricing.

## Known failure modes

- Vague task description returns poor or irrelevant matches
- No matching APIs found for a niche capability
- Live-check of an endpoint may time out, marking it as unavailable
- Task description is too broad and returns unrelated categories
- Rate limiting or payment failure if wallet has insufficient funds

## How this service works

Use when a task needs a paid API and the right x402 endpoint is unknown. Takes the task in a few words (web search, weather forecast, verify an email) and returns the top 1-5 Coinbase Bazaar endpoints ranked by repeat paid use (calls per wallet over 30 days), recency, relevance and price, each checked live, with URL, method, price, network, reasons and risk flags. Optional max_price_usd and limit. Read-only. Errors: 400 bad_input. Failed calls are not charged.

## Output

Returns a ranked list of x402 API endpoints matching the requested task, each with: endpoint URL, price in USDC, ranking rationale (calls per wallet, recency, price), and live-verified availability. Results are sorted by repeat paid usage so the most trusted, real-world-proven options surface first.

## 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"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "task"
     ],
     "properties": {
      "task": {
       "type": "string",
       "description": "What you need the API for, in a few words, e.g. \"web search\", \"transcribe audio\", \"company enrichment\"."
      },
      "limit": {
       "type": "string",
       "description": "How many APIs to return (default 3). (integer) Range 1-5."
      },
      "check_live": {
       "type": "string",
       "description": "Check the top candidates live (default true). False is faster. (boolean)"
      },
      "max_price_usd": {
       "type": "string",
       "description": "Optional price cap per call in USD, e.g. 0.05. (number)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "task": {
       "type": "string"
      },
      "as_of": {
       "type": "string"
      },
      "results": {
       "type": "array"
      },
      "summary": {
       "type": "string"
      },
      "matched_category": {
       "type": "string"
      },
      "typical_price_usd": {
       "type": "number"
      },
      "considered_listings": {
       "type": [
        "integer",
        "number"
       ]
      }
     }
    }
   }
  }
 }
}
```

## More

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