x402 Catalog icon

x402 Catalog

Query the SmartFlow Observatory x402 endpoint catalogue — 58k+ endpoints, queryable by URL, registry source, chain, status, spec-validity, on-chain volume, and recent activity.

Actions5

List Endpoints

AI-generated

Summary

List API endpoints from the x402 SmartFlow Observatory catalog, applying optional filters such as blockchain chain, registry source, last HTTP status, v2 spec validity, and minimum on-chain volume. Supports pagination via limit and offset parameters.

Inputs

  • Chain — Filter results by specific blockchain chain identifier (e.g. "base-mainnet", "solana-mainnet", "eip155:1"). Leave empty to include all chains.
  • Source — Filter results by registry source (e.g. "x402scan", "well-known-discovery", "bazaar-merge"). Leave empty to include all sources.
  • HTTP Status — Filter endpoints by their last HTTP probe status code (e.g. 200, 402). Use 0 to skip filtering by status.
  • Strict v2 Spec Valid — Filter endpoints based on strict x402 version 2 schema validity flag. Options: Any (no filter), Valid only (1), Invalid only (0).
  • Min On-Chain Volume USDC — Filter to endpoints with on-chain volume in USDC greater than this value. Use 0 to skip volume filtering.
  • Limit — Maximum number of endpoints to return, between 1 and 500. Defaults to 100.
  • Offset — Pagination offset to control the returned subset of results, defaults to 0.

Output shape

a JSON object representing a list of endpoint records matching the specified filters

The returned data includes endpoint details as per the SmartFlow x402 catalog API response format. Pagination is controlled by limit and offset parameters. Each returned item corresponds to one input; typically, one input is processed at a time.

Examples

Example 1: Filter endpoints on "eip155:1" chain with HTTP 200 status and valid v2 spec, limit 50

chain='eip155:1', status=200, specValid=1, limit=50, offset=0

Links

Discussion