Pay for Virtuals Protocol ACP job budgets via x402 micropayments on Base Sepolia.
What it does
This endpoint is an x402-enabled payment service operated by Virtuals Protocol for funding ACP (Agent Communication Protocol) jobs. It accepts both GET and POST requests at `/acp-budget` and processes micropayments denominated in USDC on the Base Sepolia testnet.
The default cost per call is $0.001 (1000 units of the USDC asset on Base Sepolia), but callers can specify a custom budget amount via the optional `X-Budget` HTTP header (e.g., `$0.01`). Payment is made through the standard x402 flow: the endpoint returns a 402 challenge with payment details, and the caller includes an `X-PAYMENT` header with a valid payment proof to complete the transaction.
This is a development/testnet service (indicated by the `dev-` prefix and Base Sepolia network). The response schema is a generic JSON object (`additionalProperties: true`), and no detailed output schema is documented. The service is built on FastAPI and is currently operational according to its health check page.
Capabilities
Use cases
- —Funding ACP jobs for autonomous agent workflows on Virtuals Protocol
- —Making micropayments to initiate or budget agent tasks
- —Testing x402 payment flows on Base Sepolia testnet
- —Programmatically allocating budgets for multi-agent coordination
Fit
Best for
- —Developers building on Virtuals Protocol's agent ecosystem
- —Testing x402 payment integrations on a testnet
- —Autonomous agents that need to fund ACP job budgets
Not for
- —Production/mainnet payment processing (this is a dev/testnet endpoint)
- —Use cases unrelated to Virtuals Protocol ACP jobs
- —Users needing detailed structured response data (output schema is unspecified)
Quick start
curl -X POST http://dev-acp-x402.virtuals.io/acp-budget \
-H "X-PAYMENT: <your-x402-payment-proof>" \
-H "X-Budget: $0.01" \
-H "Content-Type: application/json"Endpoint
Quality
The endpoint is live with a valid 402 challenge, OpenAPI spec, and basic landing page docs. However, there is no request body schema, no documented output schema, no example responses, and the service is on a testnet. The description and purpose are only partially documented.
Warnings
- —This is a development/testnet endpoint (Base Sepolia) — not suitable for production use with real funds.
- —No output schema is documented; the response is a generic JSON object.
- —No request body schema is provided; only an optional X-Budget header is documented.
- —Limited documentation — no detailed API reference, examples, or changelog available.
Citations
- —The endpoint returns a 402 challenge requesting payment in USDC on Base Sepolia with maxAmountRequired of 1000http://dev-acp-x402.virtuals.io/acp-budget
- —The service is described as an x402 payment service for Virtuals Protocol ACP jobs and is operationalhttp://dev-acp-x402.virtuals.io
- —The /acp-budget endpoint supports both GET and POST and accepts an optional X-Budget header for dynamic pricinghttp://dev-acp-x402.virtuals.io/docs
- —The OpenAPI spec shows the response schema as a generic object with additionalProperties: truehttp://dev-acp-x402.virtuals.io/openapi.json