Smol Machines

Active

by Orthogonal

Cloud microVMs for running code and commands.

Infrastructure

Endpoints · 15

Base URLhttps://x402.orthogonal.com/smolmachines
POST/v1/machinesNot publishedCreate a new microVM. Minimal example: {"source":{"type":"image","reference":"alpine:3.20"},"resources":{"cpus":1,"memoryMb":512},"ttlSeconds":3600}. Poll GET /
GET/v1/machines/{id}/filesNot publishedDownload a file from a machine
POST/v1/machines/{id}/filesNot publishedUpload a file to a machine
GET/v1/machines/{id}/sessionsNot publishedList sessions for a machine
POST/v1/machines/{id}/sessionsNot publishedCreate a persistent session that preserves working directory and environment across exec calls
DELETE/v1/machines/{id}/sessions/{session_id}Not publishedDelete a session
POST/v1/machines/{id}/codeNot publishedRun Python or JavaScript code directly in a machine
POST/v1/machines/{id}/sessions/{session_id}/execNot publishedExecute a command within a persistent session. Session preserves working directory and environment across calls.
GET/v1/machinesNot publishedList all machines. Use to discover existing machine IDs for recovery or cleanup.
GET/v1/machines/{id}/eventsNot publishedGet machine event log
POST/v1/machines/{id}/execNot publishedRun a command inside a machine. Pass command as a shell string ("ls -la") or argv array (["ls","-la"]). Machine must be ready before calling.
GET/v1/machines/{id}Not publishedGet machine details and status. Poll until ready is true before executing commands.
DELETE/v1/machines/{id}Not publishedPermanently delete a machine and its storage
POST/v1/machines/{id}/startNot publishedStart a stopped machine
POST/v1/machines/{id}/stopNot publishedStop a running machine. Preserves disk state.

Call the provider directly and settle x402 per request.

Quickstart · x402 flow

1 · Call without payment. The service replies 402

bash
curl -i https://x402.orthogonal.com/smolmachines/v1/machines \  -H "Content-Type: application/json" \  -d '{"source": {"type": "image", "reference": "alpine:3.20"}, "resources": {"cpus": 1, "memoryMb": 512}, "ttlSeconds": 3600}'
Response
HTTP/1.1 402 Payment Required{ "x402Version": 2,  "accepts": [{ "scheme": "exact", "network": "eip155:143",  "asset": "USDC", "maxAmountRequired": "<quoted per request>" }] }

2 · Sign the payment with your agent wallet and retry

bash
curl https://x402.orthogonal.com/smolmachines/v1/machines \  -H "X-PAYMENT: <base64 payment payload signed by your EOA>" \  -H "Content-Type: application/json" \  -d '{"source": {"type": "image", "reference": "alpine:3.20"}, "resources": {"cpus": 1, "memoryMb": 512}, "ttlSeconds": 3600}'
Response
HTTP/1.1 200 OK

Any EOA on Monad can pay.

Any APIs or tools listed are provided for discovery purposes only and do not constitute an endorsement or recommendation by the Monad Foundation.