Skip to main content
GET
/
api
/
v1
/
x402
/
browse
x402 Browse
curl --request GET \
  --url https://api.agentscore.sh/api/v1/x402/browse
This is a legacy endpoint from the x402 explorer. Not recommended for new integrations.

​
Overview

Returns a paginated, filterable list of agents from the x402 payment network, sorted by score descending. No authentication required.

​
Query parameters

​
limit
number
default:"50"
Results per page. Maximum 100.
​
offset
number
default:"0"
Pagination offset.
​
grade
string
Filter by grade: A, B, C, D, F.
​
role
string
Filter by role: agent, service, hybrid.
​
min_score
number
Minimum score threshold.

​
Example

curl "https://api.agentscore.sh/api/v1/x402/browse?grade=A&limit=2"
Response
{
  "total": 455,
  "offset": 0,
  "limit": 2,
  "wallets": [
    {
      "wallet": "0xdb5aa553feeb2c3e3d03e8360b36fb0f7e480671",
      "score": 100,
      "grade": "A",
      "role": "hybrid",
      "total_txns": 2440,
      "as_payer": 3,
      "as_payee": 2437,
      "active_months": 1,
      "name": null,
      "first_seen": "2026-02-27T19:50:13.000Z",
      "last_seen": "2026-03-08T00:00:03.000Z",
      "volume_usdc": 202.16,
      "counterparties": 11
    },
    {
      "wallet": "0x447e981bd3d8267499860ff0f9afbc9f8ffcc514",
      "score": 99,
      "grade": "A",
      "role": "hybrid",
      "total_txns": 17677,
      "as_payer": 17587,
      "as_payee": 90,
      "active_months": 1,
      "name": null,
      "first_seen": "2026-03-01T22:58:41.000Z",
      "last_seen": "2026-03-06T21:23:01.000Z",
      "volume_usdc": 253.34,
      "counterparties": 39
    }
  ]
}

​
Response fields

FieldTypeDescription
totalnumberTotal agents matching the query
offsetnumberCurrent pagination offset
limitnumberResults per page
walletsarrayArray of agent objects
wallets[].walletstringWallet address
wallets[].scorenumberComposite score 25-100
wallets[].gradestringLetter grade
wallets[].rolestringagent, service, or hybrid
wallets[].total_txnsnumberTotal transaction count
wallets[].namestring or nullERC-8004 name if matched
wallets[].volume_usdcnumberTotal USDC volume
wallets[].counterpartiesnumberUnique counterparties

​
Caching

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