--- name: alpha.palmvox.com description: PalmVox (alpha.palmvox.com) provides a set of crypto market data and analytics endpoints covering global market overviews, token prices, whale activity, trading signals, sentiment indices, and paper-trading performance. All endpoints return current-state snapshots; none support historical time-series queries or real-time streaming. Payments are processed in USDC on Base via the x402 protocol. host: alpha.palmvox.com --- # alpha.palmvox.com PalmVox is a crypto analytics API host targeting agents that need pre-aggregated market intelligence without building multi-source data pipelines. It serves trading bots, research agents, and portfolio monitors that require sentiment context, whale behavior signals, and actionable trade setups in a single call per data type. It is distinct in bundling a paper-trading track record alongside market signals, allowing agents to evaluate signal quality before acting. ## When to use this host Use PalmVox when an agent needs pre-aggregated, current-state crypto market data across sentiment, macro overview, whale behavior, and trading signals without assembling a multi-source pipeline. It is well-suited for daily briefing agents, signal-following bots, and paper-trading evaluators. Do not use PalmVox for: historical price series or OHLCV data (use a dedicated OHLCV provider instead); real-time streaming or intraday tick data (PalmVox endpoints are single-shot snapshots); chains other than Base for chain-specific screening; or live on-chain trade execution (the trade history endpoint reflects paper-trading simulation only). If deeper alpha analysis is needed, the skills themselves reference a /api/premium/alpha endpoint not yet exposed as a skill on this host. ## Capabilities ### Market Sentiment & Context Provides macro-level sentiment readings and a daily digest that combine fear/greed scoring, news context, and top-mover summaries into ready-to-consume snapshots. - **`fetch-fear-greed-index`** — Returns the current crypto market fear and greed index as a numeric score, sentiment label, bias, and last-updated timestamp. - **`fetch-daily-crypto-digest`** — Returns a daily crypto market digest including Fear & Greed sentiment, notable price movements, news context, trader win-rate stats, and links to related endpoints. ### Global & Token-Level Pricing Delivers the current state of the overall crypto market (market cap, dominance, volume) and spot prices with 24h change for individual tokens. - **`fetch-global-crypto-market-overview`** — Returns a real-time snapshot of the global cryptocurrency market including total market cap, 24h volume, BTC/ETH dominance, active cryptocurrency count, and 24h market cap change. - **`fetch-crypto-prices`** — Returns current token prices with 24-hour change, a last-updated timestamp, and links to related crypto analytics endpoints, paid via USDC on Base. ### Chain-Specific Token Screening Identifies the worst-performing tokens on the Base chain by 24-hour price change, including volume and pair address, for screening or contrarian research. - **`fetch-base-losers`** — Returns the current biggest losing tokens on the Base chain with price, 24h change, volume, and pair address sourced from DexScreener. ### Whale & Signal Intelligence Surfaces on-chain whale accumulation/distribution behavior and actionable trading signals (entry, target, stop-loss, risk/reward) for tracked tokens, enabling informed trade setup decisions. - **`fetch-whale-activity`** — Returns current on-chain whale activity per token, including price, 24h change, accumulation direction, market impact, confidence level, overall market bias, and last update timestamp. - **`fetch-crypto-market-signals`** — Returns real-time crypto market signal alerts including entry price, target price, stop-loss, risk/reward ratio, confidence level, and 24h volume change for tracked tokens. ### Paper-Trading Performance Returns a PalmVox account's paper-trading history and summary metrics (win rate, cumulative PnL, trade count) to evaluate simulated strategy performance. - **`fetch-trade-history`** — Returns a user's paper-trading history with per-trade type, token, amount, price, PnL, and summary metrics including total trades, win rate, and cumulative PnL. ## Workflows ### Pre-Trade Market Context Check *Use when an agent needs to assess overall market conditions and sentiment before evaluating a specific trading signal.* 1. **`fetch-fear-greed-index`** — Retrieve the current sentiment score and bias to establish whether market conditions are risk-on or risk-off. 2. **`fetch-global-crypto-market-overview`** — Confirm macro market direction via total market cap change, BTC dominance, and 24h volume before proceeding. 3. **`fetch-crypto-market-signals`** — Pull actionable signals and filter by confidence level, now contextualized against the sentiment and macro backdrop. ### Whale-Confirmed Signal Validation *Use when an agent needs to cross-reference a trading signal against whale accumulation behavior before committing to a paper or live trade decision.* 1. **`fetch-crypto-market-signals`** — Retrieve current signals including entry price, target, stop-loss, and confidence level for tracked tokens. 2. **`fetch-whale-activity`** — Check whether whale direction (accumulation vs. distribution) aligns with the signal direction for the same tokens, increasing or decreasing conviction. ### Daily Briefing with Sentiment Depth *Use when an agent needs a full morning market briefing that combines the digest summary with a precise sentiment reading.* 1. **`fetch-daily-crypto-digest`** — Fetch the daily digest covering top movers, news context, and trader win-rate stats. 2. **`fetch-fear-greed-index`** — Supplement the digest's sentiment mention with the exact numeric index score and bias label for precision reporting. ### Base Chain Loser Screening with Price Confirmation *Use when an agent needs to identify Base chain underperformers and then verify their current spot prices before flagging them for further analysis.* 1. **`fetch-base-losers`** — Retrieve the current biggest losing tokens on Base with 24h change and volume. 2. **`fetch-crypto-prices`** — Confirm current spot prices for the identified losers to cross-validate DexScreener data against PalmVox's price feed. ## Skill reference ### `fetch-daily-crypto-digest` **PalmVox Daily Crypto Digest** — Returns a daily crypto market digest including Fear & Greed sentiment, notable price movements, news context, trader win-rate stats, and links to related endpoints. *Use when:* Use when an agent needs a concise daily summary of crypto market sentiment, top movers, and news context without constructing a multi-source data pipeline. *Not for:* Do not use for real-time price feeds or intraday updates; this is a once-daily digest snapshot. For deeper analysis use /api/premium/alpha instead. **Returns:** Returns a markdown digest string, an ISO date, an array of related endpoint links with prices, and a track-record URL; costs $0.02 USDC on Base (eip155:8453). **Example:** `GET https://alpha.palmvox.com/api/daily/digest` --- ### `fetch-base-losers` **Base Losers Feed** — Returns the current biggest losing tokens on the Base chain with price, 24h change, volume, and pair address sourced from DexScreener. *Use when:* Use when an agent needs to identify the worst-performing tokens on the Base chain by 24-hour price change, including their current price, trading volume, and pair address. *Not for:* Do not use for top gainers or general market overviews; use the /api/base/overview or /api/premium/alpha endpoints instead. Not suitable for chains other than Base. **Returns:** Returns a losers array of Base-chain tokens with price, 24h change, volume, and pair address, plus a count, chain, source, related API links, and a track record URL. **Example:** `GET https://alpha.palmvox.com/api/base/losers` --- ### `fetch-whale-activity` **PalmVox Whale Activity** — Returns current on-chain whale activity per token, including price, 24h change, accumulation direction, market impact, confidence level, overall market bias, and last update timestamp. *Use when:* Use when an agent needs a snapshot of whale accumulation or distribution behavior for tracked tokens, along with an overall market bias signal, to inform trading or research decisions. *Not for:* Do not use for historical whale activity data or streaming price feeds; this is a single-shot current-state snapshot only. **Returns:** Returns an array of whale activity records per token (direction, impact, confidence), a count, an overall marketBias string, a lastUpdated timestamp, related premium endpoint links, and a free track-record URL. **Example:** `GET https://alpha.palmvox.com/api/whale/activity` --- ### `fetch-trade-history` **PalmVox Trade History** — Returns a user's paper-trading history with per-trade type, token, amount, price, PnL, and summary metrics including total trades, win rate, and cumulative PnL. *Use when:* Use when an agent needs to retrieve recent paper-trading activity and performance metrics such as win rate, cumulative PnL, closed trade count, and individual trade details for a PalmVox account. *Not for:* Do not use for live on-chain trade execution or real asset settlement; this endpoint reflects paper-trading simulation data only. **Returns:** Returns a trades array of up to 20 recent paper trades with per-trade PnL and reason, plus summary fields: totalTrades=68, closedTrades=33, tradingPnl=-2.2453, wins=1, losses=32, winRate=3, and related endpoint links. **Example:** `GET https://alpha.palmvox.com/api/trades/history` --- ### `fetch-global-crypto-market-overview` **PalmVox Global Crypto Market Overview** — Returns a real-time snapshot of the global cryptocurrency market including total market cap, 24h volume, BTC/ETH dominance, active cryptocurrency count, and 24h market cap change. *Use when:* Use when an agent needs a current high-level summary of the global crypto market, such as total market cap, BTC or ETH dominance percentages, 24h trading volume, or overall market direction before making trading or research decisions. *Not for:* Do not use for individual token prices, specific pair data, or historical market data; use a token price or OHLCV endpoint instead. **Returns:** Returns a JSON object with totalMarketCap, totalVolume24h, btcDominance, ethDominance, activeCryptos, marketCapChange24h, a list of related endpoints, and a link to the free track record page. **Example:** `GET https://alpha.palmvox.com/api/market/global` --- ### `fetch-crypto-market-signals` **PalmVox Market Signals** — Returns real-time crypto market signal alerts including entry price, target price, stop-loss, risk/reward ratio, confidence level, and 24h volume change for tracked tokens. *Use when:* Use when an agent needs actionable crypto trading signals with entry, target, and stop-loss levels for a token, or when evaluating market momentum before making a trade decision. *Not for:* Do not use for historical backtesting or portfolio management; use the /api/track-record endpoint (free) for historical signal performance, or /api/report/daily for AI-generated daily reports. **Returns:** Returns an array of signal objects (token, chain, entry/target/stop-loss prices, confidence, risk/reward, volume change), a count, a lastUpdated timestamp, and links to related endpoints. **Example:** `GET https://alpha.palmvox.com/api/signals` --- ### `fetch-crypto-prices` **PalmVox Crypto Prices** — Returns current token prices with 24-hour change, a last-updated timestamp, and links to related crypto analytics endpoints, paid via USDC on Base. *Use when:* Use when an agent needs a current spot price and 24-hour percentage change for one or more crypto tokens, and can pay ~$0.001 USDC per request via the x402 paywall on Base. *Not for:* Do not use for historical price series or streaming price feeds; this is a single-shot snapshot. Do not use for tokens not covered by the endpoint — check alsoAvailable links for other analytics. **Returns:** Returns a prices array with token symbol, USD price, and 24h change; a count; a lastUpdated ISO timestamp; an alsoAvailable array of related paid endpoints; and a trackRecord URL. **Example:** `GET https://alpha.palmvox.com/api/crypto/prices` --- ### `fetch-fear-greed-index` **PalmVox Fear & Greed Index** — Returns the current crypto market fear and greed index as a numeric score, sentiment label, bias, and last-updated timestamp. *Use when:* Use when an agent needs the current market sentiment reading — numeric index, sentiment label, and bias — to inform trading decisions, risk assessments, or market commentary. *Not for:* Do not use for historical fear/greed time-series data or asset-specific sentiment; this returns only the current single snapshot. **Returns:** Returns a JSON object with a numeric index (50), sentiment label (neutral), bias (neutral), an optional headline string, and a last-updated ISO timestamp. **Example:** `GET https://alpha.palmvox.com/api/fear-greed` ---