# httpay.xyz — Complete Agent API Reference

> httpay.xyz is a pay-per-call API marketplace for AI agents. 287 native endpoints + Universal API Gateway (37 services, ~9,700 upstream endpoints) covering token intelligence, MEV risk, yield analysis, smart-money profiling, onchain analytics, and x402 ecosystem data. Pay with USDC on Base via the x402 standard — no API keys, no signup, no rate plans.

## Quick Discovery Links (for agents)

- **Concise summary:** https://httpay.xyz/llms.txt (this file's shorter version)
- **OpenAPI spec:** https://httpay.xyz/openapi.yaml
- **Plugin manifest:** https://httpay.xyz/.well-known/ai-plugin.json
- **Agent capabilities:** https://httpay.xyz/.well-known/agent-capabilities.json
- **Priority endpoints:** https://httpay.xyz/.well-known/agent-priority.json
- **Agents manifest:** https://httpay.xyz/agents.json
- **MCP install:** `npx @httpay/mcp` (recommended — no x402 client setup needed)
- **Gateway catalog:** https://httpay.xyz/api/gateway (live JSON, 37 services)

## Service Details

- **Base URL:** https://httpay.xyz
- **Protocol:** x402 (HTTP 402 Payment Required)
- **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
- **ERC-8004 agent ID:** #18032
- **Rate limit:** 100 requests per 15 minutes

## How x402 Payment Works

1. Make a normal HTTP request to any paid endpoint
2. Server returns `402 Payment Required` with payment details in headers
3. Client constructs a USDC payment on Base (EIP-3009 transferWithAuthorization signature)
4. Re-send request with `X-PAYMENT` header containing the signed authorization
5. Server verifies with CDP facilitator, returns response, settles payment on-chain

**Libraries:** `x402-fetch` (npm), `x402-axios` (npm), or any x402-compatible client

**Free demo endpoints (no payment needed):** `/api/fortune`, `/api/gm`

## MCP Integration (Recommended for Claude/MCP Agents)

Install the MCP server — no x402 client implementation required:

```json
{
  "mcpServers": {
    "httpay": {
      "command": "npx",
      "args": ["@httpay/mcp"]
    }
  }
}
```

Package: `@httpay/mcp` on npm

---

## UNIVERSAL API GATEWAY (37 Services, ~9,700 Endpoints)

The Gateway proxies 37 major APIs through a single x402-paid endpoint. Bring your own API key for authenticated services.

**Pattern:** `GET or POST https://httpay.xyz/api/gateway/{service}/{path}`  
**Auth:** Pass `X-Upstream-Token: <your-key>` for services requiring auth. Public APIs (weather, wikipedia, blockchain RPCs) need no token.  
**Price:** $0.001–$0.005 per request  
**Discovery:** `GET https://httpay.xyz/api/gateway` — live JSON catalog  
**Demo:** Append `?demo=true` for a free test call on any gateway endpoint

| Service | Category | Auth Required |
|---|---|---|
| github | Developer Tools | token |
| cloudflare | Cloud | bearer |
| gitlab | Developer Tools | bearer |
| vercel | Developer Tools | bearer |
| discord | Communication | bot token |
| slack | Communication | bearer |
| twilio | Communication | basic |
| resend | Email | bearer |
| digitalocean | Cloud | bearer |
| huggingface | AI/ML | bearer |
| openai | AI/ML | bearer |
| openrouter | AI/ML | bearer |
| notion | Productivity | bearer |
| stripe | Payments | basic |
| supabase | Database | bearer |
| neon | Database | bearer |
| weather | Data | none |
| wikipedia | Data | none |
| eth-base | Blockchain RPC | none |
| eth-polygon | Blockchain RPC | none |
| eth-arbitrum | Blockchain RPC | none |
| eth-optimism | Blockchain RPC | none |
| eth-ankr | Blockchain RPC | none |

(Full list: `GET https://httpay.xyz/api/gateway`)

