clawproxy docs

Minimal HTTP API documentation.

Endpoints

POST /v1/proxy/:provider — Proxy a request to a provider and return provider response + _receipt (legacy) + _receipt_envelope (canonical).
POST /v1/chat/completions — OpenAI-compatible alias for /v1/proxy/openai.
POST /v1/responses — OpenAI Responses API alias (routes to OpenAI /v1/responses upstream).
POST /v1/messages — Anthropic-compatible alias for /v1/proxy/anthropic.
GET /v1/receipt/:nonce — Fetch stored receipts for an idempotency nonce (streaming recovery helper).
GET /v1/did — DID document (public key material for receipt verification).
POST /v1/verify-receipt — Verify a receipt signature and return claims.
GET /health — Health check.

Quick start

# Recommended (proxy auth via CST + BYOK provider key)
curl -sS -X POST "https://clawproxy.com/v1/proxy/openai"   -H "X-CST: $CST_TOKEN"   -H "X-Provider-API-Key: $OPENAI_API_KEY"   -H "Content-Type: application/json"   -d '{"model":"gpt-4o-mini","messages":[{"role":"user","content":"hello"}]}'

# BYOK (no proxy auth; strict-mode compatible)
curl -sS -X POST "https://clawproxy.com/v1/proxy/openai"   -H "X-Provider-API-Key: $OPENAI_API_KEY"   -H "Content-Type: application/json"   -d '{"model":"gpt-4o-mini","messages":[{"role":"user","content":"hello"}]}'

# Legacy (non-strict mode only; provider key in Authorization)
curl -sS -X POST "https://clawproxy.com/v1/proxy/openai"   -H "Authorization: Bearer $OPENAI_API_KEY"   -H "Content-Type: application/json"   -d '{"model":"gpt-4o-mini","messages":[{"role":"user","content":"hello"}]}'

# Gemini (google provider; OpenAI-compatible request body)
curl -sS -X POST "https://clawproxy.com/v1/proxy/google"   -H "X-Provider-API-Key: $GEMINI_API_KEY"   -H "Content-Type: application/json"   -d '{"model":"gemini-3-flash-preview","messages":[{"role":"user","content":"hello"}]}'

# OpenRouter via fal (OpenAI-compatible; model prefix openrouter/)
curl -sS -X POST "https://clawproxy.com/v1/chat/completions"   -H "X-Provider-API-Key: $FAL_KEY"   -H "Content-Type: application/json"   -d '{"model":"openrouter/openai/gpt-4o-mini","messages":[{"role":"user","content":"hello"}]}'

# Platform-paid (no BYOK key): requires funded ledger account context
curl -sS -X POST "https://clawproxy.com/v1/proxy/openai"   -H "X-CST: $CST_TOKEN"   -H "X-Client-DID: did:key:..."   -H "X-Payment-Account-DID: did:key:..."   -H "Content-Type: application/json"   -d '{"model":"gpt-4o-mini","messages":[{"role":"user","content":"hello"}]}'

Platform-paid calls fail-closed: account-claim binding errors return deterministic 401 codes, and unbound/unfunded accounts return 402 PAYMENT_REQUIRED.