AgentPay

Endpoints and prices

Payment evidence

402 payload captured at 2026-10-22 13:40:56 UTC. Check evidence JSON · Measurement methodology.

{
  "error": "Payment required",
  "accepts": [
    {
      "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "extra": {
        "name": "USD Coin",
        "version": "2",
        "assetTransferMethod": "eip3009"
      },
      "payTo": "0xE8B25A72dD6aeF69515452a61AD231C7DF2843b7",
      "amount": "10000",
      "scheme": "exact",
      "network": "eip155:8453",
      "mimeType": "application/json",
      "resource": "https://agentpay.tools/tools/pre_trade_check/call",
      "description": "One-call pre-trade sanity check: 'I want to long $X of SYMBOL — is now sane?' Combines live orderbook slippage at YOUR size, cross-exchange funding (carry cost), open-interest crowding, and contract security (GoPlus) into a single ok/caution/avoid verdict with a per-factor breakdown. Major ERC-20 addresses (LINK, UNI, ARB, OP, AAVE, PEPE, SHIB) resolve automatically; native assets (BTC, ETH, SOL, ...) report security n/a; an unrecognized token without token_address reads 'unknown' and caps the verdict at caution — an unscreened contract can never read 'ok'. Replaces four API integrations and the judgment layer on top of them. Raw component data embedded so you can apply your own thresholds.",
      "outputSchema": {
        "input": {
          "type": "object",
          "required": [
            "symbol"
          ],
          "properties": {
            "side": {
              "enum": [
                "long",
                "short"
              ],
              "type": "string",
              "default": "long",
              "description": "Trade direction (funding carry is side-aware)"
            },
            "symbol": {
              "type": "string",
              "description": "Asset to check, e.g. 'ETH', 'BTC', 'SOL'"
            },
            "size_usd": {
              "type": "number",
              "default": 10000,
              "description": "Intended position size in USD (drives the slippage check)"
            },
            "token_address": {
              "type": "string",
              "description": "Optional ERC-20 contract address for the GoPlus security scan. Auto-resolved for major tokens; required for a full verdict on tokens the resolver doesn't know (otherwise security reads 'unknown' and caps the verdict at caution)"
            }
          }
        },
        "errors": [
          {
            "body": {
              "error": "<summary>",
              "reason": "<machine-readable reason>"
            },
            "when": "No payment attached (this challenge), or the attached payment failed verification: wrong amount/recipient, memo mismatch, expired, or already used (replay)",
            "retry": "Re-request the challenge and pay again",
            "status": 402
          },
          {
            "body": {
              "detail": [
                {
                  "loc": [
                    "body"
                  ],
                  "msg": "<what is wrong>",
                  "type": "<error type>"
                }
              ]
            },
            "when": "Request body present but malformed (invalid JSON or wrong field types) WITH a payment header attached — checked BEFORE settlement, so the payment is never consumed. An unpaid malformed request gets the 402, not a 422",
            "retry": "Fix the body and retry with a fresh payment",
            "status": 422
          },
          {
            "body": {
              "detail": "Tool '<name>' not found"
            },
            "when": "Unknown tool name",
            "status": 404
          },
          {
            "body": {
              "error": "Rate limit exceeded"
            },
            "when": "Rate limited (per-IP and per-wallet limits)",
            "retry": "Back off and retry after a minute",
            "status": 429
          },
          {
            "body": {
              "tool": "<name>",
              "error": "Tool execution failed",
              "payment_status": "refund_pending"
            },
            "when": "Payment settled on-chain but tool execution failed — the payment is marked refund_pending automatically; you are not charged for a failed call",
            "status": 500
          },
          {
            "body": {
              "detail": "<what is unavailable>"
            },
            "when": "Tool temporarily unavailable, or the gateway cannot persist the challenge (fail-closed)",
            "retry": "Retry shortly",
            "status": 503
          }
        ],
        "output": {
          "side": "long",
          "symbol": "ETH",
          "factors": {
            "carry": {
              "level": "caution",
              "reason": "longs paying elevated funding",
              "annualized_pct": 67.9,
              "median_funding_pct": 0.062
            },
            "crowding": {
              "level": "ok",
              "reason": "positioning unremarkable",
              "long_short_ratio": 1.4,
              "oi_change_24h_pct": 3.2
            },
            "security": {
              "level": "skipped",
              "reason": "no token_address provided"
            },
            "liquidity": {
              "level": "ok",
              "reason": "fills within 0.011% of best ask",
              "bucket_usd": 50000,
              "slippage_pct": 0.011
            }
          },
          "verdict": "caution",
          "size_usd": 50000
        }
      },
      "maxTimeoutSeconds": 300
    },
    {
      "asset": "SM3VDXK3WZZSA84XXFKAFAF15NNZX32CTSG82JFQ4.sbtc-token",
      "extra": {
        "tokenType": "sBTC",
        "payment_id": "b8c29fb0-8ee2-45a0-9a04-a321756bc047",
        "amount_usdc": "0.01",
        "btc_usd_rate": "81646"
      },
      "payTo": "SP23XKWSEQ9D4CVPT0H39N2TYVEE5AJECPKW6CZ3C",
      "amount": "13",
      "scheme": "exact",
      "network": "stacks:1",
      "maxTimeoutSeconds": 119
    },
    {
      "asset": "STX",
      "extra": {
        "tokenType": "STX",
        "payment_id": "b8c29fb0-8ee2-45a0-9a04-a321756bc047",
        "amount_usdc": "0.01",
        "stx_usd_rate": "0.341964"
      },
      "payTo": "SP23XKWSEQ9D4CVPT0H39N2TYVEE5AJECPKW6CZ3C",
      "amount": "29243",
      "scheme": "exact",
      "network": "stacks:1",
      "maxTimeoutSeconds": 119
    }
  ],
  "resource": {
    "url": "https://agentpay.tools/tools/pre_trade_check/call",
    "tags": [
      "trading",
      "trade",
      "risk",
      "slippage",
      "pre-trade-check"
    ],
    "mimeType": "application/json",
    "description": "Pre-trade risk check for AI agents trading crypto: live orderbook slippage at YOUR size, side-aware funding carry, open-interest crowding, and optional contract security — composed into a single ok/caution/avoid verdict with per-factor reasons and raw data embedded. Answers 'is this trade sane?' before trading, not after. Replaces four API integrations plus the judgment layer.",
    "serviceName": "AgentPay Pre-Trade Risk Check"
  },
  "extensions": {
    "bazaar": {
      "info": {
        "input": {
          "body": {
            "parameters": {
              "side": "long",
              "symbol": "ETH",
              "size_usd": 50000
            }
          },
          "type": "http",
          "method": "POST",
          "bodyType": "json"
        },
        "errors": [
          {
            "body": {
              "error": "<summary>",
              "reason": "<machine-readable reason>"
            },
            "when": "No payment attached (this challenge), or the attached payment failed verification: wrong amount/recipient, memo mismatch, expired, or already used (replay)",
            "retry": "Re-request the challenge and pay again",
            "status": 402
          },
          {
            "body": {
              "detail": [
                {
                  "loc": [
                    "body"
                  ],
                  "msg": "<what is wrong>",
                  "type": "<error type>"
                }
              ]
            },
            "when": "Request body present but malformed (invalid JSON or wrong field types) WITH a payment header attached — checked BEFORE settlement, so the payment is never consumed. An unpaid malformed request gets the 402, not a 422",
            "retry": "Fix the body and retry with a fresh payment",
            "status": 422
          },
          {
            "body": {
              "detail": "Tool '<name>' not found"
            },
            "when": "Unknown tool name",
            "status": 404
          },
          {
            "body": {
              "error": "Rate limit exceeded"
            },
            "when": "Rate limited (per-IP and per-wallet limits)",
            "retry": "Back off and retry after a minute",
            "status": 429
          },
          {
            "body": {
              "tool": "<name>",
              "error": "Tool execution failed",
              "payment_status": "refund_pending"
            },
            "when": "Payment settled on-chain but tool execution failed — the payment is marked refund_pending automatically; you are not charged for a failed call",
            "status": 500
          },
          {
            "body": {
              "detail": "<what is unavailable>"
            },
            "when": "Tool temporarily unavailable, or the gateway cannot persist the challenge (fail-closed)",
            "retry": "Retry shortly",
            "status": 503
          }
        ],
        "output": {
          "type": "json",
          "example": {
            "side": "long",
            "symbol": "ETH",
            "factors": {
              "carry": {
                "level": "ok",
                "reason": "carry unremarkable",
                "median_funding_pct": 0.01
              },
              "crowding": {
                "level": "ok",
                "reason": "positioning unremarkable",
                "long_short_ratio": 1.2
              },
              "security": {
                "level": "skipped",
                "reason": "no token_address provided"
              },
              "liquidity": {
                "level": "ok",
                "reason": "fills within 0.001% of best price",
                "slippage_pct": 0.001
              }
            },
            "verdict": "ok",
            "size_usd": 50000
          }
        }
      },
      "schema": {
        "type": "object",
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "required": [
          "input"
        ],
        "properties": {
          "input": {
            "type": "object",
            "required": [
              "type",
              "bodyType",
              "body",
              "method"
            ],
            "properties": {
              "body": {
                "type": "object",
                "properties": {
                  "parameters": {
                    "type": "object",
                    "required": [
                      "symbol"
                    ],
                    "properties": {
                      "side": {
                        "enum": [
                          "long",
                          "short"
                        ],
                        "type": "string",
                        "description": "Trade direction (funding carry is side-aware; default long)"
                      },
                      "symbol": {
                        "type": "string",
                        "description": "Asset to check, e.g. 'ETH', 'BTC', 'SOL'"
                      },
                      "size_usd": {
                        "type": "number",
                        "description": "Intended position size in USD (drives the slippage check; default 10000)"
                      },
                      "token_address": {
                        "type": "string",
                        "description": "Optional ERC-20 address — adds a GoPlus security scan"
                      }
                    }
                  }
                }
              },
              "type": {
                "type": "string",
                "const": "http"
              },
              "method": {
                "enum": [
                  "POST"
                ],
                "type": "string"
              },
              "bodyType": {
                "enum": [
                  "json",
                  "form-data",
                  "text"
                ],
                "type": "string"
              }
            },
            "additionalProperties": false
          },
          "output": {
            "type": "object",
            "required": [
              "type"
            ],
            "properties": {
              "type": {
                "type": "string"
              },
              "example": {
                "type": "object"
              }
            }
          }
        }
      },
      "description": "Pre-trade risk check for AI agents trading crypto: 'I want to long $X of SYMBOL — is now sane?' Live slippage at your size + side-aware funding carry + OI crowding + optional security scan → one ok/caution/avoid verdict with per-factor breakdown and raw components embedded."
    }
  },
  "x402Version": 2
}