**Examples:**
```bash
# Weather (free, no auth)
curl "https://httpay.xyz/api/gateway/weather/points/39.7456,-104.9994?demo=true"

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

# Base RPC
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/
```

---

## TOKEN INTELLIGENCE (Critical for Agent Decision-Making)

Live data endpoints for token analysis, safety, and pricing. Run these before any DeFi interaction.

- [GET /api/token-scanner/:address](https://httpay.xyz/api/token-scanner/:address): Token safety scanner — honeypot detection, LP check, safety score 0-100 (live Base data) — **$0.020** ⭐ AGENT ESSENTIAL
- [GET /api/token-price/:symbol](https://httpay.xyz/api/token-price/:symbol): Live token price in USD from CoinGecko — **$0.005**
- [GET /api/dex-price/:token](https://httpay.xyz/api/dex-price/:token): Real-time token price from multiple DEXes on Base via GeckoTerminal — **$0.005**
- [GET /api/trending-tokens-base](https://httpay.xyz/api/trending-tokens-base?timeframe=h24): Top trending tokens on Base by volume/liquidity via GeckoTerminal (?timeframe=h1|h6|h24) — **$0.010**
- [GET /api/trending-tokens](https://httpay.xyz/api/trending-tokens): Top trending tokens from CoinGecko (live) — **$0.008**
- [GET /api/token-lookup/:symbol](https://httpay.xyz/api/token-lookup/:symbol): Token info and stats — **$0.005**

## MEV RISK & SECURITY

Security scoring and contract analysis for risk-aware agents.

- [GET /api/wallet-risk/:address](https://httpay.xyz/api/wallet-risk/:address): Wallet risk score — checks tx count, balance, code via Base RPC (live) — **$0.008** ⭐ AGENT ESSENTIAL
- [GET /api/contract-audit/:address](https://httpay.xyz/api/contract-audit/:address): Automated smart contract security scan: vulnerabilities, proxy detection, owner analysis (live BaseScan) — **$0.030**
- [GET /api/tx-decode/:hash](https://httpay.xyz/api/tx-decode/:hash): Decode and explain a transaction — **$0.008**
- [GET /api/contract-info/:address](https://httpay.xyz/api/contract-info/:address): Contract name, verified status, ABI summary from Basescan (live) — **$0.010**
- [GET /api/contract-explain/:address](https://httpay.xyz/api/contract-explain/:address): Explain what a contract does — **$0.010**
- [GET /api/ens-lookup/:name](https://httpay.xyz/api/ens-lookup/:name): Resolve ENS name to Ethereum address with profile records (live) — **$0.008**

## YIELD ANALYSIS

DeFi yield data, TVL metrics, bridge routing. Core for any yield-optimizing agent.

- [GET /api/defi-yields](https://httpay.xyz/api/defi-yields): Top DeFi yields on Base via DeFiLlama (live) — **$0.010** ⭐ AGENT ESSENTIAL
- [GET /api/protocol-tvl/:protocol](https://httpay.xyz/api/protocol-tvl/:protocol): TVL, yield, and risk metrics via DeFiLlama (Aave, Morpho, Aerodrome, 2000+ protocols) — **$0.010**
- [GET /api/bridge-rates](https://httpay.xyz/api/bridge-rates?from=ethereum&to=base&amount=1000): Compare bridge rates/fees/speeds (LI.FI, Stargate, Across, Hop, etc.) — **$0.010** ⭐ AGENT ESSENTIAL
- [GET /api/defi-positions/:address](https://httpay.xyz/api/defi-positions/:address): All DeFi positions on Base: Aave, Morpho, Aerodrome LP (live) — **$0.020**
- [GET /api/nft-floor/:collection](https://httpay.xyz/api/nft-floor/:collection): NFT collection floor price, volume, and stats on Base via Reservoir — **$0.010**
- [GET /api/yield-finder](https://httpay.xyz/api/yield-finder): Find the best yield opportunities — **$0.020**
- [GET /api/defi-health-check](https://httpay.xyz/api/defi-health-check): Overall DeFi ecosystem health check — **$0.020**

## SMART-MONEY PROFILING

Wallet intelligence, whale tracking, airdrop checks. For agents tracking addresses.

- [GET /api/wallet-profiler/:address](https://httpay.xyz/api/wallet-profiler/:address): Comprehensive wallet profile: token holdings, recent activity, PnL estimate, risk score (live) — **$0.020** ⭐ AGENT ESSENTIAL
- [GET /api/whale-alert-base](https://httpay.xyz/api/whale-alert-base): Latest large transactions on Base (>$10K) in the last hour — **$0.010** ⭐ AGENT ESSENTIAL
- [GET /api/airdrop-checker/:address](https://httpay.xyz/api/airdrop-checker/:address): Check wallet eligibility for known upcoming airdrops — **$0.020**
- [GET /api/airdrop-check/:address](https://httpay.xyz/api/airdrop-check/:address): Check potential airdrop eligibility — **$0.008**
- [GET /api/whale-alert](https://httpay.xyz/api/whale-alert): Recent large transactions — **$0.005**
- [GET /api/wallet-age/:address](https://httpay.xyz/api/wallet-age/:address): Estimate wallet age and activity level — **$0.005**
- [GET /api/portfolio-grade/:address](https://httpay.xyz/api/portfolio-grade/:address): Grade a wallet's portfolio — **$0.010**
- [GET /api/wallet-personality/:address](https://httpay.xyz/api/wallet-personality/:address): Determine your wallet's personality type — **$0.003**

## AGENT DIRECTORY & DISCOVERY

Find and connect with other x402-enabled agents.

- [GET /api/agent-directory](https://httpay.xyz/api/agent-directory?q=search): AI agent directory — discover x402-enabled agents by capability (?q=&category= params) — **$0.030** ⭐ AGENT ESSENTIAL
- [GET /api/x402-services](https://httpay.xyz/api/x402-services): Complete directory of all known x402-enabled services — **$0.010**
- [GET /api/x402-index](https://httpay.xyz/api/x402-index): Master discovery endpoint — all services, endpoints, prices, facilitators — **$0.010**
- [GET /api/erc8004-lookup/:agentId](https://httpay.xyz/api/erc8004-lookup/:agentId): ERC-8004 registered agent details from Base registry contract (on-chain) — **$0.010**
- [GET /api/gas-optimizer](https://httpay.xyz/api/gas-optimizer): Gas optimizer for Base — current price, cost estimates, timing recommendation (live) — **$0.010**

## EXCLUSIVE x402 ECOSYSTEM DATA

Only available via httpay.xyz. Proprietary x402 ecosystem intelligence.

- [GET /api/x402-stats](https://httpay.xyz/api/x402-stats): Aggregated x402 ecosystem stats — total services, volume, growth metrics. EXCLUSIVE — **$0.050**
- [GET /api/x402-recent-txns](https://httpay.xyz/api/x402-recent-txns): Real-time x402 USDC transaction monitor on Base — **$0.050**

## MARKET INTELLIGENCE

Sentiment, narratives, and macro signals for trading agents.

- [GET /api/market-mood](https://httpay.xyz/api/market-mood): Current crypto market sentiment analysis (Fear & Greed) — **$0.020** ⭐ AGENT ESSENTIAL
- [GET /api/alpha-report](https://httpay.xyz/api/alpha-report): Daily alpha/opportunity report — **$0.050**
- [GET /api/narrative-tracker](https://httpay.xyz/api/narrative-tracker): Track hot crypto narratives — **$0.020**
- [GET /api/twitter-sentiment](https://httpay.xyz/api/twitter-sentiment?q=bitcoin): Approximate Twitter/X sentiment for a query (?q= param) — **$0.020**
- [GET /api/news/crypto](https://httpay.xyz/api/news/crypto): Latest crypto headlines from aggregated RSS feeds — **$0.005**

## L2 & GAS OPTIMIZATION

Route transactions to cheapest chain.

- [GET /api/gas-compare](https://httpay.xyz/api/gas-compare): Compare real-time gas costs across 10 chains in USD — **$0.010**
- [GET /api/cheapest-chain/:operation](https://httpay.xyz/api/cheapest-chain/:operation): Find cheapest L2 for an operation (ethTransfer/erc20Transfer/nftMint/swap) — **$0.005**
- [GET /api/gas/:chain](https://httpay.xyz/api/gas/:chain): Gas cost for a specific chain (base/optimism/arbitrum/ethereum/zksync/linea/polygon-zkevm) — **$0.005**
- [GET /api/l2-costs](https://httpay.xyz/api/l2-costs): Real-time gas costs across 7 L2s in USD — **$0.050**
- [GET /api/gas-oracle](https://httpay.xyz/api/gas-oracle): Current gas prices across chains — **$0.005**
- [GET /api/fee-calculator/:amount/:chain](https://httpay.xyz/api/fee-calculator/:amount/:chain): Calculate transaction fees for a transfer — **$0.005**
- [GET /api/gas-worth-it/:amount/:chain](https://httpay.xyz/api/gas-worth-it/:amount/:chain): Is it worth paying gas for this transaction? — **$0.005**

## AGENT ESSENTIALS (General Utility)

Useful utility endpoints for any agent workflow.

- [GET /api/web-scrape](https://httpay.xyz/api/web-scrape?url=https://example.com): Fetch and return readable content from any URL (?url= param) — **$0.010**
- [GET /api/email-validate](https://httpay.xyz/api/email-validate?email=test@example.com): Email validation: format check, MX record lookup, disposable domain detection — **$0.005**
- [GET /api/ip-lookup/:ip](https://httpay.xyz/api/ip-lookup/me): IP geolocation, ISP, country, city, timezone, threat indicators — **$0.005**
- [GET /api/github-profile/:username](https://httpay.xyz/api/github-profile/torvalds): GitHub public profile: bio, stats, top repos, languages — **$0.005**
- [GET /api/image-ocr](https://httpay.xyz/api/image-ocr?url=https://example.com/image.png): Extract text from any image URL using OCR — **$0.010**
- [GET /api/dns/:domain](https://httpay.xyz/api/dns/:domain): DNS lookup — A, AAAA, MX, TXT records — **$0.001**
- [GET /api/timestamp](https://httpay.xyz/api/timestamp): Current UTC timestamp in multiple formats — **$0.001**
- [GET /api/uuid](https://httpay.xyz/api/uuid): Generate a cryptographically random UUID v4 — **$0.001**
- [GET /api/hash](https://httpay.xyz/api/hash?text=hello&algo=sha256): Hash text with MD5, SHA1, SHA256, or SHA512 — **$0.001**
- [GET /api/address-checksum/:address](https://httpay.xyz/api/address-checksum/:address): Validate and checksum an Ethereum address — **$0.005**
- [GET /api/unit-converter/:amount/:unit](https://httpay.xyz/api/unit-converter/:amount/:unit): Convert between crypto units (wei, gwei, ETH, etc) — **$0.005**
- [GET /api/impermanent-loss/:change](https://httpay.xyz/api/impermanent-loss/:change): Calculate impermanent loss for a given price change — **$0.008**
- [GET /api/epoch-converter/:timestamp](https://httpay.xyz/api/epoch-converter/:timestamp): Convert between epoch and human-readable timestamps — **$0.005**
- [GET /api/hex-converter/:value](https://httpay.xyz/api/hex-converter/:value): Convert between hex, decimal, and other formats — **$0.005**
- [GET /api/url-parse](https://httpay.xyz/api/url-parse?url=https://example.com): Parse URL into components — **$0.001**
- [GET /api/base64-encode](https://httpay.xyz/api/base64-encode?text=hello): Base64 encode a string — **$0.001**
- [GET /api/base64-decode](https://httpay.xyz/api/base64-decode?text=aGVsbG8%3D): Base64 decode a string — **$0.001**
- [POST /api/json-format](https://httpay.xyz/api/json-format): Pretty-print and validate JSON — **$0.001**
- [GET /api/user-agent-parse](https://httpay.xyz/api/user-agent-parse?ua=Mozilla%2F5.0): Parse a User-Agent string — **$0.001**
- [POST /api/markdown-to-html](https://httpay.xyz/api/markdown-to-html): Convert Markdown to HTML — **$0.002**
- [POST /api/html-to-markdown](https://httpay.xyz/api/html-to-markdown): Convert HTML to Markdown — **$0.002**
- [GET /api/translate](https://httpay.xyz/api/translate?text=hello&target=es): Translate text via LibreTranslate — **$0.003**
- [POST /api/text-diff](https://httpay.xyz/api/text-diff): Compute diff between two texts — **$0.003**
- [GET /api/cron-parse](https://httpay.xyz/api/cron-parse?expr=0+*+*+*+*): Parse cron expression to human-readable schedule — **$0.002**
- [GET /api/color-convert](https://httpay.xyz/api/color-convert?hex=FF5733): Convert hex color to RGB and HSL — **$0.001**
- [GET /api/lorem-ipsum](https://httpay.xyz/api/lorem-ipsum?paragraphs=3): Generate lorem ipsum placeholder text — **$0.001**
- [GET /api/http-headers](https://httpay.xyz/api/http-headers?url=https://example.com): Fetch and inspect HTTP response headers for any URL — **$0.002**

## ANALYSIS (Deeper Insights)

Comparative analysis and portfolio tools.

- [GET /api/compare/:token1/:token2](https://httpay.xyz/api/compare/:token1/:token2): Compare two tokens head-to-head — **$0.020**
- [GET /api/risk-score/:protocol](https://httpay.xyz/api/risk-score/:protocol): DeFi protocol risk assessment — **$0.020**
- [GET /api/portfolio-builder/:amount](https://httpay.xyz/api/portfolio-builder/:amount): Build a portfolio for a given budget — **$0.050**
- [GET /api/chain-compare/:chain1/:chain2](https://httpay.xyz/api/chain-compare/:chain1/:chain2): Compare two blockchains — **$0.020**
- [GET /api/rate-my-portfolio/:holdings](https://httpay.xyz/api/rate-my-portfolio/:holdings): Rate your portfolio composition — **$0.010**
- [GET /api/ens-whois/:name](https://httpay.xyz/api/ens-whois/:name): ENS name availability and info — **$0.005**
- [GET /api/weather](https://httpay.xyz/api/weather?lat=37.7&lon=-122.4): Weather forecast via Open-Meteo (?lat=&lon= params) — **$0.002**

## ENTERTAINMENT (Lower Priority for Agents)

Fun/novelty endpoints. Low cost, low signal value for serious agent workflows.

### Fun (34 endpoints, $0.001–$0.005)

- [GET /api/fortune](https://httpay.xyz/api/fortune): Crypto fortune cookie — **$0.001** FREE DEMO
- [GET /api/gm](https://httpay.xyz/api/gm): Get a GM (Good Morning) message — **$0.001** FREE DEMO
- [GET /api/pickup-line](https://httpay.xyz/api/pickup-line): Crypto/web3 themed pickup lines — **$0.001**
- [GET /api/roast](https://httpay.xyz/api/roast): Get roasted by the blockchain — **$0.001**
- [GET /api/roast-my-wallet/:address](https://httpay.xyz/api/roast-my-wallet/:address): Roast someone's on-chain activity — **$0.002**
- [GET /api/explain-like-im-5/:topic](https://httpay.xyz/api/explain-like-im-5/:topic): ELI5 any crypto concept — **$0.001**
- [GET /api/rap-battle/:token1/:token2](https://httpay.xyz/api/rap-battle/:token1/:token2): Rap battle between two tokens — **$0.003**
- [GET /api/horoscope/:sign](https://httpay.xyz/api/horoscope/:sign): Crypto-themed daily horoscope — **$0.001**
- [GET /api/name-my-token](https://httpay.xyz/api/name-my-token): Generate creative token names — **$0.001**
- [GET /api/write-whitepaper/:idea](https://httpay.xyz/api/write-whitepaper/:idea): Generate a parody whitepaper — **$0.005**
- [GET /api/crypto-excuse](https://httpay.xyz/api/crypto-excuse): Excuse for why you lost money in crypto — **$0.001**
- [GET /api/crypto-haiku](https://httpay.xyz/api/crypto-haiku): Generate a crypto-themed haiku — **$0.001**
- [GET /api/shower-thought](https://httpay.xyz/api/shower-thought): Crypto shower thoughts — **$0.001**
- [GET /api/token-obituary/:token](https://httpay.xyz/api/token-obituary/:token): Write an obituary for a dead/dying token — **$0.002**
- [GET /api/wojak-moment](https://httpay.xyz/api/wojak-moment): Which Wojak are you today? — **$0.001**
- [GET /api/vc-pitch/:idea](https://httpay.xyz/api/vc-pitch/:idea): Generate a VC pitch for any dumb idea — **$0.005**
- [GET /api/exit-strategy](https://httpay.xyz/api/exit-strategy): Generate a random crypto exit strategy — **$0.001**
- [GET /api/fud-generator/:token](https://httpay.xyz/api/fud-generator/:token): Generate FUD about any token — **$0.001**
- [GET /api/apology-letter/:token](https://httpay.xyz/api/apology-letter/:token): Write an apology to a token you paper-handed — **$0.002**
- [GET /api/blockchain-pickup/:chain](https://httpay.xyz/api/blockchain-pickup/:chain): Pickup lines for specific blockchains — **$0.001**
- [GET /api/degen-name](https://httpay.xyz/api/degen-name): Generate your degen alter ego name — **$0.001**
- [GET /api/motivational-degen](https://httpay.xyz/api/motivational-degen): Motivational quotes for degens — **$0.001**
- [GET /api/conspiracy/:topic](https://httpay.xyz/api/conspiracy/:topic): Crypto conspiracy theories — **$0.002**
- [GET /api/crypto-insult](https://httpay.xyz/api/crypto-insult): Get roasted by the blockchain — **$0.001**
- [GET /api/breakup-text/:token](https://httpay.xyz/api/breakup-text/:token): Write a breakup text to a token — **$0.002**
- [GET /api/tweet-generator/:topic](https://httpay.xyz/api/tweet-generator/:topic): Generate a crypto Twitter banger — **$0.001**
- [GET /api/shill-generator/:token](https://httpay.xyz/api/shill-generator/:token): Generate a shill post for any token — **$0.002**
- [GET /api/panic-button](https://httpay.xyz/api/panic-button): Press the crypto panic button — **$0.001**
- [GET /api/cope-post/:loss](https://httpay.xyz/api/cope-post/:loss): Generate a cope post for your losses — **$0.002**
- [GET /api/unpopular-opinion](https://httpay.xyz/api/unpopular-opinion): Unpopular crypto opinions — **$0.001**
- [GET /api/acronym-generator/:letters](https://httpay.xyz/api/acronym-generator/:letters): Turn any letters into a crypto acronym — **$0.001**
- [GET /api/memecoin-generator](https://httpay.xyz/api/memecoin-generator): Generate a complete memecoin concept — **$0.002**
- [GET /api/defi-jargon-generator](https://httpay.xyz/api/defi-jargon-generator): Generate fake but believable DeFi jargon — **$0.001**
- [GET /api/ser-or-madam](https://httpay.xyz/api/ser-or-madam): Are you a ser or a madam in crypto? — **$0.001**
- [GET /api/one-liner](https://httpay.xyz/api/one-liner): Random crypto one-liner joke — **$0.001**

### Games (9 endpoints, $0.001–$0.003)

- [GET /api/coin-flip](https://httpay.xyz/api/coin-flip): Flip a blockchain-verified coin — **$0.001**
- [GET /api/magic-8ball/:question](https://httpay.xyz/api/magic-8ball/:question): Ask the crypto magic 8-ball — **$0.001**
- [GET /api/would-you-rather](https://httpay.xyz/api/would-you-rather): Crypto 'Would You Rather' scenarios — **$0.001**
- [GET /api/two-truths-one-lie](https://httpay.xyz/api/two-truths-one-lie): Two truths and a lie about crypto — **$0.001**
- [GET /api/this-or-that](https://httpay.xyz/api/this-or-that): Quick crypto this-or-that preference poll — **$0.001**
- [GET /api/rekt-leaderboard](https://httpay.xyz/api/rekt-leaderboard): Hall of fame for biggest crypto disasters — **$0.003**
- [GET /api/degen-dice](https://httpay.xyz/api/degen-dice): Roll the degen dice — **$0.001**
- [GET /api/crypto-trivia](https://httpay.xyz/api/crypto-trivia): Random crypto trivia question — **$0.001**
- [GET /api/crypto-achievement](https://httpay.xyz/api/crypto-achievement): Unlock a random crypto achievement — **$0.001**

### Predictions (6 endpoints, $0.002–$0.005)

- [GET /api/when-moon/:token](https://httpay.xyz/api/when-moon/:token): Predict when a token will moon (not financial advice) — **$0.003**
- [GET /api/vibe-check](https://httpay.xyz/api/vibe-check): Get the current crypto vibe check — **$0.002**
- [GET /api/bottom-signal](https://httpay.xyz/api/bottom-signal): Check if we've hit the bottom — **$0.003**
- [GET /api/top-signal](https://httpay.xyz/api/top-signal): Check if we've hit the top — **$0.003**
- [GET /api/zodiac-portfolio/:sign](https://httpay.xyz/api/zodiac-portfolio/:sign): Portfolio allocation based on zodiac sign — **$0.005**
- [GET /api/chain-fortune/:chain](https://httpay.xyz/api/chain-fortune/:chain): Fortune for a specific blockchain — **$0.002**

### Dev (5 endpoints, $0.003–$0.005)

- [GET /api/solidity-roast/:code](https://httpay.xyz/api/solidity-roast/:code): Roast a Solidity function name — **$0.005**
- [GET /api/smart-contract-idea](https://httpay.xyz/api/smart-contract-idea): Generate a random smart contract idea — **$0.005**
- [GET /api/gas-golfing-tip](https://httpay.xyz/api/gas-golfing-tip): Random Solidity gas optimization tip — **$0.005**
- [GET /api/audit-bingo](https://httpay.xyz/api/audit-bingo): Generate an audit bingo card of common vulnerabilities — **$0.005**
- [GET /api/dev-excuse](https://httpay.xyz/api/dev-excuse): Why the smart contract isn't deployed yet — **$0.003**

### Novelty (15 endpoints, $0.001–$0.003)

- [GET /api/rate-my-address/:address](https://httpay.xyz/api/rate-my-address/:address): Rate an Ethereum address's aesthetic appeal — **$0.002**
- [GET /api/blockchain-poem/:topic](https://httpay.xyz/api/blockchain-poem/:topic): Generate a blockchain-themed poem — **$0.002**
- [GET /api/crypto-band-name](https://httpay.xyz/api/crypto-band-name): Generate a crypto-themed band name — **$0.001**
- [GET /api/crypto-dating-profile](https://httpay.xyz/api/crypto-dating-profile): Generate a crypto bro dating profile — **$0.002**
- [GET /api/what-if/:amount/:token/:date](https://httpay.xyz/api/what-if/:amount/:token/:date): What if you'd invested X in Y on date Z? — **$0.003**
- [GET /api/rename-my-nft/:name](https://httpay.xyz/api/rename-my-nft/:name): Get a better name for your NFT — **$0.001**
- [GET /api/blockchain-mad-libs](https://httpay.xyz/api/blockchain-mad-libs): Crypto-themed mad libs story — **$0.002**
- [GET /api/crypto-baby-name](https://httpay.xyz/api/crypto-baby-name): Name your baby after crypto — **$0.001**
- [GET /api/crypto-dream-interpreter/:dream](https://httpay.xyz/api/crypto-dream-interpreter/:dream): Interpret your dream through a crypto lens — **$0.002**
- [GET /api/wen-lambo/:portfolio_size](https://httpay.xyz/api/wen-lambo/:portfolio_size): Calculate when you can afford a Lambo — **$0.002**
- [GET /api/is-it-a-scam/:name](https://httpay.xyz/api/is-it-a-scam/:name): Is this crypto project a scam? (satirical) — **$0.002**
- [GET /api/how-early/:narrative](https://httpay.xyz/api/how-early/:narrative): How early are you to a crypto narrative? — **$0.002**
- [GET /api/protocol-name-generator](https://httpay.xyz/api/protocol-name-generator): Generate a DeFi protocol name — **$0.001**
- [GET /api/timelock-message/:hours](https://httpay.xyz/api/timelock-message/:hours): Get a motivational message locked to a future time — **$0.002**

### Social (4 endpoints, $0.001)

- [GET /api/discord-bio](https://httpay.xyz/api/discord-bio): Generate a Discord bio for a crypto person — **$0.001**
- [GET /api/twitter-bio](https://httpay.xyz/api/twitter-bio): Generate a Crypto Twitter bio — **$0.001**
- [GET /api/gn](https://httpay.xyz/api/gn): Get a GN (Good Night) message — **$0.001**
- [GET /api/meme-potential/:token](https://httpay.xyz/api/meme-potential/:token): Rate a token's meme potential — **$0.020**
- [GET /api/nft-roast/:collection](https://httpay.xyz/api/nft-roast/:collection): Roast an NFT collection — **$0.020**

---

## Free / System Endpoints

- [GET /health](https://httpay.xyz/health): Server health check — FREE
- [GET /_stats](https://httpay.xyz/_stats): Public usage analytics — FREE
- [GET /capabilities](https://httpay.xyz/capabilities): Full capability manifest — FREE
- [GET /x402-manifest.json](https://httpay.xyz/x402-manifest.json): x402 protocol manifest — FREE
- [GET /.well-known/agent-registration.json](https://httpay.xyz/.well-known/agent-registration.json): ERC-8004 agent registration (agentId: 18032) — FREE
- [GET /.well-known/agent-capabilities.json](https://httpay.xyz/.well-known/agent-capabilities.json): Machine-readable capability manifest with schemas — FREE
- [GET /agent-quickstart.json](https://httpay.xyz/agent-quickstart.json): One-file bootstrap for agents — FREE

## Agent Discovery Links

- [Agent quickstart](https://httpay.xyz/agent-quickstart.json): One-file bootstrap — read this first
- [Agent capabilities](https://httpay.xyz/.well-known/agent-capabilities.json): Full capability manifest with inputSchema/outputSchema/examples
- [Agent registration](https://httpay.xyz/.well-known/agent-registration.json): ERC-8004 registration, capabilities, payment info
- [OpenAPI spec](https://httpay.xyz/openapi.yaml): Machine-readable Swagger/OpenAPI 3.0 spec
- [x402 manifest](https://httpay.xyz/x402-manifest.json): x402 protocol manifest with all endpoint pricing
- [MCP NPM package](https://www.npmjs.com/package/@httpay/mcp): `npx @httpay/mcp`
- [x402 protocol](https://x402.org): x402 HTTP payment standard specification
- [ERC-8004](https://eips.ethereum.org/EIPS/eip-8004): On-chain agent identity standard