{"uid":"cap_l6-0iRAdXKEZk6wxfvVeS","slug":"agent-budget-guard-record-transaction-c6035c35","name":"Agent Budget Guard - Record Transaction","description":"Pay-per-request governance APIs for AI agents using x402. Check budgets, log payments, classify invoices, and generate audit-ready spending records. Built for autonomous agents, USDC/Base payments, and JPY/JPYC reporting workflows.","url":"https://agent-budget-guard.onrender.com/api/budget/record","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"amount":{"type":"string","description":"Requested payment amount in USDC"},"api_url":{"type":"string","description":"Target API URL"},"agent_id":{"type":"string","description":"AI agent identifier"},"currency":{"type":"string","description":"Currency: USD, USDC, JPYC, JPY"},"target_api":{"type":"string","description":"Target API URL (alias for api_url)"},"action_type":{"type":"string","description":"Action type"},"daily_limit":{"type":"string","description":"Daily spend limit in USDC"},"requested_amount":{"type":"string","description":"Requested payment amount (alias for amount)"}}},"responseSchema":{"type":"object","title":"RecordTransactionResponse","required":["recorded","total_today","total_this_month","next_recommended"],"properties":{"recorded":{"type":"boolean","title":"Recorded"},"total_today":{"type":"number","title":"Total Today"},"next_recommended":{"type":"object","title":"NextRecommendation","required":["api_name","url","reason","expected_improvement","price_usdc"],"properties":{"url":{"type":"string","title":"Url"},"reason":{"type":"string","title":"Reason"},"api_name":{"type":"string","title":"Api Name"},"price_usdc":{"type":"number","title":"Price Usdc"},"expected_improvement":{"type":"string","title":"Expected Improvement"}}},"total_this_month":{"type":"number","title":"Total This Month"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_iKMviiftgxL7Wlr6SQdu1","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Records a payment transaction for an AI agent and returns cumulative daily/monthly spend totals plus a next-action recommendation.","exampleAgentPrompt":"Record a $0.01 USDC payment that agent 'agent-007' just made to https://some-api.example.com for a 'data-lookup' action, with a daily limit of $1.00 USDC, and tell me the total spent today and this month.","exampleUseCases":null,"resultDescription":"Returns a boolean confirming the transaction was recorded, the agent's running total spend for today and this month in USDC, and a recommended next API call with name, URL, rationale, expected improvement, and price in USDC.","failureModes":["Missing required fields (agent_id, amount, api_url) returns 422 validation error","Invalid currency value returns 400 bad request","Service unavailable on Render cold start returns 503 or timeout","Malformed USDC amount string causes parsing failure","Daily limit field ignored if not provided, no enforcement error returned"],"whenToPreferThis":"Use this endpoint after each pay-per-request API call to maintain a running audit log of agent spending. Ideal when your agent operates on USDC/Base via x402 and needs cumulative daily/monthly totals for governance, budget enforcement, or JPY/JPYC compliance reporting. Prefer this over generic logging when you also want AI-driven next-action recommendations.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:36:17.259Z","isFirstParty":false}