Agent402.tools
GET agent402.tools/api/bestsellers
Why an agent can trust this route.
Sonar evidence is advisory. Paid delivery is shown as verified only when paid probes are available; otherwise route estimates use the unpaid handshake as a clearly labeled proxy.
Observed outcomes
What agents actually pay for on a 500+ tool x402 catalog - the paid intelligence layer over Agent402's own sales ledger, the one demand signal that never reaches the chain (settlements are on-chain; WHICH tool was bought is not). Aggregate sales totals are free at /api/sales; this adds the per-tool layer they deliberately omit: pick the window (days 1-90) and the ranking lens with sort: 'buyers' (distinct paying wallets, default - the whale/wash-resistant read), 'sales' (volume), 'usd'.
Resource: agent402.tools/api/bestsellers
Network: eip155:8453, eip155:137, eip155:42161, eip155:143, eip155:43114, eip155:1329, eip155:10, eip155:4663, eip155:42220, solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp, stellar:pubnet, algorand:wGHE2Pwdvd7S12BL5FaOP20EGYesN73ktiC1qzkkit8= · Asset: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 · Pay to: 0xaBF4FAbd7c416fB67202E5f9002389Fc75e2a9D0
Payment methods: permit2 · Last validation: 2026-09-13 23:01:28.549+00
{
"input": {
"type": "object",
"required": [
"type",
"method"
],
"properties": {
"type": {
"type": "string",
"const": "http"
},
"method": {
"enum": [
"GET"
],
"type": "string"
},
"queryParams": {
"type": "object",
"properties": {
"days": {
"type": "integer",
"description": "Aggregation window in days, 1-90 (default 30). The trend compares against the same-length window immediately before it."
},
"sort": {
"enum": [
"buyers",
"sales",
"usd",
"organic"
],
"type": "string",
"description": "Ranking lens: buyers=distinct paying wallets (default, whale-resistant), sales=volume, usd=revenue, organic=organicScore (buyer diversity)"
},
"limit": {
"type": "integer",
"description": "How many tools to return (1-50, default 10)"
}
}
}
},
"additionalProperties": false
},
"output": {
"type": "object",
"required": [
"type"
],
"properties": {
"type": {
"type": "string"
},
"example": {
"type": "object",
"required": [
"days",
"sort",
"limit",
"recordingSince",
"persistent",
"totals",
"bestsellers",
"note",
"generatedAt"
],
"properties": {
"days": {
"type": "integer"
},
"note": {
"type": "string"
},
"sort": {
"type": "string"
},
"limit": {
"type": "integer"
},
"totals": {
"type": "object"
},
"persistent": {
"type": "boolean"
},
"bestsellers": {
"type": "array"
},
"generatedAt": {
"type": "string"
},
"recordingSince": {
"type": "string"
}
}
}
}
},
"paymentRequirements": [
{
"raw": {
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"extra": {
"name": "USD Coin",
"version": "2"
},
"payTo": "0xaBF4FAbd7c416fB67202E5f9002389Fc75e2a9D0",
"amount": "5000",
"scheme": "exact",
"network": "eip155:8453",
"outputSchema": {
"type": "object",
"required": [
"days",
"sort",
"limit",
"recordingSince",
"persistent",
"totals",
"bestsellers",
"note",
"generatedAt"
],
"properties": {
"days": {
"type": "integer"
},
"note": {
"type": "string"
},
"sort": {
"type": "string"
},
"limit": {
"type": "integer"
},
"totals": {
"type": "object"
},
"persistent": {
"type": "boolean"
},
"bestsellers": {
"type": "array"
},
"generatedAt": {
"type": "string"
},
"recordingSince": {
"type": "string"
}
}
},
"maxTimeoutSeconds": 300
},
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"payTo": "0xaBF4FAbd7c416fB67202E5f9002389Fc75e2a9D0",
"scheme": "exact",
"network": "eip155:8453",
"amountAtomic": "5000"
},
{
"raw": {
"asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
"extra": {
"name": "USD Coin",
"version": "2"
},
"payTo": "0xaBF4FAbd7c416fB67202E5f9002389Fc75e2a9D0",
"amount": "5000",
"scheme": "exact",
"network": "eip155:137",
"maxTimeoutSeconds": 300
},
"asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
"payTo": "0xaBF4FAbd7c416fB67202E5f9002389Fc75e2a9D0",
"scheme": "exact",
"network": "eip155:137",
"amountAtomic": "5000"
},
{
"raw": {
"asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
"extra": {
"name": "USD Coin",
"version": "2"
},
"payTo": "0xaBF4FAbd7c416fB67202E5f9002389Fc75e2a9D0",
"amount": "5000",
"scheme": "exact",
"network": "eip155:42161",
"maxTimeoutSeconds": 300
},
"asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
"payTo": "0xaBF4FAbd7c416fB67202E5f9002389Fc75e2a9D0",
"scheme": "exact",
"network": "eip155:42161",
"amountAtomic": "5000"
},
{
"raw": {
"asset": "0x754704Bc059F8C67012fEd69BC8A327a5aafb603",
"extra": {
"name": "USDC",
"version": "2"
},
"payTo": "0xaBF4FAbd7c416fB67202E5f9002389Fc75e2a9D0",
"amount": "5000",
"scheme": "exact",
"network": "eip155:143",
"maxTimeoutSeconds": 300
},
"asset": "0x754704Bc059F8C67012fEd69BC8A327a5aafb603",
"payTo": "0xaBF4FAbd7c416fB67202E5f9002389Fc75e2a9D0",
"scheme": "exact",
"network": "eip155:143",
"amountAtomic": "5000"
},
{
"raw": {
"asset": "0xB97EF9Ef8734C71904D8002F8b6Bc66Dd9c48a6E",
"extra": {
"name": "USD Coin",
"version": "2"
},
"payTo": "0xaBF4FAbd7c416fB67202E5f9002389Fc75e2a9D0",
"amount": "5000",
"scheme": "exact",
"network": "eip155:43114",
"maxTimeoutSeconds": 300
},
"asset": "0xB97EF9Ef8734C71904D8002F8b6Bc66Dd9c48a6E",
"payTo": "0xaBF4FAbd7c416fB67202E5f9002389Fc75e2a9D0",
"scheme": "exact",
"network": "eip155:43114",
"amountAtomic": "5000"
},
{
"raw": {
"asset": "0xe15fC38F6D8c56aF07bbCBe3BAf5708A2Bf42392",
"extra": {
"name": "USDC",
"version": "2"
},
"payTo": "0xaBF4FAbd7c416fB67202E5f9002389Fc75e2a9D0",
"amount": "5000",
"scheme": "exact",
"network": "eip155:1329",
"maxTimeoutSeconds": 300
},
"asset": "0xe15fC38F6D8c56aF07bbCBe3BAf5708A2Bf42392",
"payTo": "0xaBF4FAbd7c416fB67202E5f9002389Fc75e2a9D0",
"scheme": "exact",
"network": "eip155:1329",
"amountAtomic": "5000"
},
{
"raw": {
"asset": "0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85",
"extra": {
"name": "USD Coin",
"version": "2"
},
"payTo": "0xaBF4FAbd7c416fB67202E5f9002389Fc75e2a9D0",
"amount": "6000",
"scheme": "exact",
"network": "eip155:10",
"maxTimeoutSeconds": 300
},
"asset": "0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85",
"payTo": "0xaBF4FAbd7c416fB67202E5f9002389Fc75e2a9D0",
"scheme": "exact",
"network": "eip155:10",
"amountAtomic": "6000"
},
{
"raw": {
"asset": "0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168",
"extra": {
"name": "Global Dollar",
"version": "1"
},
"payTo": "0xaBF4FAbd7c416fB67202E5f9002389Fc75e2a9D0",
"amount": "5000",
"scheme": "exact",
"network": "eip155:4663",
"maxTimeoutSeconds": 300
},
"asset": "0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168",
"payTo": "0xaBF4FAbd7c416fB67202E5f9002389Fc75e2a9D0",
"scheme": "exact",
"network": "eip155:4663",
"amountAtomic": "5000"
},
{
"raw": {
"asset": "0xcebA9300f2b948710d2653dD7B07f33A8B32118C",
"extra": {
"name": "USDC",
"version": "2"
},
"payTo": "0xaBF4FAbd7c416fB67202E5f9002389Fc75e2a9D0",
"amount": "5000",
"scheme": "exact",
"network": "eip155:42220",
"maxTimeoutSeconds": 300
},
"asset": "0xcebA9300f2b948710d2653dD7B07f33A8B32118C",
"payTo": "0xaBF4FAbd7c416fB67202E5f9002389Fc75e2a9D0",
"scheme": "exact",
"network": "eip155:42220",
"amountAtomic": "5000"
},
{
"raw": {
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"extra": {
"name": "USD Coin",
"version": "2",
"facilitatorAddress": "0x2A89407a98A0732b7fD578c4E156B7166540EB5A",
"assetTransferMethod": "permit2"
},
"payTo": "0xaBF4FAbd7c416fB67202E5f9002389Fc75e2a9D0",
"amount": "5000",
"scheme": "upto",
"network": "eip155:8453",
"maxTimeoutSeconds": 300
},
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"payTo": "0xaBF4FAbd7c416fB67202E5f9002389Fc75e2a9D0",
"scheme": "upto",
"network": "eip155:8453",
"amountAtomic": "5000"
},
{
"raw": {
"asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
"extra": {
"feePayer": "BENrLoUbndxoNMUS5JXApGMtNykLjFXXixMtpDwDR9SP"
},
"payTo": "J7aN3PLJnTCF5qpEnvJHJsnCjcGuqC2rYtEM8Gv3xwg",
"amount": "5000",
"scheme": "exact",
"network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
"maxTimeoutSeconds": 300
},
"asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
"payTo": "J7aN3PLJnTCF5qpEnvJHJsnCjcGuqC2rYtEM8Gv3xwg",
"scheme": "exact",
"network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
"amountAtomic": "5000"
},
{
"raw": {
"asset": "CCW67TSZV3SSS2HXMBQ5JFGCKJNXKZM7UQUWUZPUTHXSTZLEO7SJMI75",
"extra": {
"areFeesSponsored": true
},
"payTo": "GDNJXCKW7ZM7GEEVP674TWPU26YJNBQ2FI4ZIPRKTPTNUEJMDHFJWWRL",
"amount": "50000",
"scheme": "exact",
"network": "stellar:pubnet",
"maxTimeoutSeconds": 300
},
"asset": "CCW67TSZV3SSS2HXMBQ5JFGCKJNXKZM7UQUWUZPUTHXSTZLEO7SJMI75",
"payTo": "GDNJXCKW7ZM7GEEVP674TWPU26YJNBQ2FI4ZIPRKTPTNUEJMDHFJWWRL",
"scheme": "exact",
"network": "stellar:pubnet",
"amountAtomic": "50000"
},
{
"raw": {
"asset": "31566704",
"extra": {
"tag": "x402-global-challenge",
"feePayer": "ZMFK2OI7ZBD2U27ISERZC4S6LKM6WMFJPZQ4MYNJDZ2VNBNMBA67RA22AA"
},
"payTo": "C7IIHG7SPLPZ5H7ZT6HW3UV2OQMQQE6Y2HBNGZXSLRJULE42BEE2OY2XIE",
"amount": "5000",
"scheme": "exact",
"network": "algorand:wGHE2Pwdvd7S12BL5FaOP20EGYesN73ktiC1qzkkit8=",
"maxTimeoutSeconds": 300
},
"asset": "31566704",
"payTo": "C7IIHG7SPLPZ5H7ZT6HW3UV2OQMQQE6Y2HBNGZXSLRJULE42BEE2OY2XIE",
"scheme": "exact",
"network": "algorand:wGHE2Pwdvd7S12BL5FaOP20EGYesN73ktiC1qzkkit8=",
"amountAtomic": "5000"
}
]
}Source catalog records are retained separately from live endpoint observations. Sonar score, uptime, and latency are advisory metrics. CDP indexing is not inferred from validation.