← All guides · Markdown: /guides/curl.md

curl: a free trial call with no wallet

Call one of the shop's tools from a terminal in 10 seconds: a free trial call needs no wallet, account or key.

For: curl / any HTTP client. Endpoint shape: GET https://shop.lordevo.com/api/quick/<tool>?<input>; (HTTP 402 with x402 terms until paid). All guides: https://shop.lordevo.com/guides

Prerequisites

Try it free (no wallet)

# 3 free calls per IP per UTC day on tools up to $0.005
curl -s "https://shop.lordevo.com/api/quick/dns-lookup?host=example.com&trial=1"

# Same with a header instead of the query; X-Lordevo-Trial-Remaining tells you how many free calls are left
curl -s -D - -H "X-Lordevo-Trial: 1" "https://shop.lordevo.com/api/quick/dns-lookup?host=example.com"

# Free preflight (never charged, 30 a day): would a paid fetch tool work on this URL?
curl -s "https://shop.lordevo.com/api/free/preflight?url=https://www.w3.org/WAI/ER/tests/xhtml/testfiles/resources/pdf/dummy.pdf&tool=pdf-text"

See the price (free, answers HTTP 402)

curl -i "https://shop.lordevo.com/api/quick/dns-lookup?host=example.com"
# x402 v2 terms (base64 JSON) are in the PAYMENT-REQUIRED header, x402 v1 terms in the JSON body:
curl -s -D - -o /dev/null "https://shop.lordevo.com/api/quick/dns-lookup?host=example.com" | grep -i '^payment-required:' | cut -d' ' -f2 | tr -d '\r' | base64 -d

To pay per call, use an x402 client: https://shop.lordevo.com/guides/x402-fetch (Node) or https://shop.lordevo.com/guides/python. curl cannot sign payments.

Errors (nothing is charged on any of these)

Handle the status in a script:

code=$(curl -s -o out.json -w '%{http_code}' -H "X-Lordevo-Trial: 1" "https://shop.lordevo.com/api/quick/dns-lookup?host=example.com")
case "$code" in
  200) cat out.json ;;
  402) echo "No free call left: $(jq -r '.free_trial.status // "pay per call"' out.json)" ;;
  429|503) echo "Busy; retry after the Retry-After seconds" ;;
  *) jq -r '.message // .error' out.json ;;
esac

Next tools to try

Checked

Written 2026-10-30 against the current public docs:

The trial, header and 402 calls were run with curl against a local copy of this shop (test network, test facilitator) on 2026-10-30 and again on 2026-11-09; the bash pipelines (grep, base64, jq) were not.