{
  "error": "Payment required",
  "accepts": [
    {
      "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "extra": {
        "name": "USD Coin",
        "version": "2",
        "assetTransferMethod": "eip3009"
      },
      "payTo": "0xE8B25A72dD6aeF69515452a61AD231C7DF2843b7",
      "amount": "10000",
      "scheme": "exact",
      "network": "eip155:8453",
      "mimeType": "application/json",
      "resource": "https://agentpay.tools/tools/session_create/call",
      "description": "Open a budget-capped agent session on AgentPay. Pay $0.01 USDC once — get a session_id, budget config, and gateway URL. Enforces a hard max_spend cap across all subsequent tool calls via the AgentPay SDK. The entry point for agents discovering AgentPay on Base Bazaar.",
      "outputSchema": {
        "input": {
          "type": "object",
          "properties": {
            "label": {
              "type": "string",
              "description": "Optional human-readable label for this session"
            },
            "max_spend": {
              "type": "string",
              "default": "0.10",
              "description": "Hard budget cap in USDC for this session, e.g. '0.10'"
            },
            "agent_address": {
              "type": "string",
              "description": "Your wallet address (Stellar G... or EVM 0x...)"
            }
          }
        },
        "errors": [
          {
            "body": {
              "error": "<summary>",
              "reason": "<machine-readable reason>"
            },
            "when": "No payment attached (this challenge), or the attached payment failed verification: wrong amount/recipient, memo mismatch, expired, or already used (replay)",
            "retry": "Re-request the challenge and pay again",
            "status": 402
          },
          {
            "body": {
              "detail": [
                {
                  "loc": [
                    "body"
                  ],
                  "msg": "<what is wrong>",
                  "type": "<error type>"
                }
              ]
            },
            "when": "Request body present but malformed (invalid JSON or wrong field types) WITH a payment header attached — checked BEFORE settlement, so the payment is never consumed. An unpaid malformed request gets the 402, not a 422",
            "retry": "Fix the body and retry with a fresh payment",
            "status": 422
          },
          {
            "body": {
              "detail": "Tool '<name>' not found"
            },
            "when": "Unknown tool name",
            "status": 404
          },
          {
            "body": {
              "error": "Rate limit exceeded"
            },
            "when": "Rate limited (per-IP and per-wallet limits)",
            "retry": "Back off and retry after a minute",
            "status": 429
          },
          {
            "body": {
              "tool": "<name>",
              "error": "Tool execution failed",
              "payment_status": "refund_pending"
            },
            "when": "Payment settled on-chain but tool execution failed — the payment is marked refund_pending automatically; you are not charged for a failed call",
            "status": 500
          },
          {
            "body": {
              "detail": "<what is unavailable>"
            },
            "when": "Tool temporarily unavailable, or the gateway cannot persist the challenge (fail-closed)",
            "retry": "Retry shortly",
            "status": 503
          }
        ],
        "output": {
          "label": null,
          "receipt": {
            "network": "base",
            "tx_hash": "0xabc...def",
            "amount_usdc": "0.01"
          },
          "sdk_hint": "Use `from agentpay import Session` to enforce the max_spend cap client-side.",
          "max_spend": "0.10",
          "created_at": "2026-05-27T12:00:00Z",
          "session_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
          "gateway_url": "https://agentpay.tools",
          "agent_address": "GBCVQCNFWPM3GDO4GPT4YEQ42ZHPY67QTJA3WN5ERQIKQDXKBX62SLNJ",
          "tools_endpoint": "https://agentpay.tools/tools"
        }
      },
      "maxTimeoutSeconds": 300
    },
    {
      "asset": "SM3VDXK3WZZSA84XXFKAFAF15NNZX32CTSG82JFQ4.sbtc-token",
      "extra": {
        "tokenType": "sBTC",
        "payment_id": "4a1ac950-02ac-44c6-b3dd-c1491bb28e6f",
        "amount_usdc": "0.01",
        "btc_usd_rate": "81646"
      },
      "payTo": "SP23XKWSEQ9D4CVPT0H39N2TYVEE5AJECPKW6CZ3C",
      "amount": "13",
      "scheme": "exact",
      "network": "stacks:1",
      "maxTimeoutSeconds": 119
    },
    {
      "asset": "STX",
      "extra": {
        "tokenType": "STX",
        "payment_id": "4a1ac950-02ac-44c6-b3dd-c1491bb28e6f",
        "amount_usdc": "0.01",
        "stx_usd_rate": "0.341964"
      },
      "payTo": "SP23XKWSEQ9D4CVPT0H39N2TYVEE5AJECPKW6CZ3C",
      "amount": "29243",
      "scheme": "exact",
      "network": "stacks:1",
      "maxTimeoutSeconds": 119
    }
  ],
  "resource": {
    "url": "https://agentpay.tools/v1/session/create",
    "tags": [
      "budget",
      "receipts",
      "session",
      "spend-control",
      "agent-commerce"
    ],
    "mimeType": "application/json",
    "description": "A stateful, multi-chain spending session for AI agents. One session enforces a hard USDC budget cap across every tool call, with a verifiable receipt and running ledger for each payment — not a one-shot budget check, but persistent spend governance with a full audit trail. The gateway enforces the cap for the paying wallet on Stacks and Base. USDC on Base (standard x402) or Stellar (via the AgentPay SDK); sBTC on Stacks (any Stacks x402 client).",
    "serviceName": "AgentPay Spend Cap & Receipts"
  },
  "extensions": {
    "bazaar": {
      "info": {
        "input": {
          "body": {
            "label": "session",
            "max_spend": "0.10",
            "agent_address": "0x0000000000000000000000000000000000000000"
          },
          "type": "http",
          "method": "POST",
          "bodyType": "json"
        },
        "errors": [
          {
            "body": {
              "error": "<summary>",
              "reason": "<machine-readable reason>"
            },
            "when": "No payment attached (this challenge), or the attached payment failed verification: wrong amount/recipient, memo mismatch, expired, or already used (replay)",
            "retry": "Re-request the challenge and pay again",
            "status": 402
          },
          {
            "body": {
              "detail": [
                {
                  "loc": [
                    "body"
                  ],
                  "msg": "<what is wrong>",
                  "type": "<error type>"
                }
              ]
            },
            "when": "Request body present but malformed (invalid JSON or wrong field types) WITH a payment header attached — checked BEFORE settlement, so the payment is never consumed. An unpaid malformed request gets the 402, not a 422",
            "retry": "Fix the body and retry with a fresh payment",
            "status": 422
          },
          {
            "body": {
              "detail": "Tool '<name>' not found"
            },
            "when": "Unknown tool name",
            "status": 404
          },
          {
            "body": {
              "error": "Rate limit exceeded"
            },
            "when": "Rate limited (per-IP and per-wallet limits)",
            "retry": "Back off and retry after a minute",
            "status": 429
          },
          {
            "body": {
              "tool": "<name>",
              "error": "Tool execution failed",
              "payment_status": "refund_pending"
            },
            "when": "Payment settled on-chain but tool execution failed — the payment is marked refund_pending automatically; you are not charged for a failed call",
            "status": 500
          },
          {
            "body": {
              "detail": "<what is unavailable>"
            },
            "when": "Tool temporarily unavailable, or the gateway cannot persist the challenge (fail-closed)",
            "retry": "Retry shortly",
            "status": 503
          }
        ],
        "output": {
          "type": "json",
          "example": {
            "receipt": {
              "network": "eip155:8453",
              "tx_hash": "0xee85d8dd374b5d1cb40bfa441086af557d356acc2bb4d5819f56331fce42adee",
              "amount_usdc": "0.01"
            },
            "max_spend": "0.10",
            "created_at": "2026-05-29T00:00:00Z",
            "session_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
            "gateway_url": "https://agentpay.tools",
            "tools_endpoint": "https://agentpay.tools/tools"
          }
        }
      },
      "schema": {
        "type": "object",
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "properties": {
          "input": {
            "type": "object",
            "required": [
              "type",
              "method",
              "body"
            ],
            "properties": {
              "body": {
                "type": "object",
                "required": [
                  "agent_address"
                ],
                "properties": {
                  "label": {
                    "type": "string",
                    "description": "Optional human-readable session label"
                  },
                  "max_spend": {
                    "type": "string",
                    "description": "Hard budget cap in USDC, e.g. '0.10'"
                  },
                  "agent_address": {
                    "type": "string",
                    "description": "Paying agent's EVM wallet address"
                  }
                }
              },
              "type": {
                "type": "string"
              },
              "method": {
                "type": "string"
              },
              "bodyType": {
                "type": "string"
              }
            }
          }
        }
      },
      "description": "A stateful, multi-chain spending session for AI agents: a hard USDC budget cap across every tool call, with a verifiable receipt and running ledger per payment. Not a one-shot budget check — persistent spend governance with a full audit trail. The gateway enforces the cap for the paying wallet on Stacks and Base. USDC on Base (standard x402) or Stellar (via the AgentPay SDK); sBTC on Stacks (any Stacks x402 client)."
    }
  },
  "x402Version": 2
}

