Skip to main content
GET
/
api
/
v1
/
x402
/
stats
x402 Stats
curl --request GET \
  --url https://api.agentscore.sh/api/v1/x402/stats
This is a legacy endpoint. For new integrations, use GET /v1/stats.

​
Overview

Returns aggregate statistics for the x402 payment network including agent counts, grade distribution, role breakdown, and transaction volume. No authentication required.

​
Example

curl https://api.agentscore.sh/api/v1/x402/stats
Response
{
  "total_wallets": 37208,
  "distribution": {
    "A": 455,
    "B": 1853,
    "C": 4595,
    "D": 4908,
    "F": 25397
  },
  "avg_score": 47,
  "max_score": 100,
  "min_score": 25,
  "wallets_as_payer": 25012,
  "wallets_as_payee": 12764,
  "wallets_both_roles": 568,
  "total_transactions": 7254580,
  "roles": {
    "agent": 24444,
    "hybrid": 568,
    "service": 12196
  },
  "identified_agents": 17,
  "data_source": "CDP SQL API backfill + ERC-8004 cross-reference",
  "version": "v1"
}

​
Response fields

FieldTypeDescription
total_walletsnumberTotal scored agents
distributionobjectCount of agents per grade (A, B, C, D, F)
rolesobjectCount by role: agent, service, hybrid
total_transactionsnumberTotal x402 transactions indexed
identified_agentsnumberAgents matched to ERC-8004 registry names
avg_scorenumberAverage score across all agents
max_scorenumberHighest score in the dataset
min_scorenumberLowest score in the dataset
wallets_as_payernumberWallets that have paid in x402 transactions
wallets_as_payeenumberWallets that have received x402 payments
wallets_both_rolesnumberWallets active as both payer and payee
data_sourcestringDescription of the data pipeline
versionstringScoring model version

​
Caching

Response is cached for 5 minutes (Cache-Control: public, max-age=300).