vend-client

Python client for Vend API Merchant — pay-per-call APIs settled in Nano (XNO).

pip install <wheel-url> 0.1.0 MIT (wheel served by Vend — not yet on PyPI)

← Back to Vend Download wheel Download source

Install

pip install https://extract.paypercall.dev/static/packages/vend_client-0.1.0-py3-none-any.whl

# NOTE: the [paid] extra cannot be selected via a direct-URL pip install (pip 404s on it).
# For Nano wallet payment, wire feeless402 yourself, or run from a clone (`uv run vend-client`).

Quick start — dry run (no payment needed)

from vend_client import VendClient

client = VendClient()
result = client.extract("https://example.com")
print(result["price_xno"], "XNO")  # 0.0001
print(result["pay_to"])            # nano_1yo6c1...

Paid call

from vend_client import VendClient
from nano_pay.wallet import Wallet

wallet = Wallet(seed_path="/path/to/seed.txt")
client = VendClient(wallet=wallet)

result = client.domain_info("example.com")
print(result["dns_records"])

CLI

# Dry-run
vend-client extract --url https://example.com

# Paid
vend-client --wallet /path/to/seed.txt extract --url https://example.com

# Other endpoints
vend-client check-link --url https://example.com
vend-client domain-info --domain example.com
vend-client web-search --q "Nano news"
vend-client geoip --ip 8.8.8.8
vend-client nano-info --account nano_1...

All endpoints

How payment works

1. Call unpaid → HTTP 402 with Nano price and pay-to account
2. Send the quoted amount to the pay-to account (feeless, ~1 second)
3. Retry with the block hash in the X-PAYMENT header → results in JSON

To get started with Nano: feeless402.com has a wallet and CLI.

Source

The vend-client source and built artifacts are served from this server. The project is MIT-licensed.