{
  "error": "Payment required",
  "accepts": [
    {
      "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "extra": {
        "name": "USD Coin",
        "version": "2",
        "assetTransferMethod": "eip3009"
      },
      "payTo": "0xE8B25A72dD6aeF69515452a61AD231C7DF2843b7",
      "amount": "10000",
      "scheme": "exact",
      "network": "eip155:8453",
      "mimeType": "application/json",
      "resource": "https://agentpay.tools/tools/verified_route/call",
      "description": "Paid buyer-side trust oracle: 'I need X, budget $Y — which x402 tool is real?' Sweeps the WHOLE x402 marketplace across many queries (a single search shows only a slice), collapses sybil/factory clusters (one wallet stamping many fake-distinct listings → one entry), ranks the genuinely-used survivors by real unique-payer usage, and returns ONE vetted recommendation with a ready-to-pay x402 challenge. The credit-bureau check an agent cannot do itself in one query — pay $0.01 to avoid paying a scam or a dead stub.",
      "outputSchema": {
        "input": {
          "type": "object",
          "required": [
            "need"
          ],
          "properties": {
            "need": {
              "type": "string",
              "description": "What the agent needs, e.g. 'dex pair liquidity', 'crypto prices'"
            },
            "chain": {
              "type": "string",
              "default": "",
              "description": "Optional chain filter: 'base', 'arbitrum', 'arbitrum-stack'. Empty = all chains."
            },
            "budget_usd": {
              "type": "number",
              "default": 1,
              "description": "Max USDC the agent will pay the downstream tool per call"
            }
          }
        },
        "errors": [
          {
            "body": {
              "error": "<summary>",
              "reason": "<machine-readable reason>"
            },
            "when": "No payment attached (this challenge), or the attached payment failed verification: wrong amount/recipient, memo mismatch, expired, or already used (replay)",
            "retry": "Re-request the challenge and pay again",
            "status": 402
          },
          {
            "body": {
              "detail": [
                {
                  "loc": [
                    "body"
                  ],
                  "msg": "<what is wrong>",
                  "type": "<error type>"
                }
              ]
            },
            "when": "Request body present but malformed (invalid JSON or wrong field types) WITH a payment header attached — checked BEFORE settlement, so the payment is never consumed. An unpaid malformed request gets the 402, not a 422",
            "retry": "Fix the body and retry with a fresh payment",
            "status": 422
          },
          {
            "body": {
              "detail": "Tool '<name>' not found"
            },
            "when": "Unknown tool name",
            "status": 404
          },
          {
            "body": {
              "error": "Rate limit exceeded"
            },
            "when": "Rate limited (per-IP and per-wallet limits)",
            "retry": "Back off and retry after a minute",
            "status": 429
          },
          {
            "body": {
              "tool": "<name>",
              "error": "Tool execution failed",
              "payment_status": "refund_pending"
            },
            "when": "Payment settled on-chain but tool execution failed — the payment is marked refund_pending automatically; you are not charged for a failed call",
            "status": 500
          },
          {
            "body": {
              "detail": "<what is unavailable>"
            },
            "when": "Tool temporarily unavailable, or the gateway cannot persist the challenge (fail-closed)",
            "retry": "Retry shortly",
            "status": 503
          }
        ],
        "output": {
          "need": "dex pair liquidity",
          "chain": null,
          "catalog": {
            "scanned": 117,
            "after_vetting": 114,
            "real_providers": 41,
            "unique_wallets": 38,
            "biggest_factory": {
              "pay_to": "0x2bb72231eed3",
              "listings": 72
            },
            "sybil_collapsed": 73
          },
          "vetting": "swept 17 queries → 117 listings → collapsed 73 sybil listings → 41 real providers",
          "survivors": [],
          "budget_usd": "1",
          "recommendation": {
            "url": "https://otto.example/dex",
            "name": "Otto AI",
            "flags": [],
            "pay_to": "0x0e84ddedaae6a7",
            "network": "eip155:8453",
            "quality": 3851,
            "calls30d": 3246,
            "evidence": [
              {
                "n": 12,
                "ref": "/s/otto-example-dex-1a2b3c",
                "type": "delivery",
                "value": 1,
                "metric": "delivery_rate",
                "source": "agentpay-prober",
                "observed_at": "2026-09-30T13:05:00Z"
              },
              {
                "ref": null,
                "type": "third-party",
                "value": 200,
                "metric": "unique_payers_30d",
                "source": "coinbase-bazaar",
                "observed_at": "2026-10-01T12:00:00Z"
              }
            ],
            "payers30d": 200,
            "price_usd": "0.001",
            "ready_to_pay": {
              "url": "https://otto.example/dex",
              "accepts": {
                "scheme": "exact",
                "network": "eip155:8453"
              },
              "network": "eip155:8453",
              "price_usd": "0.001"
            }
          }
        }
      },
      "maxTimeoutSeconds": 300
    },
    {
      "asset": "SM3VDXK3WZZSA84XXFKAFAF15NNZX32CTSG82JFQ4.sbtc-token",
      "extra": {
        "tokenType": "sBTC",
        "payment_id": "be1d6727-5090-4ff5-81b8-fac10b75cf27",
        "amount_usdc": "0.01",
        "btc_usd_rate": "81646"
      },
      "payTo": "SP23XKWSEQ9D4CVPT0H39N2TYVEE5AJECPKW6CZ3C",
      "amount": "13",
      "scheme": "exact",
      "network": "stacks:1",
      "maxTimeoutSeconds": 119
    },
    {
      "asset": "STX",
      "extra": {
        "tokenType": "STX",
        "payment_id": "be1d6727-5090-4ff5-81b8-fac10b75cf27",
        "amount_usdc": "0.01",
        "stx_usd_rate": "0.341964"
      },
      "payTo": "SP23XKWSEQ9D4CVPT0H39N2TYVEE5AJECPKW6CZ3C",
      "amount": "29243",
      "scheme": "exact",
      "network": "stacks:1",
      "maxTimeoutSeconds": 119
    }
  ],
  "resource": {
    "url": "https://agentpay.tools/tools/verified_route/call",
    "tags": [
      "routing",
      "discovery",
      "trust",
      "trust-oracle",
      "sybil-detection"
    ],
    "mimeType": "application/json",
    "description": "Buyer-side trust oracle for the x402 marketplace: 'I need X, budget $Y — which tool is real?' Sweeps the WHOLE catalog across many queries, collapses sybil/factory clusters (one wallet stamping many fake-distinct listings), ranks the genuinely-used survivors by unique-payer usage, and returns one vetted pick with a ready-to-pay challenge. The credit-bureau check an agent can't do in a single query.",
    "serviceName": "AgentPay x402 Trust Oracle"
  },
  "extensions": {
    "bazaar": {
      "info": {
        "input": {
          "body": {
            "parameters": {
              "need": "dex pair liquidity",
              "chain": "",
              "budget_usd": 1
            }
          },
          "type": "http",
          "method": "POST",
          "bodyType": "json"
        },
        "errors": [
          {
            "body": {
              "error": "<summary>",
              "reason": "<machine-readable reason>"
            },
            "when": "No payment attached (this challenge), or the attached payment failed verification: wrong amount/recipient, memo mismatch, expired, or already used (replay)",
            "retry": "Re-request the challenge and pay again",
            "status": 402
          },
          {
            "body": {
              "detail": [
                {
                  "loc": [
                    "body"
                  ],
                  "msg": "<what is wrong>",
                  "type": "<error type>"
                }
              ]
            },
            "when": "Request body present but malformed (invalid JSON or wrong field types) WITH a payment header attached — checked BEFORE settlement, so the payment is never consumed. An unpaid malformed request gets the 402, not a 422",
            "retry": "Fix the body and retry with a fresh payment",
            "status": 422
          },
          {
            "body": {
              "detail": "Tool '<name>' not found"
            },
            "when": "Unknown tool name",
            "status": 404
          },
          {
            "body": {
              "error": "Rate limit exceeded"
            },
            "when": "Rate limited (per-IP and per-wallet limits)",
            "retry": "Back off and retry after a minute",
            "status": 429
          },
          {
            "body": {
              "tool": "<name>",
              "error": "Tool execution failed",
              "payment_status": "refund_pending"
            },
            "when": "Payment settled on-chain but tool execution failed — the payment is marked refund_pending automatically; you are not charged for a failed call",
            "status": 500
          },
          {
            "body": {
              "detail": "<what is unavailable>"
            },
            "when": "Tool temporarily unavailable, or the gateway cannot persist the challenge (fail-closed)",
            "retry": "Retry shortly",
            "status": 503
          }
        ],
        "output": {
          "type": "json",
          "example": {
            "need": "dex pair liquidity",
            "catalog": {
              "scanned": 117,
              "real_providers": 41,
              "biggest_factory": {
                "pay_to": "0x2bb72231eed3",
                "listings": 72
              },
              "sybil_collapsed": 73
            },
            "vetting": "swept 17 queries → 117 listings → collapsed 73 sybil listings → 41 real providers",
            "recommendation": {
              "url": "https://otto.example/dex",
              "name": "Otto AI",
              "network": "eip155:8453",
              "quality": 3851,
              "calls30d": 3246,
              "payers30d": 200,
              "price_usd": "0.001",
              "ready_to_pay": {
                "url": "https://otto.example/dex",
                "accepts": {
                  "scheme": "exact",
                  "network": "eip155:8453"
                },
                "network": "eip155:8453"
              }
            }
          }
        }
      },
      "schema": {
        "type": "object",
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "required": [
          "input"
        ],
        "properties": {
          "input": {
            "type": "object",
            "required": [
              "type",
              "bodyType",
              "body",
              "method"
            ],
            "properties": {
              "body": {
                "type": "object",
                "properties": {
                  "parameters": {
                    "type": "object",
                    "required": [
                      "need"
                    ],
                    "properties": {
                      "need": {
                        "type": "string",
                        "description": "What the agent needs, e.g. 'dex pair liquidity', 'crypto prices'"
                      },
                      "chain": {
                        "type": "string",
                        "description": "Optional chain filter: 'base', 'arbitrum', 'solana'. Empty = all chains. Solana picks are discovery-only (probe coverage: Base only — on-chain delivery unverified)"
                      },
                      "budget_usd": {
                        "type": "number",
                        "description": "Max USDC to pay the downstream tool per call (default 1)"
                      }
                    }
                  }
                }
              },
              "type": {
                "type": "string",
                "const": "http"
              },
              "method": {
                "enum": [
                  "POST"
                ],
                "type": "string"
              },
              "bodyType": {
                "enum": [
                  "json",
                  "form-data",
                  "text"
                ],
                "type": "string"
              }
            },
            "additionalProperties": false
          },
          "output": {
            "type": "object",
            "required": [
              "type"
            ],
            "properties": {
              "type": {
                "type": "string"
              },
              "example": {
                "type": "object"
              }
            }
          }
        }
      },
      "description": "Vet before you pay a stranger: sweep the x402 catalog, collapse sybil/factory listings, rank real providers by usage, and return ONE recommendation under budget with a ready-to-pay x402 challenge + a catalog dossier (scanned / real_providers / sybil_collapsed / biggest_factory)."
    }
  },
  "x402Version": 2
}