API Documentation

87% of x402 services are spam. Our API tells you which ones are real. Simple REST, instant responses.

Quick Start

No authentication required during launch. Just make a GET request:

curl https://scoutscore.ai/api/bazaar/score/recoupable.com

TypeScript SDK

The easiest way to integrate ScoutScore. Type-safe, with retries and error handling built in.

npm install @scoutscore/sdk

import { ScoutScore } from '@scoutscore/sdk';

const scout = new ScoutScore();
const result = await scout.scoreBazaarService('recoupable.com');
console.log(result.score);  // 100
console.log(result.level);  // "HIGH"

All Methods

scoreBazaarService(domain) - Score a single service

scoreBazaarBatch(domains) - Score up to 20 at once

getFidelity(domain) - Fidelity check results

getLeaderboard(options?) - Browse the leaderboard

getBazaarStats() - Platform statistics

getHealth() - API health check

View on npm · GitHub

MCP Server

Use ScoutScore directly from AI tools that support the Model Context Protocol (MCP).

npm install @scoutscore/mcp-server

Usage with Claude Code

claude mcp add scoutscore npx @scoutscore/mcp-server

Available Tools

check_trust - Get trust score for a domain

check_fidelity - Run a fidelity probe

get_leaderboard - Browse the service directory

get_ecosystem_stats - Platform statistics

View on npm · GitHub

Base URL

https://scoutscore.ai

Endpoints

GET/api/bazaar/score/:domain

Get trust score for an x402 service by domain

REQUEST

curl https://scoutscore.ai/api/bazaar/score/lowpaymentfee.com

RESPONSE

{
  "domain": "lowpaymentfee.com",
  "score": 0,
  "level": "VERY_LOW",
  "flags": [
    "WALLET_SPAM_FARM",
    "TEMPLATE_SPAM",
    "MASS_LISTING_SPAM"
  ],
  "recommendation": {
    "verdict": "NOT_RECOMMENDED",
    "maxTransaction": 0,
    "escrowTerms": "DO_NOT_TRANSACT"
  }
}

POST/api/bazaar/batch

Score multiple x402 services at once (max 20)

REQUEST

curl -X POST https://scoutscore.ai/api/bazaar/batch \
  -H "Content-Type: application/json" \
  -d '{"domains": ["recoupable.com", "lowpaymentfee.com"]}'

RESPONSE

{
  "results": [
    {
      "domain": "recoupable.com",
      "score": 100,
      "level": "HIGH",
      "flags": ["HAS_COMPLETE_SCHEMA", "FIDELITY_PROVEN"]
    },
    {
      "domain": "lowpaymentfee.com",
      "score": 0,
      "level": "VERY_LOW",
      "flags": ["WALLET_SPAM_FARM", "TEMPLATE_SPAM"]
    }
  ]
}

GET/api/bazaar/stats

Get overall x402 service statistics

REQUEST

curl https://scoutscore.ai/api/bazaar/stats

RESPONSE

{
  "totalServices": 13835,
  "legitimateServices": 1738,
  "spamPercentage": 87,
  "uniqueWallets": 791,
  "avgScore": 12.4,
  "lastUpdated": "2026-02-19T18:00:00Z"
}

How Scoring Works

We analyze behavioral patterns, metadata quality, and on-chain signals — not code. Here's what goes into a score:

Signal	What We Check
Wallet Clustering	How many services share this wallet? 1 wallet → 10K services = spam farm.
Content Fingerprinting	Template detection via text similarity. "Premium API Access" x10,658 = spam.
Schema Quality	Does the service define its inputs/outputs? Only 10% do.
Metadata Quality	Real descriptions vs generic filler. 93% have poor metadata.
Endpoint Health	Is it online? Response time? Uptime over 7/30 days?
Mass Listing Detection	Domains with 50+ services get extra scrutiny.

Response Codes

Code	Description
200	Success
400	Bad request (invalid parameters)
404	Domain not found
429	Rate limit exceeded
500	Server error

Trust Levels

Level	Score Range	Recommendation
HIGH	70-100	Safe to transact
MEDIUM	40-69	Proceed with caution, use escrow
LOW	20-39	High risk, small transactions only
VERY_LOW	0-19	Do not transact

Common Flags

Risk Flags

WALLET_SPAM_FARM - Single wallet running 1000+ services (e.g., 10,658 from one wallet)
TEMPLATE_SPAM - Identical descriptions detected via content fingerprinting
MASS_LISTING_SPAM - Domain with 50+ services without unique wallets
NO_SCHEMA - Missing input/output definitions (90% of services)
POOR_METADATA - Description under 50 characters (93% of services)

Trust Flags

HAS_COMPLETE_SCHEMA - Full input/output API definition (only 10%)
GOOD_DOCUMENTATION - Detailed description over 50 characters
UNIQUE_WALLET_PER_SERVICE - Platform pattern (e.g., recoupable.com)
ENDPOINT_HEALTHY - Service is online and responsive
GOOD_UPTIME - 95%+ uptime over 7 days

Rate Limits

Launch Period: No Rate Limits

During the launch period, all endpoints are free and unlimited. x402 micropayments will be introduced later.