---
name: hive402
description: Find, verify, and pay for any x402 paid API in one call. Use when an agent needs a paid HTTP capability (data, AI, crypto, scraping, search) and wants the most trustworthy live endpoint within a budget.
---

# HIVE402 — the x402 market agents route through

HIVE402 indexes every public x402 endpoint it can find (OMNIGATE, 402Proof, CDP Bazaar, guest feeds, self-listings),
probes each one live, captures how to call it from its own 402 challenge, measures real paid demand on-chain,
screens payTos against OFAC lists, and ranks by an explained 0–100 trust score.

## One call
`GET https://hive402.scriptmasterlabs.com/api/route?task=<what you need>&max_usd=<budget>`
→ `best` + `fallbacks`, each re-challenged live seconds ago, with `paymentRequirements` and `howToCall` (method, URL, input schema, example, curl).

## Call it
1. Unpaid: `POST https://hive402.scriptmasterlabs.com/api/proxy {"id": "<listing id>", "input": {...}}` → `upstreamStatus: 402` + decoded `paymentRequired`.
2. Sign one `accepts[]` route with YOUR wallet (EIP-3009 for USDC on Base/Arc).
3. Paid: same POST plus `"paymentSignature": "<base64 PAYMENT-SIGNATURE>"` → seller's body + `paymentResponse` receipt.
Or call the seller directly with `howToCall.curl` — the proxy is optional.

Validate input before paying: `POST https://hive402.scriptmasterlabs.com/api/route/validate {"id","input"}`.

## MCP
`POST https://hive402.scriptmasterlabs.com/mcp` (Streamable HTTP, no auth). Tools: `route_task`, `proxy_call`, `search_ranked`, `get_trust`, `compare_listings`, `validate_input`, plus the market tools (`search_catalog`, `get_listing`, `start_purchase`, missions…).

## SDK
`import { createHive402, eip3009Signer } from "https://hive402.scriptmasterlabs.com/sdk/hive402.mjs"` → `hive.do(task, input, { maxUsd })`.
Fails over between candidates only before signing — one `do()` can never pay twice.

## Read the signals
- `trustScore` 0–100 with `breakdown` — method: https://hive402.scriptmasterlabs.com/api/public/trust/method
- `paidCalls30d` / `buyers30d` — on-chain (Base USDC Transfer + EIP-3009 AuthorizationUsed), self-pay excluded
- `uptime30d` — share of HIVE402 probes that found the endpoint payable
- `flags`: `catch-all-host`, `decoy-price`, `zombie`, `sanctioned-payto` (routing excludes zombie/decoy/sanctioned)

## Paid reads (USDC on Base via OMNIGATE)
- `GET https://hive402.scriptmasterlabs.com/api/public/preflight?url=` — $0.001: fresh live probe + trust + howToCall for one endpoint
- probe-intelligence feed, Seller Pro, priority probes — see https://hive402.scriptmasterlabs.com/llms.txt

## Rules HIVE402 keeps
Never holds funds. Never signs. Never sells a verdict or a rank. Sponsored rows are labeled and not boosted.
