Skip to main content

​
create_order

Purchase a VPS or blockchain node product using USDC on Base. Handles the x402 payment flow automatically. Returns order details with ID and status.

​
Parameters

NameTypeRequiredDescription
productIdstringYesProduct ID to purchase
periodnumberYesSubscription period in months
quantitynumberNoNumber of instances to purchase (default: 1)
customNamestringNoCustom name for the instance (max 100 characters)

​
Example Usage

Purchase 3 months of product abc123

Buy 1 month of VPS-XS with the name "my-server"

​
Example Response

## Order Created Successfully

**Order ID:** order_xyz789
**Status:** completed
**User:** 0x1234...abcd
**Created:** 2025-01-15T10:30:00.000Z

### Products:
- Product: abc123
  Period: 3 month(s)
  Quantity: 1

### Instance:
- ID: inst_456
- Type: vps
- Status: provisioning

> Use `get_order` with order ID to check provisioning status and get instance details.