{"uid":"cap_uH-GWNWR5BNS7FYMTATa1","slug":"singularity-servers-vps-provisioning-541f6a3d","name":"Singularity Servers VPS Provisioning","description":"On-demand Persistent Linux VPS paid per order in USDC on Base over x402.","url":"https://singularityservers.com/api/x402/order?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"cpu":{"type":"integer","minimum":1,"description":"vCPUs."},"ram":{"type":"integer","minimum":1,"description":"RAM in GB."},"days":{"type":"integer","maximum":30,"minimum":1},"disk":{"type":"integer","minimum":1,"description":"Disk in GB."},"preset":{"type":"string","description":"Preset name (agent_micro, agent_standard, agent_heavy, power_node)."},"ssh_public_key":{"type":"string","description":"SSH public key installed for root on the new server."}}},"responseSchema":{"type":"json","example":{"status":"completed","order_id":1,"instance_ipv6":"2001:db8::1","payment_method":"usdc"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.07","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","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.07/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.07","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.07","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_zfwrEblBA7p1376G3O1Ts","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.07","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Provisions a persistent Linux VPS with configurable CPU, RAM, disk, and SSH access via a single paid API call","exampleAgentPrompt":"Spin up a Singularity Servers Linux VPS using the agent_standard preset for 7 days with 2 vCPUs and 4GB RAM, and install my SSH public key ssh-ed25519 AAAA...mykey so I can log in as root.","exampleUseCases":[{"title":"Temporary agent compute environment","prompt":"Provision a Singularity Servers VPS with the agent_micro preset, 1 vCPU, 1GB RAM, 10GB disk for 3 days, and install this SSH key so my automation agent can use it: ssh-ed25519 AAAA...agentkey"},{"title":"Short-term data processing server","prompt":"I need a Linux server for 14 days with 4 vCPUs, 16GB RAM, and 100GB disk on Singularity Servers — use the power_node preset and add my public key ssh-rsa AAAA...workkey so I can SSH in."},{"title":"Persistent AI agent hosting node","prompt":"Set up a Singularity Servers VPS using the agent_heavy preset for 30 days with 8 vCPUs, 32GB RAM, and 200GB storage, and install this SSH public key for root access: ssh-ed25519 AAAA...heavykey"}],"resultDescription":"Returns a JSON object with the order status (e.g. 'completed'), a unique order ID, the IPv6 address of the provisioned instance, and the payment method used (USDC). The agent can immediately use the returned IPv6 address to SSH into the new Linux VPS.","failureModes":["Insufficient payment or payment failure — server not provisioned, order rejected","Invalid or missing SSH public key format — provisioning may fail or key not installed","Requested resource values (CPU/RAM/disk) below minimums or days exceeding 30-day maximum","Invalid preset name — unknown preset returns error","Network or provisioning timeout — order may be in pending state with no IP returned","Payment processed but instance not reachable at returned IPv6 address"],"whenToPreferThis":"Choose this endpoint when you need a real, persistent Linux VPS that survives beyond a single request — ideal for agents that need a persistent compute environment, need to run long-running processes, or require SSH access to a remote host. Prefer this over ephemeral function execution or container-as-a-service when you need root access, custom disk size, or multi-day uptime. The preset options (agent_micro, agent_standard, agent_heavy, power_node) make it easy to match resource allocation to workload without manual tuning. Payment is handled via USDC x402 micropayment, making it suitable for autonomous agent workflows.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-28T06:32:55.852Z","isFirstParty":false,"canonicalSlug":"singularity-servers-vps-provisioning-541f6a3d"}