{"api":"v1","generated_at":"2026-09-15T18:48:39.048Z","licence":{"name":"CC BY 4.0","url":"https://creativecommons.org/licenses/by/4.0/","attribution":"TOLL, with a link to the page cited"},"page":"https://tollindex.com/e/agentpay-tools-v1-session-create-3682d5","pinned_page":"https://tollindex.com/e/agentpay-tools-v1-session-create-3682d5/at/2026-09-15T16-57Z","pinned":false,"method":"https://tollindex.com/ledger/method","snapshot_at":"2026-09-15T16:57:44.360Z","snapshot_stamp":"2026-09-15T16-57Z","endpoint":{"slug":"agentpay-tools-v1-session-create-3682d5","canonical_url":"https://agentpay.tools/v1/session/create","resource":"https://agentpay.tools/v1/session/create","http_method":"POST","type":"http","x402_version":2,"registries":["cdp"],"primary_registry":"cdp","curated_by_coinbase":false,"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. USDC on Base (standard x402) or Stellar (via the AgentPay SDK).","service_name":"AgentPay Spend Cap & Receipts","declared_category":null,"declared_tags":["budget","receipts","session","spend-control","agent-commerce"],"route_template":null,"registry_updated":"2026-09-04T07:01:48.682Z"},"derived":{"note":"fields no registry supplies; TOLL derives them and marks them derived on the page","title":"session create","category":"market-data","first_observed_by_toll":"2026-09-10T19:08:24.178Z","last_observed_by_toll":"2026-09-15T16:57:44.360Z","observation_began":"2026-09-10"},"presence":{"listed_now":true,"first_absent_at":null,"delisting_confirmed_at":null,"events":[{"registry":"cdp","at":"2026-09-10T19:08:24.178Z","event":"listed"}]},"accepts":[{"registry":"cdp","ordinal":0,"network":"eip155:8453","asset":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913","asset_name":"USD Coin","symbol":"USDC","decimals":6,"amount_display":"0.01 USDC","amount_units":0.01,"decimals_known":true,"pay_to":"0xE8B25A72dD6aeF69515452a61AD231C7DF2843b7","scheme":"exact"}],"counters":{"observed_at":"2026-09-15T16:57:44.360Z","calls_30d":2,"unique_payers_30d":2,"last_called_at":"2026-09-04T07:01:48.212Z"},"validation":{"latest":{"observed_at":"2026-09-15T04:25:48.957Z","state":"pass","failed_checks":[],"endpoint_http_status":402,"run_id":"daily-2026-09-15"},"uptime":[{"days":7,"observed":5,"passed":5,"ratio":1},{"days":30,"observed":5,"passed":5,"ratio":1},{"days":90,"observed":5,"passed":5,"ratio":1}],"history_90d":[{"observed_at":"2026-09-15T04:25:48.957Z","state":"pass","failed_checks":[],"run_id":"daily-2026-09-15","state_changed":false},{"observed_at":"2026-09-14T04:22:30.547Z","state":"pass","failed_checks":[],"run_id":"daily-2026-09-14","state_changed":false},{"observed_at":"2026-09-13T04:21:22.170Z","state":"pass","failed_checks":[],"run_id":"daily-2026-09-13","state_changed":false},{"observed_at":"2026-09-12T06:37:00.304Z","state":"pass","failed_checks":[],"run_id":"daily-2026-09-12","state_changed":false},{"observed_at":"2026-09-11T10:07:29.200Z","state":"pass","failed_checks":[],"run_id":"daily-2026-09-11","state_changed":true}]},"seller":{"wallet":"0xE8B25A72dD6aeF69515452a61AD231C7DF2843b7","page":"https://tollindex.com/seller/0xE8B25A72dD6aeF69515452a61AD231C7DF2843b7","endpoints":3,"hosts":1},"reports":0,"registry_record":{"cdp":[{"tags":["budget","receipts","session","spend-control","agent-commerce"],"type":"http","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/v1/session/create","description":"AgentPay tool call","outputSchema":{"input":{"type":"object","properties":{"label":{"type":"string","description":"Optional session label"},"max_spend":{"type":"string","description":"Budget cap in USDC, e.g. '0.10'"},"agent_address":{"type":"string","description":"Paying agent's wallet address"}}},"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":502},{"body":{"detail":"<what is unavailable>"},"when":"Tool temporarily unavailable, or the gateway cannot persist the challenge (fail-closed)","retry":"Retry shortly","status":503}],"output":{"receipt":{"network":"base","tx_hash":"0x...","amount_usdc":"0.01"},"max_spend":"0.10","created_at":"2026-05-27T00:00:00Z","session_id":"uuid","gateway_url":"https://agentpay.tools","agent_address":"G...","tools_endpoint":"https://agentpay.tools/tools"}},"maxTimeoutSeconds":300}],"quality":{"lastCalledAt":"2026-09-04T07:01:48.212Z","l30DaysTotalCalls":2,"l30DaysUniquePayers":2},"resource":"https://agentpay.tools/v1/session/create","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":502},{"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. USDC on Base (standard x402) or Stellar (via the AgentPay SDK)."}},"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. USDC on Base (standard x402) or Stellar (via the AgentPay SDK).","lastUpdated":"2026-09-04T07:01:48.682Z","serviceName":"AgentPay Spend Cap & Receipts","x402Version":2}]}}