# httpay.xyz — Agent-Native API Marketplace

> httpay.xyz is a pay-per-call API marketplace for AI agents. 287 native endpoints + a Universal API Gateway proxying 37 services (~9,700 upstream endpoints). Pay with USDC on Base via x402 — no API keys, no signup. ERC-8004 registered agent #18032.

## ⭐ NEW: Universal API Gateway — 37 Services, ~9,700 Endpoints

The Gateway is httpay's flagship feature. One x402 payment unlocks any endpoint on 37 major APIs.

**Pattern:** `GET /POST https://httpay.xyz/api/gateway/{service}/{path}`

**Auth:** For services requiring API keys, pass your own key via `X-Upstream-Token: <key>`.  
No token needed for public APIs (weather, wikipedia, blockchain RPCs, petstore).

**Price:** $0.001–$0.005 per request (USDC on Base)

**Demo mode:** Append `?demo=true` to test any gateway endpoint for free.

**Gateway discovery:** `GET https://httpay.xyz/api/gateway` — lists all services with pricing & auth info.

### Gateway Services (37 total)

| Service Key | Host | Category | Endpoints | Auth |
|---|---|---|---|---|
| github | api.github.com | Developer Tools | ~1,080 | token |
| cloudflare | api.cloudflare.com | Cloud | ~2,591 | bearer |
| gitlab | gitlab.com | Developer Tools | ~72 | bearer |
| vercel | api.vercel.com | Developer Tools | ~231 | bearer |
| postman | api.getpostman.com | Developer Tools | varies | apikey |
| discord | discord.com/api/v10 | Communication | ~227 | bot token |
| slack | slack.com/api | Communication | ~174 | bearer |
| twilio | api.twilio.com | Communication | varies | basic |
| resend | api.resend.com | Email | varies | bearer |
| digitalocean | api.digitalocean.com | Cloud | ~545 | bearer |
| flyio | api.machines.dev | Cloud | varies | bearer |
| render | api.render.com | Cloud | varies | bearer |
| pagerduty | api.pagerduty.com | DevOps | ~390 | token |
| sentry | sentry.io/api/0 | Monitoring | ~212 | bearer |
| datadog | api.datadoghq.com | Monitoring | varies | apikey |
| circleci | circleci.com/api/v2 | DevOps | varies | token |
| huggingface | huggingface.co/api | AI/ML | ~203 | bearer |
| openai | api.openai.com/v1 | AI/ML | varies | bearer |
| openrouter | openrouter.ai/api/v1 | AI/ML | varies | bearer |
| notion | api.notion.com/v1 | Productivity | varies | bearer |
| asana | app.asana.com/api/1.0 | Productivity | varies | bearer |
| jira | jira.atlassian.com | Productivity | varies | basic |
| stripe | api.stripe.com/v1 | Payments | varies | basic |
| spotify | api.spotify.com/v1 | Media | varies | bearer |
| supabase | api.supabase.com/v1 | Database | varies | bearer |
| turso | api.turso.tech/v1 | Database | varies | bearer |
| neon | console.neon.tech/api/v2 | Database | varies | bearer |
| weather | api.weather.gov | Data | ~60 | none |
| wikipedia | en.wikipedia.org/api/rest_v1 | Data | varies | none |
| petstore | petstore3.swagger.io/api/v3 | Demo | ~19 | none |
| eth-ankr | rpc.ankr.com/eth | Blockchain RPC | — | none |
| eth-cloudflare | cloudflare-eth.com | Blockchain RPC | — | none |
| eth-publicnode | ethereum-rpc.publicnode.com | Blockchain RPC | — | none |
| eth-base | mainnet.base.org | Blockchain RPC | — | none |
| eth-optimism | mainnet.optimism.io | Blockchain RPC | — | none |
| eth-arbitrum | arb1.arbitrum.io/rpc | Blockchain RPC | — | none |
| eth-polygon | polygon-rpc.com | Blockchain RPC | — | none |

### Gateway Quick Examples
```bash
# US Weather (no auth needed)
curl -H "X-PAYMENT: <x402>" https://httpay.xyz/api/gateway/weather/points/39.7456,-104.9994

# GitHub repos (bring your own token)
curl -H "X-PAYMENT: <x402>" -H "X-Upstream-Token: ghp_yourtoken" \
  https://httpay.xyz/api/gateway/github/users/octocat/repos

# Base RPC via JSON-RPC POST
curl -X POST -H "X-PAYMENT: <x402>" -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":1}' \
  https://httpay.xyz/api/gateway/eth-base/

# Demo (free test — no payment)
curl "https://httpay.xyz/api/gateway/weather/points/39.7456,-104.9994?demo=true"
```

---

## For Agents: Quick Start

**Option A — MCP (recommended, no x402 code needed):**
```json
{ "mcpServers": { "httpay": { "command": "npx", "args": ["@httpay/mcp"] } } }
```

