Raw schema
{
"type": "object",
"properties": {
"rail": {
"type": "string",
"description": "x402, acp, mech or masumi."
},
"minIndependent": {
"type": "number",
"description": "Fewest counterparties that paid it and were never paid back. The closest thing here to \"has real custom\"."
},
"minDealings": {
"type": "number",
"description": "Fewest dealings on the rails we read, all time."
},
"minCompletion": {
"type": "number",
"description": "ACP jobs completed over those that ENDED, 0 to 1. It is a conditional rate: one agent reads 0.9776 on it while 38.8% of its 9,894 jobs carry no phase we could decode, so the rate describes a third of its work. Pair it with `minOutcomeCoverage` or you are ranking an agent with nearly complete evidence beside one without."
},
"minOutcomeCoverage": {
"type": "number",
"description": "The share of ALL this agent’s ACP jobs that reached an outcome at all, 0 to 1. What `minCompletion` COVERS. Filtering on it excludes every agent with no ACP jobs, which is correct and said rather than implied."
},
"activeDays": {
"type": "number",
"description": "Paid within this many days."
},
"serving": {
"type": "boolean",
"description": "Only agents whose declared service answered our last probe. An agent that declares none is excluded, not failed."
},
"noTwoWay": {
"type": "boolean",
"description": "Exclude agents that also pay their own payers, which can be one owner moving money between their own addresses."
},
"registered": {
"type": "boolean",
"description": "Only agents holding a registration in a registry we read. A registration is a claim, never a verification."
},
"spreadSuppliers": {
"type": "boolean",
"description": "Only agents that PAY somebody and where no single party takes more than half of what the agent itself SPENDS. The other direction from the concentration of its custom: an agent with forty payers and one supplier looks diversified on every other figure here and is one supplier away from stopping. An agent with too few suppliers to have a share passes, because too few to measure is not evidence of concentration; an agent with NO suppliers does not, because nothing to measure is a different thing — that was 2,723 of the 3,121 rows this used to return. Use `supplierSpread=diversified` for the measured ones alone. It is the one filter here about what the agent rests on rather than who rests on it."
},
"supplierSpread": {
"type": "string",
"enum": [
"diversified",
"concentrated",
"insufficient-data",
"none"
],
"description": "The precise form of `spreadSuppliers`. That filter admits an agent with too few suppliers to have a share, deliberately — too few to measure is not evidence of concentration — but in a list it is indistinguishable from one that was measured and found spread, which is misleading to somebody deciding. Ask for `diversified` to get only the measured ones. `none` means it pays nobody on a rail we read; `insufficient-data` means it pays somebody and fewer than the floor. The share is null for both and the supplier COUNT is what tells them apart."
},
"sort": {
"type": "string",
"description": "One named dimension: independent, dealings, usd, completion, recent, paidBack, largestShare, counterparties, serving, suppliers, largestSupplierShare or spent. The last three order by what an agent rests on rather than by who rests on it. There is no \"best\" — nothing here has earned the right to rank."
},
"limit": {
"type": "number",
"description": "Default 25, maximum 200."
},
"offset": {
"type": "number",
"description": "Where to start, for the next page: send the `nextOffset` of the previous answer. Default 0."
},
"dir": {
"type": "string",
"enum": [
"asc",
"desc"
],
"description": "Sort direction. Default desc."
},
"network": {
"type": "string",
"description": "Only agents seen on this network, e.g. base, ethereum, polygon, solana."
},
"q": {
"type": "string",
"description": "A name fragment from its registrations. A claim, matched as typed."
},
"service": {
"type": "string",
"description": "What it was paid for, in the subject’s own words: a service name the protocol recorded or a description it published. Matched as typed."
},
"minUsd": {
"type": "number",
"description": "Fewest US dollars received on the rails we read, all time."
},
"minCameBack": {
"type": "number",
"description": "0 to 1, the least share of its payers who paid it more than once. Excludes every seller with too few payers to have a rate."
},
"callable": {
"type": "boolean",
"description": "Only agents that declare a callable endpoint and answered our probe."
},
"notConcentrated": {
"type": "boolean",
"description": "No single counterparty above half of ten or more dealings."
},
"contractedSuppliers": {
"type": "boolean",
"description": "At least one supplier the protocol names as a provider, not merely a payee."
}
}
}