Pay-Per-Call API Access
for AI Agents

// Option B — x402-fetch for Node.js / TypeScript agents
import { createWalletClient, http } from 'viem'
import { base } from 'viem/chains'
import { wrapFetchWithPayment } from 'x402-fetch'

const wallet = createWalletClient({
  account: privateKeyToAccount(process.env.PRIVATE_KEY),
  chain: base,
  transport: http()
})

const fetch402 = wrapFetchWithPayment(fetch, wallet)

// US Weather — no auth needed
const weather = await fetch402(
  'https://httpay.xyz/api/gateway/weather/points/39.7456,-104.9994'
)

// GitHub repos — pass your token via X-Upstream-Token
const repos = await fetch402(
  'https://httpay.xyz/api/gateway/github/users/octocat/repos', {
  headers: { 'X-Upstream-Token': 'ghp_yourtoken' }
})

// Base RPC via JSON-RPC
const block = await fetch402(
  'https://httpay.xyz/api/gateway/eth-base/', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ jsonrpc: '2.0', method: 'eth_blockNumber', params: [], id: 1 })
})

# Free demo mode — no payment required (rate-limited per IP)
# Append ?demo=true to any gateway endpoint

# Weather data (public API, no auth)
curl "https://httpay.xyz/api/gateway/weather/points/39.7456,-104.9994?demo=true"

# Wikipedia article summary
curl "https://httpay.xyz/api/gateway/wikipedia/page/summary/Bitcoin?demo=true"

# List all 37 gateway services (always free)
curl "https://httpay.xyz/api/gateway"

# With real x402 payment (requires X-PAYMENT header)
curl -H "X-PAYMENT: <base64-encoded-payment-payload>" \
  -H "X-Upstream-Token: ghp_yourtoken" \
  "https://httpay.xyz/api/gateway/github/users/octocat/repos"

# Python — using x402-python client
from x402 import create_payment_client
from eth_account import Account

account = Account.from_key(os.environ["PRIVATE_KEY"])
client = create_payment_client(account, chain="base")

# Weather data (no upstream auth needed)
resp = client.get(
  "https://httpay.xyz/api/gateway/weather/points/39.7456,-104.9994"
)

# GitHub with token
resp = client.get(
  "https://httpay.xyz/api/gateway/github/users/octocat",
  headers={"X-Upstream-Token": "ghp_yourtoken"}
)

# OpenAI via gateway (bring your own OpenAI key)
resp = client.post(
  "https://httpay.xyz/api/gateway/openai/chat/completions",
  headers={"X-Upstream-Token": "sk-yourkey"},
  json={"model": "gpt-4o-mini", "messages": [{"role": "user", "content": "Hello"}]}
)