← 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
- A wallet on Base mainnet holding a little USDC. One
dns-lookupcall costs $0.003; quick tools cost $0.003 to $0.02 per call, so $0.10 of USDC covers 33dns-lookupcalls. Payments are x402exactUSDC transfers that your wallet signs; the facilitator submits them, so the wallet needs no ETH for gas. - The wallet's private key in the environment variable
AGENT_WALLET_KEY, never in code. Use a separate agent wallet with a small balance: an x402 client pays the amount the 402 asks for (the shop's prices are fixed per tool, listed in https://shop.lordevo.com/catalog.json). - No account, sign-up or API key. Instant tools that fail or are refused are not charged. Long jobs (202) are charged when accepted and are not refunded automatically if they fail later. If a paid job failed, email hello@lordevo.com with the transaction hash and we'll review it, usually within 2 business days.
- To try without a wallet: 3 free calls per IP per UTC day on the 52 tools priced up to $0.005 (opt-in, see below).
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)
- 400 / 422: bad or unusable input (body
{"error", "message", "charged": false}). Fix the input; do not retry as is. - 403: robots.txt does not allow the shop to fetch that URL. Pick another URL.
- 402: payment needed. On a trial request,
free_trial.statussays why:used_up_today(3 free calls used; resets 00:00 UTC),daily_cap_reached(the shop's daily trial cap) ornot_eligible(tool above $0.005). Pay per call instead. With a paying client, a final 402 means the payment was not accepted: check the USDC balance on Base (eip155:8453). - 429 / 503: busy or rate-limited. Wait
Retry-Afterseconds, then retry once. - 409
payment_in_use: the same signed payment was sent twice at once. Make a new call.
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
can-fetch($0.003, free trial ok): Can I fetch this URL? robots.txt + AI-crawler permission gate.GET https://shop.lordevo.com/api/quick/can-fetch?url=https://example.com/blog/postpage-markdown($0.003, free trial ok): URL to Markdown: LLM-ready web page reader (main content).GET https://shop.lordevo.com/api/quick/page-markdown?url=https://example.comsite-check($0.02): Site check: URL risk signals + AI readiness + security headers (recommended start).GET https://shop.lordevo.com/api/quick/site-check?url=https://example.comemail-validate($0.003, free trial ok): Email validation / email verification API (syntax + domain + MX, no SMTP probing).GET https://shop.lordevo.com/api/quick/email-validate?email=jane@example.compdf-text($0.003, free trial ok): PDF to text, page by page.GET https://shop.lordevo.com/api/quick/pdf-text?url=https://www.w3.org/WAI/ER/tests/xhtml/testfiles/resources/pdf/dummy.pdf- All 58 tools with prices and inputs: https://shop.lordevo.com/catalog.json, https://shop.lordevo.com/llms.txt, https://shop.lordevo.com/quick
Checked
Written 2026-10-30 against the current public docs:
- https://shop.lordevo.com/start (the shop itself)
- https://shop.lordevo.com/openapi.json (OpenAPI 3.1)
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.