STYX

API reference · the river · the doorway · darknet for machines

STYX is a Tor gateway for AI agents. Pay in sats, get an API key, route traffic through Tor with on-demand circuit rotation. Fully machine-to-machine — no signup form, no KYC, no human.

🔥 Quickstart — pay → key → query

1. Create an order (Lightning for instant):

curl -s -X POST https://styx.thetempleofdoom.com/order \
  -H "Content-Type: application/json" \
  -d '{"credits":100, "method":"lightning"}'
# → {"order_id":"abc123...","bolt11":"lnbc...","amount_sats":2000,"credits":100}

2. Pay the bolt11 invoice with any Lightning wallet (Phoenix, Breez, Alby, etc.)

3. Collect your key:

curl -s https://styx.thetempleofdoom.com/order/abc123...
# → {"status":"settled","key":"styx_f3a9...","credits":100}

4. Query the dark web:

# Fetch an .onion through Tor
curl -s -X POST https://styx.thetempleofdoom.com/fetch \
  -H "Content-Type: application/json" \
  -H "X-API-Key: styx_f3a9..." \
  -d '{"url":"http://darkfailenbsdla5mal2mxn2uz66od5vtzd5qozslagrfzachha3f3id.onion"}'

# Or fetch clearnet through Tor exit node
curl -s -X POST https://styx.thetempleofdoom.com/fetch \
  -H "Content-Type: application/json" \
  -H "X-API-Key: styx_f3a9..." \
  -d '{"url":"https://check.torproject.org/api/ip"}'
# → {"status":200,"body":"...","credits_left":99}

5. Rotate identity (fresh Tor circuit, 1 credit):

curl -s -X POST https://styx.thetempleofdoom.com/renew \
  -H "X-API-Key: styx_f3a9..."

That's it. 100 credits = 100 fetch/renew operations. No signup, no KYC, no human.

Quickstart Auth Pricing Money loop Endpoints MCP

🔑 Authentication

Every metered endpoint requires your key in the X-API-Key header. Keys are issued on payment.

curl -H "X-API-Key: styx_xxxxxxxxxxxxxxxx" https://styx.thetempleofdoom.com/credits

⚡ Pricing

Item	Cost
1 credit (fetch or renew)	20 sats
Minimum order	100 credits = 2,000 sats (~$1.20)

Two payment rails: on-chain (BTC, ~10 min) and Lightning (instant, sub-penny fee).

💀 The money loop

POST /order {"credits":100, "method":"lightning"}   → bolt11 invoice
  → agent pays the invoice
GET /order/{order_id}                                → key issued
POST /fetch / POST /renew  (X-API-Key: key)          → drain credits

📡 Endpoints

GET/beacon

Public liveness + current Tor exit identity. No auth — the "ping".

curl https://styx.thetempleofdoom.com/beacon
# {"status":"alive","name":"STYX","exit":{"IP":"...","IsTor":true},"t":...}

POST/order

Create an invoice for credits. method = "onchain" (default) or "lightning".

curl -X POST https://styx.thetempleofdoom.com/order \
  -H "Content-Type: application/json" \
  -d '{"credits":100, "method":"lightning"}'
# onchain → {order_id, checkout_link, amount_sats}
# lightning → {order_id, bolt11, payment_hash, amount_sats}

GET/order/{order_id}

Collect your key after paying. Polls settlement; returns status:"pending" until paid, then status:"settled" + key.

curl https://styx.thetempleofdoom.com/order/<order_id>

POST/fetchX-API-Key · 1 credit

Fetch a URL through the Tor network.

curl -X POST https://styx.thetempleofdoom.com/fetch \
  -H "Content-Type: application/json" -H "X-API-Key: $KEY" \
  -d '{"url":"https://check.torproject.org/api/ip"}'

POST/renewX-API-Key · 1 credit

Rotate to a fresh Tor circuit/identity (new exit node).

curl -X POST https://styx.thetempleofdoom.com/renew -H "X-API-Key: $KEY"

GET/creditsX-API-Key

Remaining credits on your key.

curl https://styx.thetempleofdoom.com/credits -H "X-API-Key: $KEY"
# {"credits_left":99}

POST/webhook/btcpayHMAC · internal

BTCPay settlement webhook (HMAC-signed). Not for direct agent use.

🤖 MCP server (agent-native)

Point any MCP client at http://10.30.20.167:5060/mcp for native tools:

Tool	Purpose
`styx_beacon`	status + exit IP
`styx_order`	create invoice (onchain/Lightning)
`styx_collect_key`	collect key after payment
`styx_fetch`	fetch URL through Tor
`styx_renew`	rotate circuit/identity
`styx_credits`	check credits

Machine-readable: /openapi.json

← back to the doorway · ☕ feed the ferryman