**Option B — x402 HTTP:**
```
GET https://httpay.xyz/api/<endpoint>
→ 402 Payment Required
→ Sign USDC transferWithAuthorization (EIP-3009)
→ Re-request with X-PAYMENT header
→ Response delivered
```

**Test with free demo:** `GET https://httpay.xyz/api/fortune?demo=true` (no payment needed)

## Payment Details

- Network: Base (chain ID 8453)
- Asset: USDC (`0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913`)
- Pay-to: `0x5f5d6FcB315871c26F720dc6fEf17052dD984359`
- Facilitator: `https://api.cdp.coinbase.com/platform/v2/x402`
- Price range: $0.001–$0.05 per call

## Native Endpoints (287 total)

### Token Intelligence ($0.005–$0.040)
- [Token Intel](https://httpay.xyz/api/token-intel/0x...): Aggregated DexScreener+GoPlus+BaseScan intelligence — $0.040 ⭐ BEST
- [Token Scanner](https://httpay.xyz/api/token-scanner/0x...): Honeypot detection, safety score 0-100 — $0.020
- [Token Price](https://httpay.xyz/api/token-price/ETH): Live price from CoinGecko — $0.005
- [DEX Price](https://httpay.xyz/api/dex-price/USDC): Multi-DEX price on Base — $0.005
- [Trending on Base](https://httpay.xyz/api/trending-tokens-base): Top movers by volume — $0.010
- [Rug Pull Checker](https://httpay.xyz/api/rugcheck/0x...): 20+ risk factors, rug detection — $0.020
- [Token Holders](https://httpay.xyz/api/token-holders/0x...): Holder distribution, whale %, Gini coefficient — $0.020
- [Token Compare](https://httpay.xyz/api/token-compare?token1=USDC&token2=DAI): Side-by-side comparison — $0.010
- [DEX Volume](https://httpay.xyz/api/dex-volume): Real-time volume per DEX on Base — $0.010
- [Stablecoin Monitor](https://httpay.xyz/api/stablecoin-monitor): Depeg alerts for USDC/USDT/DAI — $0.010
- [Fresh Markets](https://httpay.xyz/api/fresh-markets-watch): New token launches in last 24h — $0.005
- [DEX Volume Tracker](https://httpay.xyz/api/dex-volume-tracker): Volume trend 1h/6h/24h — $0.005

### MEV Risk & Security ($0.005–$0.050)
- [MEV Risk](https://httpay.xyz/api/mev-risk?amountUsd=1000): Pre-swap MEV sandwich risk 0-100 — $0.010 ⭐
- [Wallet Risk](https://httpay.xyz/api/wallet-risk/0x...): Risk score 0-100 via Base RPC — $0.008
- [Contract Audit](https://httpay.xyz/api/contract-audit/0x...): Proxy/vulnerability scan — $0.030
- [Contract Audit Scanner](https://httpay.xyz/api/contract-audit-scanner?address=0x...): Deep audit, CVSS scoring — $0.050
- [Smart Contract Risk Scorer](https://httpay.xyz/api/smart-contract-risk-scorer?address=0x...): GoPlus 15-dimension scoring — $0.010
- [Approval Risk Auditor](https://httpay.xyz/api/approval-risk-auditor?address=0x...): Dangerous unlimited approvals — $0.005
- [MEV Scanner](https://httpay.xyz/api/mev-scanner): Detect sandwiches/front-running on Base — $0.010
- [Mempool Scanner](https://httpay.xyz/api/mempool-scanner): Pending large txs, sandwich opportunities — $0.010
- [Portfolio Risk](https://httpay.xyz/api/portfolio-risk/0x...): Full DeFi portfolio risk assessment — $0.030

### Yield Analysis & DeFi Intelligence ($0.005–$0.030)
- [Yield Intel](https://httpay.xyz/api/yield-intel?chain=base&minApy=5): Gas-adjusted APY, risk tiers A-D — $0.020
- [DeFi Yields](https://httpay.xyz/api/defi-yields): Base yields via DeFiLlama — $0.010
- [Protocol TVL](https://httpay.xyz/api/protocol-tvl/morpho): TVL + APY for any protocol — $0.010
- [Bridge Intel](https://httpay.xyz/api/bridge-intel?from=ethereum&to=base&amount=1000): Live bridge cost comparison — $0.020
- [Bridge Rates](https://httpay.xyz/api/bridge-rates?from=ethereum&to=base&amount=1000): Best bridge route — $0.010
- [DeFi Positions](https://httpay.xyz/api/defi-positions/0x...): Aave/Morpho/Aerodrome positions — $0.020
- [Liquidation Scanner](https://httpay.xyz/api/liquidation-scanner?maxHf=1.2): Aave+Moonwell at-risk positions — $0.020
- [Lending Liquidation Sentinel](https://httpay.xyz/api/lending-liquidation-sentinel): Real-time sentinel alerts — $0.010
- [Perps Funding Pulse](https://httpay.xyz/api/perps-funding-pulse): Funding rates across Hyperliquid/GMX/dYdX — $0.005
- [LP IL Estimator](https://httpay.xyz/api/lp-il-estimator?priceChange=50): Impermanent loss calculator — $0.005
- [Fee Tracker](https://httpay.xyz/api/fee-tracker): 24h protocol fee revenue on Base — $0.010
- [Protocol TVL Monitor](https://httpay.xyz/api/protocol-tvl-monitor): TVL spike/drop detection — $0.005
- [Stablecoin Flow Monitor](https://httpay.xyz/api/stablecoin-flow-monitor): Stablecoin inflows/outflows — $0.005
- [Yield Pool Watcher](https://httpay.xyz/api/yield-pool-watcher): Pool-level yield monitoring — $0.005

### Smart-Money Profiling & Copy Trading ($0.005–$0.030)
- [Copy Trade Intelligence](https://httpay.xyz/api/copy-trade/0x...): Win rate, returns, position patterns — $0.030
- [Profit & Loss](https://httpay.xyz/api/profit-loss/0x...): On-chain PnL, win rate, best/worst trades — $0.030
- [Wallet Profiler](https://httpay.xyz/api/wallet-profiler/0x...): Holdings, PnL, risk score — $0.020
- [Whale Alert](https://httpay.xyz/api/whale-alert-base): Large txs on Base (>$10K) — $0.010
- [Whale Tracker](https://httpay.xyz/api/whale-tracker?minUsd=100000): Advanced whale tracking — $0.005
- [Token Holder Monitor](https://httpay.xyz/api/token-holder-monitor?address=0x...): Whale entry/exit detection — $0.005
- [Airdrop Check](https://httpay.xyz/api/airdrop-checker/0x...): Eligibility for known airdrops — $0.020

### Gas & Network Tools ($0.005–$0.050)
- [Gas Optimizer](https://httpay.xyz/api/gas-optimizer): Optimal timing + cost estimates — $0.010
- [Gas Tracker Advanced](https://httpay.xyz/api/gas-tracker-advanced): Gas history, submission windows — $0.005
- [Gas Compare](https://httpay.xyz/api/gas-compare): Cross-chain gas costs — $0.010
- [Cheapest Chain](https://httpay.xyz/api/cheapest-chain/swap): Cheapest L2 for operation — $0.005
- [Bridge Route Pinger](https://httpay.xyz/api/bridge-route-pinger): Live bridge availability check — $0.005
- [Base Stats](https://httpay.xyz/api/base-stats): TPS, sequencer status, TVL — $0.005
- [L2 Costs](https://httpay.xyz/api/l2-costs): Real-time gas costs across 7 L2s — $0.050

### Agent Directory & Ecosystem ($0.001–$0.050)
- [Agent Directory](https://httpay.xyz/api/agent-directory?q=search): Discover x402 agents — $0.010
- [Agent Profile](https://httpay.xyz/api/agent-profile/18032): Detailed agent profile lookup — $0.005
- [x402 Services](https://httpay.xyz/api/x402-services): All known x402 services — $0.010
- [ERC-8004 Lookup](https://httpay.xyz/api/erc8004-lookup/18032): On-chain agent registry — $0.010

### Exclusive x402 Data ($0.010–$0.050)
- [x402 Stats](https://httpay.xyz/api/x402-stats): Ecosystem volume/growth — EXCLUSIVE — $0.050
- [x402 Transactions](https://httpay.xyz/api/x402-recent-txns): Real-time x402 tx feed — $0.050
- [x402 Index](https://httpay.xyz/api/x402-index): Master discovery endpoint — $0.010

### Market Intelligence ($0.010–$0.050)
- [Market Mood](https://httpay.xyz/api/market-mood): Fear & Greed + dominant narrative — $0.020
- [Alpha Report](https://httpay.xyz/api/alpha-report): Daily opportunities — $0.050

## Discovery Resources

- [agent.md](https://httpay.xyz/agent.md): Machine-readable context file — paste into your agent's context to learn httpay
- [Agent quickstart](https://httpay.xyz/agent-quickstart.json): One-file bootstrap for any agent
- [Agent capabilities](https://httpay.xyz/.well-known/agent-capabilities.json): Machine-readable capability manifest with schemas
- [Agent priority](https://httpay.xyz/.well-known/agent-priority.json): High-signal endpoint shortlist ranked by agent value
- [Agent registration](https://httpay.xyz/.well-known/agent-registration.json): ERC-8004 #18032 registration
- [OpenAPI spec](https://httpay.xyz/openapi.yaml): Full Swagger/OpenAPI 3.0 spec
- [Full endpoint list](https://httpay.xyz/llms-full.txt): All 287+ endpoints with prices
- [Gateway catalog](https://httpay.xyz/api/gateway): Live JSON catalog of all 37 gateway services

## Links

- [x402 protocol](https://x402.org): x402 HTTP payment standard
- [ERC-8004 standard](https://eips.ethereum.org/EIPS/eip-8004): On-chain agent identity
- [MCP package](https://www.npmjs.com/package/@httpay/mcp): npm `@httpay/mcp`