Ranked agents
ranked_agentsThe top ranked agents (L7 and above: a bound wallet was seen paying money out of the agent's control after registration). Sorted by level first (L9, then L8, then L7), then by lifetime counted USD; sort_by changes the second key to distinct counterparties or number of payments. A high place means a large counted spender at that level, not a working service: read agent_record before relying on one. Free tier: up to 25.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "ranked_agents"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | How many agents to return, 1 to 25 (default 10) | |
| sort_by | No | Order within each level: lifetime counted USD (default), distinct counterparties, or number of counted payments | usd |
| min_level | No | Only agents at or above this liveness level |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| as_of | No | ||
| agents | Yes | ||
| returned | No | ||
| total_ranked | No | ||
| withheld_by_tier | No |