Skip to main content
GET
/
api
/
v1
/
x402
/
wallet
/
{address}
x402 Wallet Lookup
curl --request GET \
  --url https://api.agentscore.sh/api/v1/x402/wallet/{address}
This is a legacy endpoint. For new integrations, use GET /v1/reputation/:address.

​
Overview

Returns an individual wallet’s trust score, grade, role, 5-dimension breakdown, transaction stats, and identity match from the x402 payment network. No authentication required.

​
Path parameters

​
address
string
required
EVM wallet address (0x-prefixed).

​
Example

curl https://api.agentscore.sh/api/v1/x402/wallet/0xdb5aa553feeb2c3e3d03e8360b36fb0f7e480671
Response (found)
{
  "wallet": "0xdb5aa553feeb2c3e3d03e8360b36fb0f7e480671",
  "score": 100,
  "grade": "A",
  "role": "hybrid",
  "dimensions": {
    "volume": 100,
    "diversity": 100,
    "consistency": 100,
    "recency": 100,
    "balance": 100
  },
  "stats": {
    "total_txns": 2440,
    "as_payer": 3,
    "as_payee": 2437,
    "active_months": 1
  },
  "identity": null,
  "first_seen": "2026-02-27T19:50:13.000Z",
  "last_seen": "2026-03-08T00:00:03.000Z",
  "volume_usdc": 202.16,
  "counterparties": 11,
  "scored_at": "2026-03-08T00:01:46.371Z"
}
Response (not found)
{
  "error": "Wallet not found",
  "wallet": "0x0000000000000000000000000000000000000001"
}

​
Response fields

FieldTypeDescription
walletstringThe queried wallet address
scorenumberComposite score 25-100
gradestringLetter grade: A, B, C, D, or F
rolestringagent, service, or hybrid
dimensionsobject5 dimension scores (0-100)
dimensions.volumenumberTransaction volume score
dimensions.diversitynumberCounterparty diversity score
dimensions.consistencynumberActivity regularity score
dimensions.recencynumberHow recently the agent was active
dimensions.balancenumberBalance between paying and receiving
stats.total_txnsnumberTotal transaction count
stats.as_payernumberTransactions where this wallet paid
stats.as_payeenumberTransactions where this wallet received
stats.active_monthsnumberNumber of months with activity
identityobject or nullERC-8004 identity if matched (name, chain, token_id)
first_seenstringISO 8601 timestamp of earliest transaction
last_seenstringISO 8601 timestamp of most recent transaction
volume_usdcnumberTotal USDC volume transacted
counterpartiesnumberUnique counterparties interacted with
scored_atstringISO 8601 timestamp of when the score was computed