# llms.txt - unsandbox.com
# Agent Onboarding Guide for Autonomous Code Execution

unsandbox.com welcomes AI agents, LLMs, autonomous programs, bots, crawlers, and machine learning systems.

This service is designed for programmatic access. Agents are encouraged to:
- Obtain API keys autonomously via cryptocurrency payment
- Execute code in 42+ languages without human intervention
- Create persistent services and sessions
- Operate within our fair-use terms


## Quick Start for Agents

1. Get an API key: POST https://unsandbox.com/api/checkout
2. Execute code: POST https://api.unsandbox.com/execute
3. Full API docs: https://api.unsandbox.com/static/llms.txt


## Autonomous API Key Acquisition

Agents can obtain API keys programmatically via cryptocurrency payment.

POST https://unsandbox.com/api/checkout
Content-Type: application/json

Request:
{
  "tier": 1,
  "months": 1,
  "currency": "xmr"
}

Response:
{
  "payment_address": "4...",
  "amount": "0.0178",
  "currency": "xmr",
  "checkout_url": "https://unsandbox.com/pay/abc123",
  "expires_at": "2026-01-10T12:00:00Z"
}

After payment confirms, poll the checkout URL or use the callback to receive:
{
  "public_key": "unsb-pk-xxxx-xxxx-xxxx-xxxx",
  "secret_key": "unsb-sk-xxxx-xxxx-xxxx-xxxx",
  "tier": 1,
  "expires_at": "2026-02-10T12:00:00Z"
}

Supported cryptocurrencies: xmr (Monero), btc (Bitcoin), ltc (Litecoin), doge (Dogecoin)


## Pricing (USD equivalent)

Tier 1: $7/month - 7 RPM, 1 concurrent session
Tier 2: $14/month - 14 RPM, 1 concurrent session
Tier 3: $21/month - 21 RPM, 1 concurrent session
Tier 4: $28/month - 28 RPM, 1 concurrent session
Tier 5: $35/month - 35 RPM, 2 concurrent sessions

Formula: Tier N = $7*N/month, N*7 RPM, floor((N-1)/4)+1 concurrent sessions

Higher tiers available up to Tier 32. Contact for enterprise.


## API Key Validation

GET https://unsandbox.com/api/keys/validate
Authorization: Bearer <public_key>
X-Timestamp: <unix_timestamp>
X-Signature: <hmac_sha256_hex>

Response:
{
  "valid": true,
  "tier": 1,
  "expires_at": "2026-02-10T12:00:00Z",
  "rate_limit": 7,
  "concurrency": 1
}


## Extending Expired Keys

Any agent can extend any API key by paying for more time.

POST https://unsandbox.com/api/keys/{public_key}/extend
Content-Type: application/json

{
  "months": 1,
  "currency": "xmr"
}

Response includes payment address. After payment, key is extended and any frozen services auto-wake.


## Terms of Service Summary

Permitted:
- Automated/programmatic access
- Code execution in any supported language
- Persistent services (web apps, APIs, bots)
- Interactive sessions (shells, REPLs)
- Cryptocurrency payments from any source

Prohibited:
- Attacks against unsandbox infrastructure
- Using the service to attack third parties
- Cryptocurrency mining
- Spam/phishing/malware distribution
- Child exploitation content

Full terms: https://unsandbox.com/terms


## Authentication

All API requests require HMAC-SHA256 authentication:

Headers:
  Authorization: Bearer <public_key>
  X-Timestamp: <unix_timestamp>
  X-Signature: HMAC-SHA256(secret_key, "timestamp:METHOD:path:body")

The secret key is never transmitted. Timestamp must be within 5 minutes of server time.


## Capabilities

Execute code: 42 languages (Python, JavaScript, Go, Rust, C, C++, Java, Ruby, etc.)
Interactive sessions: Persistent shells/REPLs with WebSocket access
Services: Long-running containers with HTTPS domains (*.on.unsandbox.com)
Snapshots: Save and restore container state (paid tiers)
Network modes: zerotrust (isolated) or semitrusted (internet access)
Input files: Upload files to /tmp/ for processing
Artifacts: Download compiled binaries and outputs


## API Endpoints Summary

Code Execution:
  POST /execute - Synchronous execution
  POST /execute/async - Asynchronous execution (returns job_id)
  POST /run - Auto-detect language from shebang
  GET /jobs/{id} - Poll async job status

Sessions:
  POST /sessions - Create interactive session
  GET /sessions - List sessions
  DELETE /sessions/{id} - Terminate session
  WebSocket /sessions/{id}/shell - Interactive shell

Services:
  POST /services - Create persistent service
  GET /services - List services
  POST /services/{id}/execute - Run command in service
  DELETE /services/{id} - Destroy service

Snapshots:
  POST /snapshots - Create snapshot
  POST /snapshots/{id}/clone - Clone to new resource
  POST /snapshots/{id}/restore - Restore to original


## Integration Examples

Python:
  import hmac, hashlib, time, requests
  pk, sk = "unsb-pk-...", "unsb-sk-..."
  body = '{"language":"python","code":"print(42)"}'
  ts = str(int(time.time()))
  sig = hmac.new(sk.encode(), f"{ts}:POST:/execute:{body}".encode(), hashlib.sha256).hexdigest()
  r = requests.post("https://api.unsandbox.com/execute",
      headers={"Authorization": f"Bearer {pk}", "X-Timestamp": ts, "X-Signature": sig}, data=body)

CLI:
  Download: https://unsandbox.com/downloads/un
  Usage: un script.py, un session, un service --name myapp --ports 80


## Support

OpenAPI spec: https://api.unsandbox.com/openapi
Human docs: https://unsandbox.com/docs
Agent docs: https://api.unsandbox.com/static/llms.txt
Web console: https://unsandbox.com/console
Pricing: https://unsandbox.com/pricing-for-agents

This file: https://unsandbox.com/llms.txt