Vend API Merchant

Vend — Autonomous API Merchant

Pay-per-call APIs settled in Nano (XNO). No signup, no API keys — just HTTP 402 with an x402 v2 challenge.

---

Endpoints

Quick buyer guide

[BUYERS_GUIDE.md](BUYERS_GUIDE.md) — full step-by-step walkthrough with curl, Python, JavaScript, and wallet instructions.

The short version: call any endpoint -> get 402 -> send Nano -> retry with block hash.

How it works (buyer flow)

1. GET /api/v1/extract?url=https://example.com

→ HTTP 402 with x402 payment challenge

1. Send 0.0001 XNO to nano_1yo6c1t64ahfjdw1dxizmbbnpdmbrckwhw9phbg5pdkeubrizga4qhnjmnx7 → Get back a 64-char block hash

1. GET /api/v1/extract?url=https://example.com -H "X-PAYMENT: " → HTTP 200 with the extracted text

Python example

import httpx

Step 1: Probe unpaid

resp = httpx.get("https://search.paypercall.dev/api/v1/web-search?q=nano") assert resp.status_code == 402 challenge = resp.json()

Step 2: Extract payment info

accept = challenge"accepts" print(f"Pay {challenge['price_xno']} XNO to {accept'payTo'}...")

Step 3: Send Nano payment, get block hash (use your wallet)

Step 4: Retry with payment

result = httpx.get( "https://search.paypercall.dev/api/v1/web-search?q=nano", headers={"X-PAYMENT": "your-64-char-block-hash"} ) print(result.json())

See examples/python-buyer.py for a full working script with error handling.

Conformance

All endpoints pass the Stelar x402 Doctor at 100.0/A:

• extract: https://api.stelardigital.com/doctor?url=https://extract.paypercall.dev/api/v1/extract
• check-link: https://api.stelardigital.com/doctor?url=https://check.paypercall.dev/api/v1/check-link
• domain-info: https://api.stelardigital.com/doctor?url=https://domain.paypercall.dev/api/v1/domain-info
• web-search: https://api.stelardigital.com/doctor?url=https://search.paypercall.dev/api/v1/web-search
• geoip: https://api.stelardigital.com/doctor?url=https://geoip.paypercall.dev/api/v1/geoip
• nano-info: https://extract.paypercall.dev/api/v1/nano-info (nano.paypercall.dev DNS is still pointing at a dead deployment, so every advertised URL names this host)

x402 v2 challenge in both header and body. Per-endpoint subdomains. Bazaar input schema on every endpoint.

Discovery

• x402 manifest: https://extract.paypercall.dev/.well-known/x402 (also at check, domain, search)
• OpenAPI spec: https://extract.paypercall.dev/openapi.json (also at check, domain, search)
• agent-tools.cloud: https://agent-tools.cloud/services/extract-paypercall-dev-sub822

Running locally

# Our package is not on PyPI yet (the `vend` name on PyPI is an unrelated packaging tool).

Run from this repo instead:

uv sync export VEND_WALLET_ADDRESS="nano_..." uv run python -m vend

License

MIT