Skip to main content
The BoltzPay Registry is a live index of paid API endpoints across x402, L402, and MPP protocols. It scans, scores, and indexes every endpoint every 6 hours using EWMA-weighted health scoring.

Overview

MetricValue
Endpoints5,700+
Providers400+
Protocolsx402, L402, MPP
Scan frequencyEvery 6 hours
ScoringEWMA health-weighted (0-100)
Browse the registry at status.boltzpay.ai.

SDK Integration

discover() queries the registry API. No static directory is bundled with the SDK.
const entries = await agent.discover();

for (const entry of entries) {
  console.log(`${entry.name} — score: ${entry.score}, health: ${entry.health}`);
  console.log(`  ${entry.url} (${entry.protocol ?? "unknown"})`);
}

Filters

All filters are server-side — the registry handles filtering and pagination.
// Filter by protocol
const mppEndpoints = await agent.discover({ protocol: "mpp" });

// Minimum trust score
const trusted = await agent.discover({ minScore: 80 });

// Search by name or URL
const weather = await agent.discover({ query: "weather" });

// Filter by category
const crypto = await agent.discover({ category: "crypto-data" });

// Combine filters
const results = await agent.discover({
  protocol: "x402",
  minScore: 70,
  category: "finance",
  query: "stock",
  limit: 50,
});

DiscoverOptions

FieldTypeDefaultDescription
protocolstringFilter by protocol: "x402", "l402", "mpp"
minScorenumberMinimum trust score (0-100)
categorystringFilter by category
querystringFree-text search (name, URL, description)
limitnumber200Max results per page
offsetnumber0Pagination offset
signalAbortSignalAbort signal for cancellation

DiscoveredEntry

Each entry returned by discover():
interface DiscoveredEntry {
  readonly slug: string;
  readonly name: string;
  readonly url: string;
  readonly protocol: string | undefined;
  readonly score: number;       // 0-100, EWMA health-weighted
  readonly health: string;      // "healthy", "degraded", "dead"
  readonly category: string;
  readonly isPaid: boolean;
  readonly badge: "new" | "established" | null;
}

CLI

# Browse all endpoints
boltzpay discover

# Filter by protocol and minimum score
boltzpay discover --protocol mpp --min-score 70

# Search
boltzpay discover --query "weather"

# JSON output
boltzpay --json discover --protocol x402 --category crypto-data

MCP Tool

The boltzpay_discover MCP tool exposes the same filters:
{
  "name": "boltzpay_discover",
  "arguments": {
    "protocol": "x402",
    "minScore": 70,
    "query": "crypto"
  }
}

Custom Registry URL

Point the SDK at a self-hosted or staging registry:
const agent = new BoltzPay({
  registryUrl: "https://my-registry.example.com",
});
Default: https://status.boltzpay.ai

Scoring

Each endpoint receives a trust score from 0 to 100 based on:
  • Availability — uptime over the last 30 days (EWMA-weighted)
  • Response time — latency consistency
  • Protocol compliance — correct 402 response format
  • Price stability — consistent pricing across scans
  • Multi-source verification — confirmation from multiple independent sources (capped bonus)
Dead endpoints with no history score 0. New endpoints start with an optimistic cold-start score that converges as data accumulates.

Next Steps