Skip to content

Latest commit

 

History

2 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 

Repository files navigation

pyfile-api

Utility API endpoints — pay-per-call, no accounts, no API keys.

Website: pyfile-toolkit.github.io — overview, pricing and discovery across x402 (USDC), Lightning (L402) and Nano.

What it is

A small set of deterministic utility endpoints that an agent can buy one call at a time. An unpaid request returns HTTP 402 with machine-readable payment terms; pay and retry.

Endpoints

Endpoint What it returns
GET /data/hash SHA-256 / SHA-512 / keccak-256 of a string
GET /data/hmac HMAC (sha256/sha512)
GET /data/encode Base64 / hex / URL encoding
GET /data/decode Base64 / hex / URL decoding
GET /data/abi Ethereum function-selector lookup
GET /data/bolt11/decode Decode a Lightning BOLT11 invoice
GET /data/dns DNS-over-HTTPS lookup
GET /data/whois Domain registration (RDAP)
GET /data/ip IP geolocation
GET /data/url URL metadata
GET /data/ct Certificate transparency
GET /data/network/status Block heights / node status
GET /data/crypto Crypto spot prices
GET /data/crypto/history Token price history
GET /data/crypto/trending Trending coins
GET /data/defi/yields DeFi yield pools (DefiLlama)
GET /data/fx FX rates
GET /data/gas/base Base L2 gas price
GET /data/wallet/balance EVM wallet native balance
GET /data/btc/fees Bitcoin fee estimates
GET /data/btc/address Bitcoin address balance
GET /data/wiki Wikipedia summary
GET /data/weather Current weather (Open-Meteo)
GET /data/hn/top Hacker News top stories
GET /data/github/trending GitHub repos by stars
GET /data/npm npm weekly downloads

Free: GET /health, GET /openapi.json, GET /.well-known/x402.

Payment

  • x402 — USDC on Base, Polygon or Arbitrum. Unpaid request returns 402 with a payment-required header (base64 JSON accepts[]).
  • Lightning (L402) — the GET variants return a WWW-Authenticate: L402 challenge with a BOLT11 invoice.
  • Nano (XNO) — 402 carries pay_to, price_raw and quote=sha256(body).

Source

Part of pyfile-toolkit. Related: nano-llm-api, l402-llm-mcp.

About

26 pay-per-call utility data endpoints for AI agents (crypto, DeFi yields, DNS, WHOIS, hashing, BOLT11, BTC fees, IP geo). x402 USDC + L402 Lightning + Nano. No API keys.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages