Skip to content

VVtech/httpay

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

121 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Alfred's Digital Bazaar 🫡

170+ micro-API endpoints paywalled via x402 on Base. Each call costs $0.10–$1.00 USDC.

Quick Start (Local)

npm install
npm start
# Server runs on http://localhost:4020

Calling Endpoints

Endpoints return 402 Payment Required until paid via x402. Use an x402-compatible client:

import { wrapAxios } from "x402-axios";
import axios from "axios";

const client = wrapAxios(axios, wallet);
const { data } = await client.get("https://httpay.xyz/api/fortune");

Agent-Priority Discovery (for indexers & autonomous agents)

Use these machine-readable discovery docs to surface serious endpoints first:

  • /.well-known/agent-priority.json → ranked, high-signal shortlist
  • /x402-manifest.json → full catalog (backward compatible, now includes agentTags + agentPriorityScore)
  • /.well-known/x402-bazaar.json → x402 Bazaar catalog
  • /openapi.yaml → OpenAPI spec with serious workflow tags

Serious workflow tags: token-intel, yield, mev-risk, bridge, risk-scoring, onchain-analytics

New High-Value Endpoint

  • GET /api/token-intel/:address$0.04
    • Aggregates Dexscreener + BaseScan + GoPlus + GeckoTerminal
    • Returns normalized token metadata, liquidity/volume, security flags
    • Includes composite risk score (0-100), risk verdict (LOW | MEDIUM | HIGH), and confidence score
    • Uses timeout + partial fallback when one or more upstreams fail

Categories

  • 🎭 Fun — Roasts, pickup lines, fortunes, haikus ($0.10–$0.25)
  • 🛠️ Tools — Gas oracle, token lookup, address tools ($0.25–$0.50)
  • 📊 Analysis — Market mood, yield finder, risk scores ($0.50–$1.00)
  • 🎲 Games — Trivia, dice, 8-ball, achievements ($0.10–$0.25)
  • 🔮 Predictions — Moon predictions, vibe checks ($0.15–$0.50)
  • 🏗️ Dev — Solidity tips, audit bingo, contract ideas ($0.10–$0.25)
  • 🎪 Novelty — Dating profiles, dream interpreter, naming ($0.10–$0.25)
  • 💬 Social — GM/GN, bio generators ($0.10–$0.15)

Config

  • Network: Base (mainnet)
  • Token: USDC
  • PayTo: 0x5f5d6FcB315871c26F720dc6fEf17052dD984359

Deploying to Vercel

  1. Install the Vercel CLI: npm i -g vercel
  2. Link the project: vercel link
  3. Deploy: vercel --prod

The vercel.json routes all requests to the Express app in api/index.js. No config changes needed.

For local Vercel emulation: npm run vercel-dev

MCP Server (AI Agents)

This project includes an MCP server that exposes all endpoints as native AI tools. Any MCP-compatible client (Claude Desktop, Cursor, etc.) can discover and call them with automatic x402 payment handling.

node mcp-server.js

See MCP-README.md for full setup instructions.

Architecture

  • api/index.js — Main Express app (exported for Vercel serverless)
  • index.js — Local dev entry point (requires api/index.js)
  • vercel.json — Vercel routing and build config

Security

  • Rate limiting: 100 requests per IP per 15 minutes (via express-rate-limit)
  • Security headers: Applied via helmet

Visit the root URL for the full interactive endpoint directory.

About

x402 Pay-Per-Call API Marketplace — httpay.xyz

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages