Pillar over x402
Pillar endpoint catalog
Pillar data is served here over x402 payment rails. This page is the browser-readable contract; agents and registries should use the stable JSON document.
Machine JSON: /catalog.json. Coverage: /coverage. Health: /health. Prices are USDC per successful paid call.
13Total endpoints
6Paid endpoints
7Free surfaces
eip155:8453Settlement network
| Endpoint | Price | Contract |
|---|---|---|
POST /data | 0.20 USDC | Curated crypto market snapshot - core Pillar fields, no LLM. Nulls propagate honestly when an upstream API is unavailable - no fabricated zeros; check field_ages and coverage for per-field staleness and unsupported fields. Returns: price_usd, change_pct_24h, volume_24h_usd_primary_venue, market_cap_usd, funding_rate, open_interest_usd, cvd_1h, buy_ratio, whale_bar_count_1h, liquidation_buy_1h, liquidation_sell_1h, cvd_divergence, spot_perp_delta, volume_herfindahl, fear_greed, fear_greed_label. Does not include directional signals or macro regime - use /analyze/market or /analyze/full for that. Coverage is explicit: ZEC is unsupported for snapshot endpoints; slow/sentiment fields are supported only for the declared slow-sentiment universe. Data freshness: Pillar snapshots refresh every 5 minutes. Server cache TTL: 1 hour (override with max_age_seconds). |
POST /data/light | 0.05 USDC | Structured any-token coverage. Replaces 3-4 API calls + signal math in one round trip. Returns ~50 fields: current (price, market cap, volume, supply), momentum (1h/24h/7d/14d/30d/1y), extremes (ATH/ATL + drawdown), ranking, project info, exchange listings, community data, and 8 derived signals (momentum_tier, volume_state, volatility_grade, drawdown_phase, liquidity_tier, rank_tier, risk_flags, agent_priority). Data sourced from CoinGecko. MCP adds LLM brief; REST is data-only. |
POST /analyze/market | 0.25 USDC | Pre-trade macro intelligence. Data-only, no LLM. Returns: price_usd, price_change_24h, pulse_signal (up/down), signal_confidence (0.0-1.0), pillar_coverage (which of 4 Pulse pillars contributed to the composite — price/onchain/sentiment/orderflow — plus data_quality 0-1 and degraded bool; added 2026-04-18), macro_regime (bull/bear/risk_on/risk_off/choppy), macro_context (dxy, vix, treasury_10y, fear_greed_score, fear_greed_label), is_carry_forward (bool; TRUE when macro snapshot carried forward from prior trading day — discount regime claims accordingly; added 2026-04-18). Pillar scores (price_score, onchain_score, sentiment_score, orderflow_score, composite_score) are INVERTED percentile rankings: 0.0 = strongly bullish, 1.0 = strongly bearish. A score of 0.2 = metric at 80th percentile (bearish extreme). Add context='7d' for percentile rankings vs the last 7 days for all key fields. 17 tokens: BTC ETH SOL XRP ADA DOGE AVAX LINK BNB ATOM DOT ARB SUI OP LTC AMP ZEC (ZEC unsupported on snapshot-backed endpoints). |
POST /analyze/orderflow | 0.50 USDC | Cross-exchange orderflow verification across 20 exchanges. Data-only, no LLM. Returns: cvd_direction, cvd_value_usd (USD-notional cumulative delta), buy_ratio, whale_bar_count_1h (count of 5-min bars with institutional-sized orders, 0-12), liquidation_buy_1h, liquidation_sell_1h, cvd_divergence (spot CVD vs perp CVD — positive = spot leading, signals imminent move), spot_perp_delta (positive = spot buying ahead of perp), volume_herfindahl HHI (above 0.6 = manipulation risk), exchange_breakdown (exchanges_accumulating, exchanges_distributing, exchanges_total, dominant_direction, diverging_exchanges[]). Add context='7d' for historical percentile rankings. 26 tokens: BTC ETH SOL XRP ADA DOGE AVAX LINK BNB ATOM DOT NEAR ARB SUI OP LTC TRX BCH SHIB HBAR TON XLM UNI AAVE AMP ZEC. Data freshness: orderflow aggregated every 5 minutes from live exchange feeds. |
POST /analyze/full | 0.75 USDC | Complete pre-trade due diligence in one payment. All data from /analyze/market and /analyze/orderflow plus a single grounded LLM call with everything in context simultaneously. Returns all market and orderflow fields plus: stance (BULLISH/BEARISH/NEUTRAL), orderflow_signal (ACCUMULATION/DISTRIBUTION/NEUTRAL), risk_level (LOW/MODERATE/HIGH/CRITICAL), warnings[] (string array), verdict (one sentence in plain English citing specific values, designed for direct relay to a non-technical user), synthesis_model, pillar_coverage (pillars_available, data_quality, degraded — added 2026-04-18), is_carry_forward (bool; TRUE when macro snapshot carried forward from prior trading day — added 2026-04-18). Pillar scores (price_score, onchain_score, sentiment_score, orderflow_score, composite_score) are INVERTED percentile rankings: 0.0 = strongly bullish, 1.0 = strongly bearish. A score of 0.2 = metric at 80th percentile (bearish extreme). Replaces 3 separate API calls + LLM step. 17 tokens: BTC ETH SOL XRP ADA DOGE AVAX LINK BNB ATOM DOT ARB SUI OP LTC AMP ZEC (ZEC unsupported on snapshot-backed endpoints). Data freshness: same as /analyze/market and /analyze/orderflow — Pillar snapshots every 5 min, orderflow every 5 min. |
POST /analyze/address | 0.25 USDC | On-chain address risk profile. Auto-detects EVM Ethereum (0x...) or Solana (base58). Data-only, no LLM. Returns: address_type (wallet/contract), entity_label if known (e.g. 'Vitalik Buterin', 'Binance 14'), is_contract, is_verified, account_age_days, last_active_days_ago, tx_count, native_balance, top_tokens (top 5 holdings: symbol/balance/value_usd), risk_level (low/medium/high/unknown), flags[]. Risk flags: new_account, low_activity, unverified_contract, dormant, high_throughput. EVM via Blockscout. Solana via Helius. |
GET /health | free | Service status + data freshness per source. Check this first to verify the service is alive. |
GET /catalog | free | This endpoint. Machine-readable listing with prices, schemas, and example responses. |
GET /llms.txt | free | Agent-readable service description with use-case triggers. |
GET /demo | free | Free cached example responses for all 6 paid endpoints. Shows exact output schema with realistic field values. Use to validate response format and write integration code before paying. No payment required. |
GET /data/coverage | free | JSON coverage matrix. Per-token, per-timeframe historical depth + exchange count + live status. Cached 1h. Use to discover what data is available before calling paid endpoints. |
GET /coverage | free | Human-readable coverage grid rendered as an HTML table. Same data as /data/coverage. |
GET /.well-known/agent-card.json | free | A2A agent discovery card (Google Agent-to-Agent protocol). |