Overview
Use when a buyer's planner agent is about to start a batch of paid x402 calls: post a plan of seller URLs and call counts and get the total cost, each seller's listing and certification state, its expected failure share from reconciled receipts, the fit against your caps (per call, per seller, total, policy tier), and every certified seller in the same category sorted by price with the sort key stated.
Protocol
x402 (POST)
Price
$0.01
Payment Asset
USD Coin
Payment Network
eip155:8453
Category
uncategorized
Provider
Agoranome
Indexed
2026-11-09 21:08:17
Health
Status
unknown
Latency (p50)
—
Uptime (30d)
—
Reliability Score
—
Last Checked
Never
Last Healthy
Never
Consecutive Failures
0
Input Schema
{
"body": {
"caps": {
"max_price_usd": 0.05,
"max_total_usd": 5,
"tier": "sampled"
},
"plan": [
{
"calls": 200,
"seller": "https://api.example.com/v1/search"
}
]
},
"bodyType": "json",
"method": "POST",
"type": "http"
}
Output Schema
{
"example": {
"receipt": {
"impact": {
"pledge": "15% of settled revenue"
},
"receipt_id": "0x..."
},
"result": {
"fits_caps": true,
"lines": [
{
"alternatives": {
"category": "web_search",
"key": "price per call, ascending",
"sellers": [
{
"price_usd": 0.005,
"resource": "<url>"
}
]
},
"calls": 200,
"certification": {
"status": "certified"
},
"cost_usd": "2.00",
"failure_share": {
"basis": "reconciled receipts, 30 days",
"value": 0.02
},
"fit": {
"per_call": "within",
"tier": "met"
},
"listing": {
"indexed": true,
"payers_30d": 12
},
"price_usd": 0.01,
"seller": "<url>"
}
],
"total_usd": "2.00"
}
},
"type": "json"
}