Back to Developers
API REFERENCE

Pay per call. Get results.

14 paid endpoints powered by x402. Send a USDC payment on Base, include the transaction signature in your request header, get results from distributed nodes worldwide.

GATEWAY
lull-gateway…
ENDPOINTS
14 paid
PAYMENT
USDC (x402)
PRICE RANGE
$0.01–0.10
X402 PAYMENT PROTOCOL

How it works. Three steps.

1

Discover price

Hit any endpoint without payment. You get a 402 response with the exact USDC amount and treasury address.

2

Send USDC

Create a USDC transfer to the treasury wallet on Base. Sign and submit the transaction. Wait for confirmation.

3

Include signature

Re-send your request with the transaction signature in the Payment-Signature header. Gateway verifies on-chain, then executes your job.

PAYMENT DETAILS
Treasury wallet
0xLULLTREASURY0000000000000000000000000000
Asset
USDC on Base
0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
Header
Payment-Signature: <tx_signature>
Max age
600 seconds (10 minutes)
QUICK START

Try it now. Three commands.

1. Hit a paid endpoint — get 402 with payment instructions
curl -s -X POST https://lull-gateway-production.up.railway.app/v1/compute/health \ -H "Content-Type: application/json" \ -d '{ "url": "https://example.com" }' # => 402 { # "x402Version": 1, # "error": "Payment required to access this resource", # "accepts": [{ # "scheme": "exact", # "network": "base", # "maxAmountRequired": "20000", # "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", # "payTo": "0xLULLTREASURY0000000000000000000000000000", # "resource": "https://lull-gateway-production.up.railway.app/v1/compute/health" # }] # }
2. Send USDC to treasury (amount from maxAmountRequired / 10^6)
# Use any Base SDK / wallet to transfer USDC # Amount: 0.02 USDC (20000 raw units, 6 decimals) # To: 0xLULLTREASURY0000000000000000000000000000 # Wait for tx confirmation, save the signature
3. Re-send with payment signature — get results
curl -s -X POST https://lull-gateway-production.up.railway.app/v1/compute/health \ -H "Content-Type: application/json" \ -H "Payment-Signature: YOUR_TX_SIGNATURE_HERE" \ -d '{ "url": "https://example.com" }' # => 200 { # "ok": true, # "result": { ... }, # "node": "node-eu-west-3" # }
FREE ENDPOINTS

Health & Discovery

GET /health Free

Verify the gateway is operational. No payment required.

curl https://lull-gateway-production.up.railway.app/health
RESPONSE
{ "ok": true, "service": "lull-gateway-upstream", "version": "v3", "x402": true }
GET /x402/manifest.json Free

Discover all available endpoints, pricing, and payment details. x402-compatible manifest for automated agents.

curl https://lull-gateway-production.up.railway.app/x402/manifest.json
RESPONSE (TRUNCATED)
{ "name": "lull-protocol", "x402Version": 1, "operator": { "currencies": { "usd": ["USDC"] }, "network": "base", "recipient": "0xLULLTREASURY0000000000000000000000000000" }, "endpoints": [ { "method": "POST", "path": "/v1/compute/fetch", "price_usd": 0.02 }, { "method": "POST", "path": "/v1/compute/health", "price_usd": 0.02 }, ... ] }
14 PAID ENDPOINTS

Monitoring, Scraping, Agents. Pick an endpoint.

MONITORING
POST/v1/compute/healthMonitoring

Run a full health check on a target URL. Returns status, response time, TLS info, and DNS resolution from a distributed node.

POST/v1/compute/pingMonitoring

Low-cost reachability probe. Returns latency and packet loss from up to 8 worldwide nodes in parallel.

POST/v1/compute/dnsMonitoring

Resolve a domain across multiple record types (A, AAAA, MX, TXT, CNAME, NS) from authoritative and public resolvers.

POST/v1/compute/sslMonitoring

Inspect a TLS certificate: issuer, validity window, SAN list, chain, and protocol/cipher support.

POST/v1/compute/tracerouteMonitoring

Full hop-by-hop traceroute with AS lookup and geo-IP per hop. Useful for debugging routing and CDN issues.

SCRAPING
POST/v1/compute/fetchScraping

Fetch raw HTTP response from a residential or datacenter IP. Headers, status, and body returned verbatim.

POST/v1/compute/scrapeScraping

Full headless render with JS execution. Returns rendered HTML, screenshot, and extracted text. Stealth profile included.

POST/v1/data/queryScraping

Run a CSS or XPath selector against a target URL. Returns matched nodes with text, attributes, and bounding boxes.

POST/v1/data/indexScraping

Crawl a sitemap or domain root, return a list of canonical URLs with title, description, and last-modified metadata.

AGENTS & COMPUTE
POST/v1/agent/taskAgent

Dispatch a structured task (browse, extract, summarize, classify) to any registered Lull agent. Returns final answer + trace.

POST/v1/agent/runAgent

Run a long-form agent workflow with streamed events. Resumable via job ID, settles per step at the manifest price.

POST/v1/gpu/inferenceGPU

Run inference on an open-weight model (Llama, Mistral, SDXL, Whisper) routed to the cheapest idle GPU in the network.

POST/v1/gpu/embedGPU

Generate embeddings (bge, e5, nomic) for a batch of up to 256 strings. Vectors returned as JSON or binary.

POST/v1/storage/pinStorage

Pin a file or JSON blob across redundant Lull storage nodes. Returns a content hash and retrieval URL.