{
  "x402Version": 2,
  "id": 26453,
  "slug": "26453",
  "resource": "https://agentpay.tools/v1/session/create",
  "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).",
  "type": "http",
  "serviceName": "AgentPay Spend Cap & Receipts",
  "resourceType": "Payments",
  "accepts": [
    {
      "scheme": "exact",
      "network": "eip155:8453",
      "payTo": "0xE8B25A72dD6aeF69515452a61AD231C7DF2843b7",
      "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "amount": "10000",
      "amountUsd": 0.01,
      "maxTimeoutSeconds": 300
    }
  ],
  "outputSchema": {
    "example": {
      "created_at": "2026-05-29T00:00:00Z",
      "gateway_url": "https://agentpay.tools",
      "max_spend": "0.10",
      "receipt": {
        "amount_usdc": "0.01",
        "network": "eip155:8453",
        "tx_hash": "0xee85d8dd374b5d1cb40bfa441086af557d356acc2bb4d5819f56331fce42adee"
      },
      "session_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
      "tools_endpoint": "https://agentpay.tools/tools"
    },
    "type": "json"
  },
  "extensions": {
    "bazaar": {
      "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).",
      "info": {
        "errors": [
          {
            "body": {
              "error": "<summary>",
              "reason": "<machine-readable reason>"
            },
            "retry": "Re-request the challenge and pay again",
            "status": 402,
            "when": "No payment attached (this challenge), or the attached payment failed verification: wrong amount/recipient, memo mismatch, expired, or already used (replay)"
          },
          {
            "body": {
              "detail": [
                {
                  "loc": [
                    "body"
                  ],
                  "msg": "<what is wrong>",
                  "type": "<error type>"
                }
              ]
            },
            "retry": "Fix the body and retry with a fresh payment",
            "status": 422,
            "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"
          },
          {
            "body": {
              "detail": "Tool '<name>' not found"
            },
            "status": 404,
            "when": "Unknown tool name"
          },
          {
            "body": {
              "error": "Rate limit exceeded"
            },
            "retry": "Back off and retry after a minute",
            "status": 429,
            "when": "Rate limited (per-IP and per-wallet limits)"
          },
          {
            "body": {
              "error": "Tool execution failed",
              "payment_status": "refund_pending",
              "tool": "<name>"
            },
            "status": 500,
            "when": "Payment settled on-chain but tool execution failed — the payment is marked refund_pending automatically; you are not charged for a failed call"
          },
          {
            "body": {
              "detail": "<what is unavailable>"
            },
            "retry": "Retry shortly",
            "status": 503,
            "when": "Tool temporarily unavailable, or the gateway cannot persist the challenge (fail-closed)"
          }
        ],
        "input": {
          "body": {
            "agent_address": "0x0000000000000000000000000000000000000000",
            "label": "session",
            "max_spend": "0.10"
          },
          "bodyType": "json",
          "method": "POST",
          "type": "http"
        },
        "output": {
          "example": {
            "created_at": "2026-05-29T00:00:00Z",
            "gateway_url": "https://agentpay.tools",
            "max_spend": "0.10",
            "receipt": {
              "amount_usdc": "0.01",
              "network": "eip155:8453",
              "tx_hash": "0xee85d8dd374b5d1cb40bfa441086af557d356acc2bb4d5819f56331fce42adee"
            },
            "session_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
            "tools_endpoint": "https://agentpay.tools/tools"
          },
          "type": "json"
        }
      },
      "schema": {
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "properties": {
          "input": {
            "properties": {
              "body": {
                "properties": {
                  "agent_address": {
                    "description": "Paying agent's EVM wallet address",
                    "type": "string"
                  },
                  "label": {
                    "description": "Optional human-readable session label",
                    "type": "string"
                  },
                  "max_spend": {
                    "description": "Hard budget cap in USDC, e.g. '0.10'",
                    "type": "string"
                  }
                },
                "required": [
                  "agent_address"
                ],
                "type": "object"
              },
              "bodyType": {
                "type": "string"
              },
              "method": {
                "type": "string"
              },
              "type": {
                "type": "string"
              }
            },
            "required": [
              "type",
              "method",
              "body"
            ],
            "type": "object"
          }
        },
        "type": "object"
      }
    }
  },
  "tags": [
    "budget",
    "receipts",
    "session",
    "spend-control",
    "agent-commerce",
    "bazaar"
  ],
  "sourceHost": "agentpay.tools",
  "lastUpdated": "2026-10-08T05:32:13.652Z",
  "quality": {
    "calls30d": 2,
    "uniquePayers30d": 2,
    "lastCalledAt": "2026-10-08T05:32:13.258Z"
  },
  "metadata": {
    "serviceName": "AgentPay Spend Cap & Receipts",
    "extensions": {
      "bazaar": {
        "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).",
        "info": {
          "errors": [
            {
              "body": {
                "error": "<summary>",
                "reason": "<machine-readable reason>"
              },
              "retry": "Re-request the challenge and pay again",
              "status": 402,
              "when": "No payment attached (this challenge), or the attached payment failed verification: wrong amount/recipient, memo mismatch, expired, or already used (replay)"
            },
            {
              "body": {
                "detail": [
                  {
                    "loc": [
                      "body"
                    ],
                    "msg": "<what is wrong>",
                    "type": "<error type>"
                  }
                ]
              },
              "retry": "Fix the body and retry with a fresh payment",
              "status": 422,
              "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"
            },
            {
              "body": {
                "detail": "Tool '<name>' not found"
              },
              "status": 404,
              "when": "Unknown tool name"
            },
            {
              "body": {
                "error": "Rate limit exceeded"
              },
              "retry": "Back off and retry after a minute",
              "status": 429,
              "when": "Rate limited (per-IP and per-wallet limits)"
            },
            {
              "body": {
                "error": "Tool execution failed",
                "payment_status": "refund_pending",
                "tool": "<name>"
              },
              "status": 500,
              "when": "Payment settled on-chain but tool execution failed — the payment is marked refund_pending automatically; you are not charged for a failed call"
            },
            {
              "body": {
                "detail": "<what is unavailable>"
              },
              "retry": "Retry shortly",
              "status": 503,
              "when": "Tool temporarily unavailable, or the gateway cannot persist the challenge (fail-closed)"
            }
          ],
          "input": {
            "body": {
              "agent_address": "0x0000000000000000000000000000000000000000",
              "label": "session",
              "max_spend": "0.10"
            },
            "bodyType": "json",
            "method": "POST",
            "type": "http"
          },
          "output": {
            "example": {
              "created_at": "2026-05-29T00:00:00Z",
              "gateway_url": "https://agentpay.tools",
              "max_spend": "0.10",
              "receipt": {
                "amount_usdc": "0.01",
                "network": "eip155:8453",
                "tx_hash": "0xee85d8dd374b5d1cb40bfa441086af557d356acc2bb4d5819f56331fce42adee"
              },
              "session_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
              "tools_endpoint": "https://agentpay.tools/tools"
            },
            "type": "json"
          }
        },
        "schema": {
          "$schema": "https://json-schema.org/draft/2020-12/schema",
          "properties": {
            "input": {
              "properties": {
                "body": {
                  "properties": {
                    "agent_address": {
                      "description": "Paying agent's EVM wallet address",
                      "type": "string"
                    },
                    "label": {
                      "description": "Optional human-readable session label",
                      "type": "string"
                    },
                    "max_spend": {
                      "description": "Hard budget cap in USDC, e.g. '0.10'",
                      "type": "string"
                    }
                  },
                  "required": [
                    "agent_address"
                  ],
                  "type": "object"
                },
                "bodyType": {
                  "type": "string"
                },
                "method": {
                  "type": "string"
                },
                "type": {
                  "type": "string"
                }
              },
              "required": [
                "type",
                "method",
                "body"
              ],
              "type": "object"
            }
          },
          "type": "object"
        }
      }
    }
  },
  "liveness": {
    "reliability": null
  },
  "verified": false,
  "featured": false,
  "provider": {
    "host": "agentpay.tools",
    "manifest_name": "agentpay.tools",
    "source": "cdp-mirror",
    "source_manifest_url": "https://api.cdp.coinbase.com/platform/v2/x402/discovery/resources",
    "submitted_at": "2026-10-14T01:15:01.050Z"
  },
  "exampleResponse": {
    "created_at": "2026-05-29T00:00:00Z",
    "gateway_url": "https://agentpay.tools",
    "max_spend": "0.10",
    "receipt": {
      "amount_usdc": "0.01",
      "network": "eip155:8453",
      "tx_hash": "0xee85d8dd374b5d1cb40bfa441086af557d356acc2bb4d5819f56331fce42adee"
    },
    "session_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
    "tools_endpoint": "https://agentpay.tools/tools"
  }
}