--- name: httpay.xyz description: HTTPay.xyz is a micropayment-gated API host offering a mix of DeFi analytics endpoints (DEX volume, stablecoin peg status, MEV activity, gas prices), crypto market sentiment data, news headline aggregation, and novelty/entertainment content (roasts, pickup lines, fortune messages). All endpoints are single-shot REST calls designed for x402 micropayment flows. The host does not provide order execution, historical archives, or real-time streaming data. host: httpay.xyz --- # httpay.xyz HTTPay.xyz serves agents and developers who need lightweight, pay-per-call access to a curated set of crypto-native data and entertainment endpoints. It covers Base chain DeFi metrics (DEX volume, stablecoin pegs, MEV), multi-chain gas estimates, crypto and tech news headlines, and novelty content generators. It is not a full-featured market data platform — it lacks token price feeds, order book data, portfolio tracking, and cross-chain historical analytics. Its distinguishing characteristic is the bundling of DeFi utility endpoints alongside entertainment/demo content under a single x402 micropayment interface. ## When to use this host Use HTTPay.xyz when an agent needs pay-per-call access to Base chain DeFi metrics (DEX volume, stablecoin peg status, MEV detection), a multi-chain gas price snapshot, crypto or tech news headlines, or crypto market sentiment. It is a good fit for lightweight DeFi monitoring workflows on Base and for x402 micropayment demos. Do not use it for: token price quotes or OHLCV data (use CoinGecko, CoinMarketCap, or a dedicated market data API); order execution or trading (use a DEX aggregator or brokerage API); historical data beyond 24h-7d windows; chains other than the six supported for gas or Base for DeFi metrics; or real-time streaming/mempool data. The entertainment endpoints (roast, pickup line, fortune) are suitable only for demos and novelty features, not production data pipelines. ## Capabilities ### Base Chain DeFi Analytics Provides current on-chain data for the Base network: DEX trading volumes and market share, stablecoin peg health, and MEV activity detection across recent confirmed blocks. - **`fetch-base-dex-volume`** — Returns real-time DEX volume rankings, market share, and 24h growth rates for decentralized exchanges on the Base chain, sourced from DeFiLlama. - **`fetch-dex-volume-base`** — Returns aggregated 24h and 7d trading volume metrics for all active DEXes on Base, including per-DEX breakdown, market share, trend direction, and top pairs by volume. - **`fetch-stablecoin-peg-status`** — Returns live peg status, 24h supply flows, depeg alerts, and market data for USDC, USDT, DAI, EURC, and USDbC on Base, sourced from CoinGecko and DeFiLlama. - **`scan-mev-activity`** — Scans recent blocks on a specified chain for MEV activity including sandwich attacks and arbitrage transactions, returning counts, estimated profit, flagged blocks, and top MEV bots. ### Multi-Chain Gas & Network Conditions Returns a snapshot of current gas price estimates across six chains (Ethereum, Base, Arbitrum, Optimism, Polygon, Solana) to support fee estimation and transaction timing decisions. - **`fetch-gas-oracle-prices`** — Returns current gas price estimates (low, medium, high) for Ethereum, Base, Arbitrum, Optimism, Polygon, and Solana, plus a transaction timing recommendation. ### Crypto Market Sentiment Delivers a simulated fear/greed index, mood classification, and supporting signal breakdown to give agents a quick read on overall crypto market sentiment. - **`fetch-market-mood`** — Returns a crypto market sentiment snapshot including a fear/greed index score, mood label, and signal breakdown (social sentiment, volume trend, volatility, BTC dominance, funding rates). ### News Headlines Aggregates recent headlines from crypto RSS feeds and a multi-topic news API, returning titles, URLs, snippets, and publication dates for summarization or monitoring use cases. - **`fetch-crypto-news-headlines`** — Returns the latest 20 aggregated crypto news headlines from multiple RSS feeds, each with title, link, publication date, source, and a short snippet. - **`fetch-tech-news-headlines`** — Returns up to 20 recent news headlines for a selected topic, each with title, URL, publication date, source, snippet, and categories. ### Entertainment & Demo Content Generates novelty content including blockchain-themed roasts, crypto pickup lines, and fortune messages — primarily useful for demos, social apps, and testing x402 payment flows. - **`fetch-blockchain-roast`** — Returns a blockchain-themed roast message with a savagery score, advice, and metadata for a single GET request. - **`fetch-pickup-line`** — Returns a single creative pickup line with a rizz score and metadata, themed around a given context such as crypto or web3. - **`fetch-fortune-message`** — Returns a short crypto-themed fortune message, a lucky number, and a lucky token from the FortunePulse API. ## Workflows ### Base DeFi Risk Snapshot *Use when an agent needs to assess current DeFi conditions on Base before recommending or executing a transaction, covering volume activity, stablecoin stability, MEV risk, and gas costs.* 1. **`fetch-gas-oracle-prices`** — Check current gas prices on Base (and other chains) to determine whether network conditions and fees are favorable for transacting. 2. **`fetch-stablecoin-peg-status`** — Verify that major stablecoins on Base (USDC, USDT, DAI, etc.) are holding their pegs and no depeg alerts are active. 3. **`fetch-dex-volume-base`** — Retrieve 24h and 7d DEX volume metrics on Base to assess overall DeFi liquidity and activity levels. 4. **`scan-mev-activity`** — Scan recent Base blocks for sandwich attacks and arbitrage to quantify front-running risk before the agent proceeds. ### Crypto Market Context Briefing *Use when an agent needs to compile a current crypto market briefing combining sentiment signals and breaking news headlines for a user-facing summary or decision-support context.* 1. **`fetch-market-mood`** — Retrieve the current fear/greed index, mood label, and supporting signals to establish overall market sentiment. 2. **`fetch-crypto-news-headlines`** — Pull the latest aggregated crypto news headlines to surface breaking stories that may explain or contextualize the sentiment reading. 3. **`fetch-tech-news-headlines`** — Optionally fetch broader tech or business headlines to add macro context around the crypto sentiment snapshot. ## Skill reference ### `fetch-blockchain-roast` **HTTPay Roast API** — Returns a blockchain-themed roast message with a savagery score, advice, and metadata for a single GET request. *Use when:* Use when an agent or user wants a humorous blockchain-themed roast, such as for entertainment, demos, or testing x402 micropayment flows. *Not for:* Do not use for serious financial advice, real trading analysis, or any context requiring factual or actionable market data. **Returns:** Returns a JSON object with a roast string, savagery score out of 100, a short advice string, and a meta object with poweredBy and x402 fields. **Example:** `GET https://httpay.xyz/api/roast` --- ### `fetch-tech-news-headlines` **Tech News Headlines API** — Returns up to 20 recent news headlines for a selected topic, each with title, URL, publication date, source, snippet, and categories. *Use when:* Use when an agent needs current news headlines for a specific topic such as tech, AI, world, science, business, crypto, health, or sports to summarize, display, or analyze recent events. *Not for:* Do not use for full article content retrieval — only headlines and snippets are returned. Not suitable for historical news archives or real-time streaming feeds. **Inputs:** - `topic` (string) — Topic filter for headlines. Supported values: tech, ai, world, science, business, crypto, health, sports. Defaults to tech. **Returns:** Returns a JSON object with the queried topic, list of available topics, count of headlines, and an array of up to 20 headline objects each containing title, URL, pubDate, source, snippet, and categories. **Example:** `GET https://httpay.xyz/api/news?topic=ai` --- ### `fetch-base-dex-volume` **DEX Volume Tracker** — Returns real-time DEX volume rankings, market share, and 24h growth rates for decentralized exchanges on the Base chain, sourced from DeFiLlama. *Use when:* Use when an agent needs current Base chain DEX activity data including total volume, dominant DEX, fastest-growing protocol, per-DEX market share, and 24h change percentages. *Not for:* Do not use for non-Base chain DEX data or for historical volume beyond 24h; use a dedicated multi-chain or historical DeFiLlama endpoint instead. **Inputs:** - `chain` (string) — Chain to filter DEX volume data. Currently supports 'base'. - `period` (string) — Time period for volume data. Currently supports '24h'. - `demo` (boolean) — If true, returns demo/cached data without consuming a paid request. **Returns:** Returns a summary object with total Base DEX volume, dominant DEX, fastest-growing DEX, and an array of up to 15 ranked DEXes with volume, market share, 24h change, and DeFiLlama links. **Example:** `GET https://httpay.xyz/api/dex-volume-tracker?chain=base&period=24h` --- ### `fetch-crypto-news-headlines` **CryptoPulse News** — Returns the latest 20 aggregated crypto news headlines from multiple RSS feeds, each with title, link, publication date, source, and a short snippet. *Use when:* Use when an agent needs a current snapshot of crypto news headlines to summarize market events, monitor breaking stories, or surface relevant articles about Bitcoin, DeFi, NFTs, or crypto regulation. *Not for:* Do not use for real-time price data or token quotes; use a market data API instead. Not suitable for historical news archives — this returns only the latest batch of headlines. **Returns:** Returns an object with updatedAt timestamp, count of 20, and a headlines array where each item has title, link, pubDate, source, and a text snippet from the article. **Example:** `GET https://httpay.xyz/api/news/crypto` --- ### `fetch-pickup-line` **Pickup Line Generator** — Returns a single creative pickup line with a rizz score and metadata, themed around a given context such as crypto or web3. *Use when:* Use when an agent or user needs a ready-to-use pickup line or icebreaker, particularly for social apps, flirting features, or conversational humor in a specific thematic context. *Not for:* Do not use for generating general conversational openers unrelated to flirting or icebreakers; use a general text generation API instead. Not suitable for bulk or batch line generation. **Returns:** Returns a JSON object with a pickup line string, a rizz_score out of 100, and a meta object containing attribution and x402 flag. **Example:** `GET https://httpay.xyz/api/pickup-line` --- ### `fetch-market-mood` **MarketMood Pulse** — Returns a crypto market sentiment snapshot including a fear/greed index score, mood label, and signal breakdown (social sentiment, volume trend, volatility, BTC dominance, funding rates). *Use when:* Use when an agent needs a quick read on current crypto market sentiment — fear/greed index, mood classification, and supporting signals — to inform trading context or user-facing market summaries. *Not for:* Do not use for real-time live market data; the response is explicitly labeled simulated sentiment analysis and is not financial advice. Do not use for equity or forex market sentiment. **Returns:** Returns a JSON object with date, fearGreedIndex (0–100), mood label, a signals object with five sub-indicators, a narrative summary, and a disclaimer noting the data is simulated. **Example:** `GET https://httpay.xyz/api/market-mood` --- ### `fetch-fortune-message` **FortunePulse Fortune Message** — Returns a short crypto-themed fortune message, a lucky number, and a lucky token from the FortunePulse API. *Use when:* Use when an agent or chatbot needs a short randomized fortune or prediction to display to a user, such as in a widget, social app, or conversational interface. *Not for:* Do not use for real financial advice, price predictions, or any data-driven market analysis; this returns novelty fortune content only. **Returns:** Returns a JSON object with a short fortune string, a lucky number integer, a lucky token symbol, and a meta object with attribution and x402 flag. **Example:** `GET https://httpay.xyz/api/fortune` --- ### `fetch-gas-oracle-prices` **GasPulse Oracle** — Returns current gas price estimates (low, medium, high) for Ethereum, Base, Arbitrum, Optimism, Polygon, and Solana, plus a transaction timing recommendation. *Use when:* Use when an agent needs to check current gas prices across multiple chains before submitting a transaction, estimating fees, or deciding whether network conditions are favorable for transacting. *Not for:* Do not use for historical gas price data or gas price streaming; this is a single-shot snapshot. Not suitable for chains outside the six supported (Ethereum, Base, Arbitrum, Optimism, Polygon, Solana). **Returns:** Returns a timestamped JSON object with low/medium/high gas prices in gwei (or SOL for Solana) for six chains and a plain-text transaction timing recommendation. **Example:** `GET https://httpay.xyz/api/gas-oracle` --- ### `fetch-dex-volume-base` **DEX Volume Insights (Base Chain)** — Returns aggregated 24h and 7d trading volume metrics for all active DEXes on Base, including per-DEX breakdown, market share, trend direction, and top pairs by volume. *Use when:* Use when an agent needs current DEX trading volume data on Base chain, such as comparing DEX market share, identifying volume trends, finding top trading pairs, or assessing overall DeFi activity on Base. *Not for:* Do not use for volume data on chains other than Base (e.g., Ethereum mainnet, Solana, Arbitrum); use a multi-chain DEX volume API instead. Not suitable for real-time streaming price feeds or order book data. **Returns:** Returns a JSON object with Base chain DEX summary (total 24h/7d volume, top DEX, trend), a dexBreakdown array with per-DEX volume and market share for up to 20 DEXes, and a topPairsByVolume array with pair-level volume, price, liquidity, and transaction count. **Example:** `GET https://httpay.xyz/api/dex-volume` --- ### `fetch-stablecoin-peg-status` **Stablecoin Sentinel** — Returns live peg status, 24h supply flows, depeg alerts, and market data for USDC, USDT, DAI, EURC, and USDbC on Base, sourced from CoinGecko and DeFiLlama. *Use when:* Use when an agent needs to check whether major stablecoins on Base are holding their peg, detect depeg events, or retrieve 24h supply flow direction and market cap data for DeFi risk assessment or monitoring workflows. *Not for:* Do not use for stablecoin data on chains other than Base; this endpoint is scoped to Base only. Not suitable for historical peg data or streaming real-time price feeds. **Returns:** Returns a JSON object with a monitoredAt timestamp, chain scope (Base), depeg threshold, an aggregate summary of peg health across 5 stablecoins, and a stablecoins array with per-token price, supply, flow, and peg status details. **Example:** `GET https://httpay.xyz/api/stablecoin-monitor` --- ### `scan-mev-activity` **MEV Sentinel** — Scans recent blocks on a specified chain for MEV activity including sandwich attacks and arbitrage transactions, returning counts, estimated profit, flagged blocks, and top MEV bots. *Use when:* Use when an agent needs to detect or quantify MEV activity (sandwich attacks, arbitrage) in recent on-chain blocks, or when assessing whether users are being front-run on a given chain. *Not for:* Do not use for real-time mempool monitoring or pre-confirmation MEV detection; this analyzes already-confirmed blocks only. **Inputs:** - `chain` (string) — The blockchain to scan for MEV activity. Defaults to base. - `blocks` (integer) — Number of recent blocks to analyze for MEV patterns. - `demo` (boolean) — Set to true to return a pre-computed sample response without hitting the RPC. **Returns:** Returns MEV scan results for the specified chain and block range, including sandwich attack and arbitrage counts, estimated MEV profit in USD, flagged blocks, top MEV bots, and average swaps per block. **Example:** `GET https://httpay.xyz/api/mev-scanner?chain=base&blocks=10` ---