sentinel-quality-client

Client library for x402 Sentinel — quality verification data for 12,000+ x402 endpoints.

Zero dependencies. Works in any Node.js environment.

Install

npm install sentinel-quality-client

Quick Start

import { sentinel } from 'sentinel-quality-client';

// List categories
const { categories } = await sentinel.catalog();
// → ["crypto-data", "web-scraping", "domain-check", ...]

// Find endpoints in a category, ranked by quality
const { endpoints } = await sentinel.catalog('web-scraping');
// → [{ url, quality_score, price, network, ... }, ...]

// Quick quality check
const badge = await sentinel.badge('https://some-endpoint.fly.dev/api');
// → { verified: true, score: 94, last_scanned: "2026-04-12" }

With API Key (for score + scan)

import { createSentinel } from 'sentinel-quality-client';

const sentinel = createSentinel({ apiKey: 'your-key' });

// Detailed breakdown
const score = await sentinel.score('https://some-endpoint.fly.dev/api');
// → { quality_score: 94, breakdown: { schema, temporal, cross_ref, llm_judge }, history: [...] }

// Fresh deep scan (10-30s)
const scan = await sentinel.scan('https://some-endpoint.fly.dev/api');
// → { quality_score, breakdown, raw_tests: [...] }

Agent Framework Examples

CrewAI / LangGraph

import { sentinel } from 'sentinel-quality-client';

// Agent picks the best endpoint for a task
async function findBestEndpoint(category) {
  const { endpoints } = await sentinel.catalog(category);
  const verified = endpoints.filter(e => e.quality_score >= 70);
  return verified[0]; // highest score
}

const best = await findBestEndpoint('web-scraping');
console.log(`Using ${best.url} (score: ${best.quality_score})`);

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | SENTINEL_API_KEY | For score/scan | API key for internal endpoints | | SENTINEL_URL | No | Custom Sentinel URL (default: https://x402-sentinel.fly.dev) |

API

sentinel.catalog(category?)

List categories or endpoints in a category. Free, no API key needed.

sentinel.badge(url)

Quick verified/not + score. Free, no API key needed.

sentinel.score(url)

Detailed breakdown + history. Requires API key.

sentinel.scan(url)

Fresh deep scan. Requires API key. Takes 10-30s.